Referencia de comandos de archivos

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