---
id: "arquivos-referencia-cli"
titulo: "Referencia de comandos de archivos"
resumo: "Los comandos de línea de comandos que abren archivos, abren diffs y abren todos los archivos cambiados de un workspace."
idioma: "es"
tipo: "referencia"
categoria: "arquivos-git"
aplicavelDesde: "0.0.16"
capabilities: ["file.open", "file.diff", "file.open-changed"]
estadoEditorial: "aprovado"
nivelEvidencia: "artefato-distribuido"
refFonte: "27574c339b58316408f6be2d62169d59041d07bf"
revisaoFonte: "2026-09-24"
revisor: "mantenedor (v1, 2026-10-03)"
rota: "/docs/es/ferramentas/arquivos/referencia-cli/"
fonte: "pt-br/ferramentas/arquivos/referencia-cli.md"
caminhoPublico: "docs/publica/es/ferramentas/arquivos/referencia-cli.md"
hashFonte: "sha256:d69a6c55544ba21c3c50a12c7b453f0c2e7cbe920e2b548408da15f6f6644452"
hashDestaPagina: "sha256:66e2cf39e7f0a7347b8c5e6319d3f81d5a5dbb8d374c4f5e28c6bd579c64022e"
traducaoAssistidaPorIA: true
traducaoDesatualizada: false
corpoRetido: false
---
<!-- traducao-assistida-por-ia: idioma=ES fonte=pt-br/ferramentas/arquivos/referencia-cli.md fonteHash=sha256:d69a6c55544ba21c3c50a12c7b453f0c2e7cbe920e2b548408da15f6f6644452 estado=atual -->

Comandos, flags y valores son **literales** — no se traducen.

## Selectores y flags globales

- **`--workspace <selector>`** — elige el workspace. Acepta `id:<id>`, `name:<nombre>`, `path:<ruta>`, `active`/`current` y `focused`.
- **`--worktree`** es un alias de compatibilidad de `--workspace`.
- **`--json`** devuelve la salida estructurada.

## Abrir un archivo

```
elyra file open <ruta> [--workspace <selector>] [--json]
```

- La ruta es **relativa al worktree seleccionado**.
- **Sin `--workspace`, la llamada local infiere el worktree desde el directorio actual.** Las llamadas remotas exigen `--workspace`.
- Si no hay worktree resoluble y tampoco `--workspace`, la llamada **falla** en lugar de abrir.
- **Los archivos binarios no abren como texto**: la respuesta indica que no fueron abiertos y qué tipo fue reconocido.

Ejemplos:

```
elyra file open src/App.tsx
elyra file open --path docs/readme.md --workspace active
```

## Abrir el diff de un archivo

```
elyra file diff <ruta> [--staged] [--workspace <selector>] [--json]
```

- **El valor predeterminado es el diff de las diferencias no preparadas.** `--staged` abre el diff del índice.
- Exige la ruta y un worktree resoluble.
- **Un archivo binario no genera diff de texto**: la respuesta indica el tipo en lugar de comparar contenido.

Ejemplos:

```
elyra file diff src/App.tsx
elyra file diff --path package.json --staged --workspace name:feature
```

## Abrir todos los archivos cambiados

```
elyra file open-changed [--mode edit|diff|both] [--workspace <selector>] [--json]
```

- La fuente de los cambios, en esta versión, es el **estado de git** del worktree seleccionado.
- **El modo predeterminado es `diff`.** `--mode` acepta `edit`, `diff` o `both`; cualquier otro valor es error de argumento.
- **En el modo `edit`, los archivos borrados se omiten** — no hay objetivo de edición.
- **Los conflictos no resueltos se omiten**, tanto en `edit` como en `diff`.
- Sin archivos cambiados, la salida informa que no hay archivos cambiados.
- El resultado agrega **abiertos**, **omitidos** y **total cambiados**.

Ejemplos:

```
elyra file open-changed
elyra file open-changed --mode both
elyra file open-changed --mode diff --workspace active
```