Orca

Orca es un entorno para trabajar con varios agentes a la vez: cada tarea en su worktree de Git, con su agente, y en la misma ventana el diff de lo que ha hecho, un editor y un navegador. No trae modelo propio: ejecuta los agentes que ya usas (Claude Code, OpenCode, Codex…) con tu suscripción. Es gratis y de código abierto.

Hace lo mismo que herdr (varios agentes a la vista y aviso de cuál te necesita) y le suma lo que hace falta para revisar lo que hacen los agentes: comentar su diff línea a línea, ver la web que están haciendo y señalarles el elemento que está mal.

• Linux: el AppImage, que se actualiza solo.

wget https://github.com/stablyai/orca/releases/latest/download/orca-linux.AppImage
chmod +x orca-linux.AppImage
./orca-linux.AppImage

• macOS

brew install --cask stablyai/orca/orca

• Windows: orca-windows-setup.exe de la última versión.

Pide acceso a tu carpeta personal, para poder añadir repositorios, y ofrece importar la configuración de ~/.claude y ~/.codex. Di que sí a las dos cosas.

En la misma pantalla se elige el agente por defecto, el que se lanza al crear cada worktree.

Se actualiza solo. Con brew, brew upgrade –cask orca.

Orca organiza el trabajo en cuatro niveles:

Comparado con herdr: el worktree hace el papel del espacio de trabajo, y en Orca todo worktree es un worktree de Git. Trabajar sin rama propia es usar el worktree principal del repositorio.

Los ejemplos son dos proyectos: reservas-api (una API REST) y tienda-web (su web).

Se pulsa Add Repo en la barra lateral y se elige la carpeta del repositorio. Orca toma la rama por defecto (main) como base ref: de ahí salen los worktrees nuevos.

Se pulsa el + junto al nombre del repositorio y se rellena:

• Nombre: el de la tarea, que es también el de la rama. Aquí, login.
• Start from: de dónde sale la rama. Lo normal, origin/main.
• Agent: el agente que se lanza en el worktree.

Orca crea la rama y el worktree y abre el agente en su carpeta.

El worktree se renombra con doble clic sobre su nombre.

El worktree es una carpeta nueva con lo que hay en Git, así que no tiene ni el .env ni node_modules: el agente arranca, los tests fallan y no sabe por qué. Se arregla en el repositorio principal:

• .worktreeinclude: ficheros que se copian a cada worktree nuevo, uno por línea.

.env

• orca.yaml: carpetas que se comparten entre todos los worktrees, sin copiarlas.

worktree:
  sharedDirectories:
    - node_modules

Los dos solo valen para ficheros y carpetas que estén en el .gitignore.

Para ver dos pestañas a la vez se arrastra una pestaña al borde del panel: al borde derecho, se ponen una al lado de la otra; al de abajo, una encima de la otra. En una terminal también vale botón derecho sobre la pestaña → Split terminal right o Split terminal down.

Cada worktree guarda su distribución de paneles.

Botón derecho sobre el worktree → Delete.

En la barra lateral, cada worktree lleva el estado de su agente:

Los worktrees en negrita tienen algo que no has visto. Para ir a uno, clic en él, o Ctrl+J y escribir parte de su nombre.

Cuando un agente termina, Orca saca una notificación del sistema y suena. La campana de arriba guarda los avisos de todos los worktrees: clic en uno y estás en el panel de ese agente. Se ajustan en Settings → Notifications.

Los agentes corren en un proceso aparte, así que se puede cerrar la ventana cuando quieras: siguen trabajando y, al abrir Orca, todo está como lo dejaste, incluida la salida que han escrito mientras tanto. Si reinicias el ordenador vuelven los worktrees, las pestañas y los paneles, pero los agentes hay que lanzarlos otra vez.

La app de Orca para el móvil sirve para lo que más tiempo hace perder con los agentes: el agente te pregunta algo cuando no estás delante y se queda parado hasta que vuelves. Con la app te llega el aviso y le contestas desde el móvil. No es un editor: es un mando a distancia del Orca de tu ordenador.

1. En el móvil, con Chrome, abrir onorca.dev/download/android y bajar el APK.
2. Abrir app-release.apk desde las descargas.
3. Android pide permiso para instalar apps desconocidas: dárselo solo a Chrome y quitárselo después de instalar.

En iPhone está en la App Store como Orca IDE.

1. En el Orca del ordenador, abrir el emparejamiento desde el menú de la cuenta: sale un código de un solo uso, que caduca en unos minutos.
2. En la app, Pair y pegar el código.

La conexión va por el servidor de Orca (Relay), así que funciona fuera de casa. Hay que tener sesión iniciada en Orca con la misma cuenta en el móvil y en el ordenador.

• Ver los agentes: todos los worktrees con su estado, igual que en la barra lateral.
• Recibir el aviso: una notificación cuando un agente termina.
• Contestar al agente: un texto, una respuesta dictada o una foto, y aceptar los permisos que pide.
• Leer su terminal: lo último que ha escrito, para saber qué ha hecho antes de contestarle.

Es lo que Orca añade a herdr. Cada worktree tiene su diff: lo que ha cambiado el agente respecto a la rama de la que salió.

1. Sobre la línea, clic en el + del margen o, con el cursor en ella, la tecla c. Para varias líneas, se arrastra por encima.
2. Se escribe el comentario y Enter para guardarlo.
3. Cuando están todos, Send to agent, arriba en el diff, y se elige el agente.

Orca junta todos los comentarios en un único prompt, cada uno con su fichero y su línea, y el agente los corrige de una vez.

Los comentarios se quedan en su línea para comprobar el arreglo. Resolve cierra los que ya están bien; los que no cierres se vuelven a mandar la próxima vez.

En el panel Source Control del worktree:

• Commit: se escribe el mensaje, o Generate with AI lo redacta a partir de los cambios. Ctrl+Enter hace el commit.
• Push: sube la rama a origin.
• PR: tras el push, se abre la PR desde el mismo panel; Generate pull request details with AI rellena el título y la descripción.

Si falla un hook de pre-commit, Fix with AI le pasa la salida al agente para que lo arregle.

Los ficheros se abren en un editor como el de VS Code, con autoguardado, para retocar algo sin salir de Orca:

• Ctrl+P: abrir un fichero del worktree por su nombre.
• Los .md se ven ya formateados: es lo cómodo para leer el requirements.md o el design.md de una spec mientras el agente trabaja al lado.
• Arrastrar un fichero o una imagen al prompt del agente se lo pasa como contexto.

Cada worktree tiene su propio navegador, en una pestaña más, para ver la web que está haciendo su agente.

Con Design Mode se le señala al agente qué elemento hay que cambiar, en vez de describírselo:

1. En la barra del navegador, el botón de Design Mode.
2. Clic en el elemento que está mal.
3. Escribir qué hay que cambiar y mandarlo.

Al agente le llegan el HTML del elemento, sus estilos calculados, un recorte de pantalla y, si la web corre en modo desarrollo, el fichero y la línea de donde sale. Por ejemplo, en tienda-web, clic en el botón de Comprar que se sale de la tarjeta en móvil y «que no se salga de la tarjeta por debajo de 400px».

Se conecta en Settings → Integrations. A partir de ahí, en Orca:

• Worktree desde una issue: se crea el worktree desde la issue y Orca le pone su nombre y la deja enlazada.
• PR: sus comentarios y sus checks se ven en una pestaña.
• Fix broken checks: en la PR, le pasa al agente los checks que fallan para que los arregle.

Como cada worktree es independiente, se puede dar la misma tarea a varios agentes y quedarse con la mejor solución:

1. Tres worktrees desde origin/main: login, login-2 y login-3, cada uno con un agente distinto.
2. El mismo prompt en los tres, por ejemplo «implementa specs/login según su tasks.md».
3. Cuando terminan, revisar los tres diffs.
4. Seguir con el mejor y borrar los otros dos worktrees.

Con el skill de Orca, el agente puede crear worktrees, leer otras terminales y mandarles órdenes, igual que el skill de herdr. Primero se activa la orden orca en Settings → General → Orca CLI (en Linux se llama orca-ide, para no chocar con el lector de pantalla Orca de GNOME), y después se instala el skill:

npx skills add https://github.com/stablyai/orca --skill orca-cli -g

Desde el agente, dentro de Orca, se le pide por ejemplo:

• Lanzar los tests en otra terminal sin quitarte el foco:

en orca, abre una terminal en este worktree, lanza npm test y avísame cuando acabe

• Leer la salida de otro agente y actuar sobre ella:

lee en orca la terminal del worktree login y dime en qué tarea de tasks.md va

• Arrancar otro agente que revise el trabajo:

en orca, crea un worktree revisa-login desde esta rama con otro claude que revise specs/login/design.md contra requirements.md, espera a que termine y resúmeme lo que encuentre

Orca se maneja con el ratón; estos son los atajos que merece la pena saber. En macOS, Cmd en lugar de Ctrl. Se cambian en Settings → Shortcuts.

• onorca.dev: web oficial.
• Documentación: guía de todas las funciones, con recetas paso a paso.
• Referencia de la CLI: todas las órdenes de orca que usa el skill.
• Repositorio: código y versiones publicadas.