---
id: "arquivos-referencia-cli"
titulo: "Referência de comandos de arquivos"
resumo: "Os comandos de linha de comando que abrem arquivos, abrem diffs e abrem todos os arquivos alterados de um workspace."
idioma: "pt-br"
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/pt-br/ferramentas/arquivos/referencia-cli/"
fonte: "pt-br/ferramentas/arquivos/referencia-cli.md"
caminhoPublico: "docs/publica/pt-br/ferramentas/arquivos/referencia-cli.md"
hashFonte: "sha256:d69a6c55544ba21c3c50a12c7b453f0c2e7cbe920e2b548408da15f6f6644452"
hashDestaPagina: "sha256:d69a6c55544ba21c3c50a12c7b453f0c2e7cbe920e2b548408da15f6f6644452"
traducaoAssistidaPorIA: false
traducaoDesatualizada: false
corpoRetido: false
---
Comandos, flags e valores são **literais** — não são traduzidos.

## Seletores e flags globais

- **`--workspace <seletor>`** — escolhe o workspace. Aceita `id:<id>`, `name:<nome>`, `path:<caminho>`, `active`/`current` e `focused`.
- **`--worktree`** é alias de compatibilidade de `--workspace`.
- **`--json`** devolve a saída estruturada.

## Abrir um arquivo

```
elyra file open <caminho> [--workspace <seletor>] [--json]
```

- O caminho é **relativo ao worktree selecionado**.
- **Sem `--workspace`, a chamada local infere o worktree a partir do diretório atual.** Chamadas remotas exigem `--workspace`.
- Se não houver worktree resolvível e nem `--workspace`, a chamada **falha** em vez de abrir.
- **Arquivos binários não abrem como texto**: a resposta indica que não foram abertos e qual é o tipo reconhecido.

Exemplos:

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

## Abrir o diff de um arquivo

```
elyra file diff <caminho> [--staged] [--workspace <seletor>] [--json]
```

- **O padrão é o diff das diferenças não preparadas.** `--staged` abre o diff do índice.
- Exige o caminho e um worktree resolvível.
- **Arquivo binário não gera diff de texto**: a resposta indica o tipo em vez de comparar conteúdo.

Exemplos:

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

## Abrir todos os arquivos alterados

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

- A fonte das mudanças, nesta versão, é o **status do git** do worktree selecionado.
- **O modo padrão é `diff`.** `--mode` aceita `edit`, `diff` ou `both`; qualquer outro valor é erro de argumento.
- **No modo `edit`, arquivos apagados são pulados** — não há alvo de edição.
- **Conflitos não resolvidos são pulados**, tanto em `edit` quanto em `diff`.
- Sem arquivos alterados, a saída informa que não há arquivos alterados.
- O resultado agrega **abertos**, **pulados** e **total de alterados**.

Exemplos:

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