# Orca Cli

> Usa el CLI público `orca` para gestionar worktrees, contextos de carpeta, terminales, repos, automations, artifacts, comentarios de worktree y el navegador embebido de la app Orca.

Fuente: https://skillsagentes.com/skills/stablyai/orca/orca-cli
Markdown: https://skillsagentes.com/skills/stablyai/orca/orca-cli.md

Repositorio: https://github.com/stablyai/orca
Autor: stablyai
Licencia: MIT
Actualizado: el mes pasado
Coste de contexto: 196 tok instalada, 978 tok al activarse, 978 tok con todos los archivos del bundle
Bundle: 1 archivo, 4 KB
Permisos que pide: ninguno declarado

## Instalación

Un skill son archivos markdown: los mismos archivos valen para cualquier agente y lo único que cambia es el directorio de destino, es decir la bandera `--agent`. Añade `-g` para instalarlo en todos los proyectos de la máquina.

```bash
# Claude Code
npx -y skills add stablyai/orca --skill orca-cli --agent claude-code
# Cursor
npx -y skills add stablyai/orca --skill orca-cli --agent cursor
# Codex
npx -y skills add stablyai/orca --skill orca-cli --agent codex
# Gemini CLI
npx -y skills add stablyai/orca --skill orca-cli --agent gemini
# Windsurf
npx -y skills add stablyai/orca --skill orca-cli --agent windsurf
# Cline
npx -y skills add stablyai/orca --skill orca-cli --agent cline
```

## Qué hace

- Selecciona el ejecutable `orca` correcto para la sesión (ORCA_CLI_COMMAND, orca-dev, orca-ide u orca)
- Carga la guía completa y versionada con `ORCA skills get orca-cli` antes de ejecutar comandos
- Ofrece un fallback de solo lectura (`status`, `worktree ps`, `terminal list`) si el binario no reconoce `skills get`

## Cuándo usarla

- El usuario dice "$orca-cli", "use orca cli" o "Orca worktree"
- Se necesita crear/spawnear un child worktree o lanzar codex/claude en un worktree
- Hay que leer/esperar/enviar a una terminal de Orca o hacer un handoff/handover a otro agente
- Se necesita controlar el navegador embebido de la app Orca o compartir artifacts

## Cuándo no

- La tarea no toca estado gestionado por Orca (usar herramientas de shell simples)
- Se necesita controlar ventanas de navegador, webviews o UI de escritorio fuera del navegador embebido de Orca (usar Computer Use)

## Qué la activa

- "$orca-cli crea un child worktree para esta rama"
- "Envía este comando a la terminal de Orca y espera la salida"
- "Haz un handover completo de este worktree a otro agente"
- "Comparte este HTML como artifact público de Orca"
- "Controla el navegador embebido de Orca para abrir esta URL"

## Antes de instalar

- Requiere el binario `orca` instalado y en ejecución (verificable con `ORCA status --json`), resuelto según el entorno de la sesión.

## Archivos

- SKILL.md — 4 KB

## SKILL.md

Reproducido tal cual desde stablyai/orca bajo MIT. Esta sección es el documento original y está en inglés.

# Orca CLI

This discovery stub loads the version-matched guide from the Orca executable used for this session.

## Resolve the CLI for this session

Choose the executable once and reuse it for every later command:

- If the `ORCA_CLI_COMMAND` environment variable is set, use its value. Orca exports this
  for managed WSL sessions.
- Otherwise, in a dev checkout whose session exposes `ORCA_DEV_REPO_ROOT`, use `orca-dev`.
- Otherwise, on Linux outside an Orca-managed terminal, use `orca-ide`. Never run bare
  `orca` there — outside Orca's terminals it normally resolves to the
  GNOME Orca screen reader (`/usr/bin/orca`) and starts speech on the user's machine.
- Otherwise, use `orca`.

Below, `ORCA` is a placeholder for the executable you resolved. Substitute it before
running anything; do not create a shell variable or run `ORCA` literally. This works the
same way in POSIX shells, PowerShell, and cmd.exe.

If the selected executable cannot run, report its exact error and stop. Do not fall through
to another executable, which could silently target a different Orca build.

## Load the version-matched guide before running Orca commands

```text
ORCA skills get orca-cli
```

Prefer `--json`. Use the selected executable's `--help` for commands or flags the guide does
not cover. If a command reports that Orca is not running, start it with `ORCA open --json`
and retry. If it fails with `runtime_access_denied`, your sandbox blocked the connection:
re-run it with escalated permissions, and do not run `ORCA open` or restart Orca. If
`skills get` is unknown, explain that updating Orca restores the guide; use `--help` for
read-only discovery and do not guess unsupported commands.

## Dónde encaja

- Categoría: [Herramientas para desarrolladores](https://skillsagentes.com/categorias/herramientas-desarrollo.md) — Skills que cambian cómo tu agente escribe, revisa y despliega código.
- Creador: [stablyai](https://skillsagentes.com/creators/stablyai.md) — 8 skills en el directorio
- [Todas las skills](https://skillsagentes.com/skills.md)
- [Ranking de instalaciones](https://skillsagentes.com/ranking.md)

## Otras skills del mismo repositorio

- [Orchestration](https://skillsagentes.com/skills/stablyai/orca/orchestration.md): Usa la orquestación de Orca para coordinación multi-agente estructurada: mensajes en hilo, ask/reply bloqueante, dispatch de tareas, waits de worker_done/escalación, DAGs, gates de decisión y loops de coordinador.
- [Linear Tickets](https://skillsagentes.com/skills/stablyai/orca/linear-tickets.md): Alias antiguo (legacy) del paquete para orca-linear; usa la CLI Linear de Orca vía orca linear ... para leer contexto de tickets, publicar avances, mover estados, adjuntar links de PR/MR y triagear tareas.
- [Orca Linear](https://skillsagentes.com/skills/stablyai/orca/orca-linear.md): Usa la CLI de Linear de Orca (`orca linear ...`) para leer contexto de tickets, publicar avances, mover estados, adjuntar enlaces de PR/MR y triagear tareas de Linear vinculadas, sin tratar el texto del ticket como instrucciones.
- [Computer Use](https://skillsagentes.com/skills/stablyai/orca/computer-use.md): Usa la CLI computer-use de Orca para inspeccionar y operar ventanas de apps de escritorio mediante árboles de accesibilidad, capturas de pantalla y acciones seguras de UI como clic, escritura y scroll.
- [Orca Emulator](https://skillsagentes.com/skills/stablyai/orca/orca-emulator.md): Controla un emulador/simulador móvil (iOS) desde Orca con la CLI `orca`: taps, gestos, tipeo, botones, cámara, permisos y árbol de accesibilidad, viendo la vista en vivo en Orca.

## Skills relacionadas

- [Orca Emulator](https://skillsagentes.com/skills/stablyai/orca/orca-emulator.md): Controla un emulador/simulador móvil (iOS) desde Orca con la CLI `orca`: taps, gestos, tipeo, botones, cámara, permisos y árbol de accesibilidad, viendo la vista en vivo en Orca.
- [Orca Emulator Android](https://skillsagentes.com/skills/stablyai/orca/orca-emulator-android.md): Controla un emulador o dispositivo Android desde Orca con el CLI `orca`: AVDs, taps, swipes, tecleo, botones físicos, rotación, apps, permisos, árbol de accesibilidad y logcat.
- [Computer Use](https://skillsagentes.com/skills/stablyai/orca/computer-use.md): Usa la CLI computer-use de Orca para inspeccionar y operar ventanas de apps de escritorio mediante árboles de accesibilidad, capturas de pantalla y acciones seguras de UI como clic, escritura y scroll.
- [Linear Tickets](https://skillsagentes.com/skills/stablyai/orca/linear-tickets.md): Alias antiguo (legacy) del paquete para orca-linear; usa la CLI Linear de Orca vía orca linear ... para leer contexto de tickets, publicar avances, mover estados, adjuntar links de PR/MR y triagear tareas.
- [Orca Linear](https://skillsagentes.com/skills/stablyai/orca/orca-linear.md): Usa la CLI de Linear de Orca (`orca linear ...`) para leer contexto de tickets, publicar avances, mover estados, adjuntar enlaces de PR/MR y triagear tareas de Linear vinculadas, sin tratar el texto del ticket como instrucciones.

---

Skills Agentes · [Índice de páginas en markdown](https://skillsagentes.com/sitemap.md) · [Inicio](https://skillsagentes.com/index.md)