Referência de comandos de arquivos

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