Orca: varios agentes de código en paralelo con git worktrees

Orca es una aplicación de escritorio gratuita y de código abierto (licencia MIT) para trabajar con varios agentes de código a la vez, como Claude Code, Codex u OpenCode, cada uno en su propio git worktree. Así un agente arregla un error mientras otro construye una función nueva, sin pisarse los archivos ni bloquear tu rama. En este tutorial verás qué es un worktree, cómo instalar Orca, cómo lanzar tu primer agente y qué cuidar antes de fusionar su trabajo.

El problema: un agente ocupa tu rama

Un agente de código trabaja sobre los archivos de tu carpeta. Mientras modifica el proyecto, no puedes cambiar de rama sin interrumpirlo, y si lanzas un segundo agente en la misma carpeta, los dos editan los mismos archivos al mismo tiempo. El resultado es un historial mezclado y difícil de revisar.

La solución no es esperar a que termine uno para empezar el otro: es darle a cada agente su propia copia de trabajo.

Qué es un git worktree (sin Orca primero)

Un worktree es una carpeta adicional conectada al mismo repositorio, con su propia rama. Comparten el historial de Git, pero cada carpeta tiene sus archivos. Git lo trae de serie:

# Desde la carpeta de tu proyecto: crea ../mi-app-login con la rama nueva feature/login
git worktree add ../mi-app-login -b feature/login

# Lista los worktrees del repositorio y la rama de cada uno
git worktree list

# Cuando terminas: elimina la carpeta (debe estar limpia) y limpia referencias huérfanas
git worktree remove ../mi-app-login
git worktree prune

Una regla importante: Git no permite tener la misma rama abierta en dos worktrees. Si lo intentas, responde con un error parecido a fatal: 'feature/login' is already used by worktree at .... Es justo lo que queremos: una rama, un agente.

Puedes hacer todo esto a mano y abrir un agente en cada carpeta. Claude Code incluso tiene su propia opción (claude --worktree nombre, que crea el worktree dentro de .claude/worktrees/). Orca aporta otra cosa: ver y controlar todos los agentes, sus terminales y sus cambios en una sola ventana.

Instalar Orca

Orca funciona en macOS (Apple Silicon e Intel), Windows y Linux. Usa siempre los enlaces del repositorio oficial, stablyai/orca, o su sitio, onorca.dev: existen otros proyectos con el mismo nombre.

1. macOS

   Con Homebrew, escribe el nombre completo del paquete. El repositorio oficial lo advierte: orca a secas instala otra herramienta de Plotly que no tiene relación.

   brew install --cask stablyai/orca/orca

   También puedes descargar el .dmg desde la página de releases del repositorio.

2. Windows y Linux

   En Windows descarga el instalador orca-windows-setup.exe desde los releases de GitHub. En Linux hay AppImage, paquetes .deb y .rpm en la misma página, y un paquete en AUR para Arch.

3. Primer arranque

   Al abrirla, Orca pide acceso a tu carpeta personal, ofrece importar la configuración de Claude Code y Codex que ya tengas, y te pide agregar tu primer repositorio. Agrega la carpeta de un proyecto que ya uses con Git.

Orca no incluye los agentes: usa los que tengas instalados con tu propia suscripción. Antes de seguir, comprueba que tu agente funciona en una terminal normal (por ejemplo, claude --version).

Crear un worktree y lanzar un agente

1. Abre el compositor «New Workspace»

   Con el repositorio seleccionado, crea un nuevo workspace. En el compositor «New Workspace» eliges desde qué rama partir («Branch from»), le das un nombre a la tarea y, en el selector de agente, escoges el agente que se abrirá en la primera pestaña (o una terminal en blanco).

2. Revisa la rama

   Orca deriva el nombre de la rama del nombre del workspace, o del issue de GitHub o Linear que vincules. En la sección avanzada puedes escribirla tú, por ejemplo feature/login. Por debajo, Orca hace un git fetch y un git worktree add, igual que en la sección anterior. En nuestra prueba con Orca 1.4.240, las carpetas se crearon por defecto en ~/orca/workspaces; la ubicación se puede cambiar en la configuración.

3. Escribe la tarea

   El agente arranca dentro de su worktree. Dale una tarea concreta y verificable: «agrega validación de correo al formulario de registro y su prueba», no «mejora el login».

4. Repite para la siguiente tarea

   Crea otro worktree con otra rama y otro agente. Cada uno trabaja en su carpeta, y Orca te avisa cuando un agente termina o necesita una respuesta.

Si prefieres la terminal, Orca trae una CLI que se activa desde la configuración. Por ejemplo, orca worktree create --repo name:mi-app --name login --agent claude crea el worktree y lanza el agente, y orca worktree list muestra los que tienes (opciones según orca worktree create --help en la versión 1.4.240).

Archivos que Git no versiona

Un worktree nuevo no trae lo que Git ignora: el .env o la carpeta node_modules. Orca resuelve esto con dos piezas documentadas: un archivo .worktreeinclude en la raíz del repositorio con las rutas a copiar (solo rutas literales, sin comodines) y un orca.yaml con un script de preparación (scripts.setup), por ejemplo para instalar dependencias.

Comparar resultados y fusionar

Orca muestra los cambios de cada worktree como un diff, y puedes comentar líneas concretas para devolvérselas al agente. Cuando el resultado te convence, el flujo es el de siempre en Git: commit, push y pull request, revisado por una persona antes de fusionar.

Si lanzaste dos agentes con la misma tarea para comparar enfoques, quédate con el mejor y elimina el otro worktree desde el menú contextual. Al borrar un worktree, Orca elimina la carpeta y la rama, previa confirmación.

Buenas prácticas

• Una tarea por worktree, una rama por tarea. Ramas cortas con nombres claros se revisan mejor.
• Revisión humana siempre. El agente propone; una persona lee el diff, corre las pruebas y decide qué se fusiona.
• Revisa los permisos del agente. Según su documentación, Orca lanza por defecto los agentes con la opción que omite las confirmaciones (--dangerously-skip-permissions en Claude Code). Si prefieres aprobar cada acción, cambia a modo manual en Settings → Agents → Agent Permissions.
• Nada de secretos en el prompt. No pegues contraseñas ni claves de producción en la conversación. Usa variables de entorno de desarrollo y credenciales con el mínimo permiso.
• Pocas tareas a la vez. Dos o tres agentes en paralelo ya multiplican lo que tienes que revisar. Revisar es el cuello de botella, no escribir código.
• Limpia al terminar. Elimina los worktrees ya fusionados para no acumular carpetas y ramas viejas.

Los agentes de código cambian rápido, y también la forma de trabajar con ellos. Si quieres llevar esta forma de trabajo a tu equipo, o construir agentes de IA que trabajen con los sistemas de tu empresa, conoce nuestro servicio de inteligencia artificial. Y si quieres darle a tu agente acceso a otras herramientas, aquí explicamos cómo conectar un servidor MCP a Claude Code.