Orca: el Agent Development Environment para correr 30+ agentes IA en paralelo (tutorial de instalación y uso completo)

¿Qué es Orca?

Orca es un Agent Development Environment (ADE) open source (MIT, 41.600+ stars en GitHub) creado por Stably AI en marzo de 2026. Es una desktop app que te permite correr 30+ agentes CLI en paralelo — Claude Code, Codex, Cursor, OpenCode, Grok, GitHub Copilot, Kimi, Devin, Goose y más — cada uno en su propio git worktree aislado, todo trackeado desde un solo lugar.

Orca no reemplaza a los agentes ni bundlea sus modelos. Tu traes tus propias suscripciones, cuentas y CLIs instalados. Orca provee el entorno: worktrees aislados, terminales persistentes, diffs, revisiones, integraciones con GitHub y Linear, y un mobile companion para monitorar desde tu teléfono.

La regla de compatibilidad es simple: si corre en una terminal, corre en Orca.

Por qué Orca y no terminales sueltas

• Paralelismo real: fan un prompt across 5 agentes, cada uno en su worktree aislado, compara resultados y mergea el ganador
• Merge worktree visual: 3-pane diff con checkboxes por hunk — cherry-pick visual sin git cherry-pick manual
• Mobile companion: notificaciones push cuando un agente termina, send follow-ups desde tu teléfono
• SSH worktrees: corre agentes en un VPS o GPU box remoto con auto-reconnect y port forwarding
• Design Mode: click cualquier UI element en Chromium embebido → HTML + CSS + screenshot van directo al prompt del agente
• GitHub y Linear nativo: browse PRs, issues y project boards in-app, abre worktree desde cualquier task
• Account switcher: trackea usage y rate-limit resets de Claude y Codex, hot-swap accounts sin re-login
• Orca CLI: agentes pueden drivear Orca — orca worktree create, snapshot, click, fill
• Bring your own subscription: Orca es gratis; pagas solo por los agentes subyacentes que ya usas

30+ agentes soportados

Orca funciona con cualquier CLI agent. Si corre en una terminal, corre en Orca:

Categoría	Agentes
Major coding agents	Claude Code, Codex, Cursor CLI, GitHub Copilot CLI, OpenCode, Amp
Frontier model CLIs	Grok, Kimi, Qwen Code, Mistral Vibe
Autonomous agents	Devin, Pi, oh-my-pi, Hermes Agent (Nous Research)
Open-source agents	Goose (Block), Cline, Continue, Charm, Auggie (Augment), Kilocode, Codebuff
Specialized	Droid (Factory), Antigravity (Google), Rovo Dev (Atlassian), MiMo Code, OpenClaude, Autohand Code, Command Code, Kiro
+ any CLI agent	Si corre en terminal, Orca lo hostea

Instalación

Desktop — macOS, Windows, Linux

Opción 1: Download directo

Descarga desde onorca.dev/download o grab un build directamente:

• macOS Apple Silicon (.dmg)
• macOS Intel (.dmg)
• Windows (.exe)
• Linux AppImage
• All builds (incluye Debian .deb, RPM)

Opción 2: Package manager

# macOS (Homebrew)
brew install --cask stablyai/orca/orca

# Arch Linux (AUR) — o stably-orca-git para build from source
yay -S stably-orca-bin

Opción 3: Headless Linux server

orca serve

Para servidores headless, ver la guía de headless Linux server.

Mobile Companion — iOS y Android

Parea con tu desktop app para monitorar y steerea agentes desde tu teléfono:

• iOS: App Store o join TestFlight
• Android: Download APK 0.0.37

Prerrequisitos antes del primer uso

Instalar Orca no instala automáticamente los agentes. Antes de empezar, verifica que tienes los CLIs que quieres usar:

# Verificar agentes instalados
claude --version    # Claude Code
codex --version     # OpenAI Codex
opencode --version  # OpenCode
cursor --version    # Cursor CLI
# etc.

Cada agente debe estar autenticado con su propio login/API key antes de usarlo en Orca. La onboarding UI de Orca puede detectar agentes instalados y ofrece defaults para terminal, theme, notificaciones y project setup.

Primer uso: tu primer worktree paralelo

1. Abrir un proyecto

Abre Orca, selecciona Open Project y elige tu repo. Orca crea worktrees bajo .orca/worktrees/.

2. Crear worktrees paralelos

Fan un prompt across múltiples agentes:

1. Click New Worktree (o Cmd+N)
2. Escribe tu prompt/task
3. Selecciona qué agentes quieres correr (ej. Claude Code + Codex + Cursor)
4. Orca crea N git worktrees aislados, uno por agente
5. Cada agente se lanza en su worktree con su terminal propia

3. Comparar resultados

Cuando todos los agentes terminan:

• Orca muestra un side-by-side diff comparison
• 3-pane diff con checkboxes por hunk
• Check el resultado de Claude Code para auth headers, el de Codex para tests, el de Cursor para README
• Orca construye un merge commit en un fresh worktree

4. Merge el ganador

Selecciona los hunks que quieres de cada agente y Orca construye el merge. No más git cherry-pick manual across terminales.

Modos de ejecución

Orca no está locked a tu laptop. Cada worktree corre en algún lado:

Modo	Dónde viven files y agents	Best for
Local	Tu desktop	Day-to-day coding, fast iteration
SSH target	Host remoto via SSH	Dev boxes, GPU hosts, always-on VPS
Remote Orca Server	Máquina corriendo Orca desktop o orca serve	Persistent shared runtime, mobile, automation
Cloud VM	VM/sandbox desechable por workspace	Isolated, ephemeral agent compute

SSH Worktrees

Apunta Orca a cualquier SSH host — un Mac mini, un Linux VPS, un GPU box, un cloud sandbox con SSH. Al crear un worktree, pick ese host bajo Run on. Agentes y git worktree corren remoto; el editor, diff y UI quedan en tu laptop.

• Full file editing, git y terminales en el remoto
• Auto-reconnect y port forwarding incluidos
• Remote PTYs sobreviven via relay en el host remoto, con grace period tras cerrar la app
• SSH passphrase se puede recordar en memoria
• Abre en VS Code Remote-SSH
• Descarga remote folders via SFTP cuando está disponible

Remote Orca Server

Mantén Orca corriendo en una máquina que controlas — old laptop, Mac mini, home server, cloud VPS. Pair tu laptop, browser client o phone a ese runtime. El server posee projects, worktrees, terminales y agent processes; los clients son la UI.

• Agentes siguen corriendo después de que tu laptop duerme
• Mobile reconecta a las mismas sessions
• Setup más fácil: instala Orca + Tailscale en ambos. En el server: Settings → Remote Orca Servers → Advertise as server → New Link. En el client: Add Server y pega el link

Cloud VMs (per-workspace environments)

Cada worktree puede boote su propio on-demand environment — cloud sandbox, VM o local Docker container — desde una recipe checked into el repo (orca.yaml + lifecycle scripts). Create spins it up; suspend/resume/destroy tear it down.

• Providers soportados: Vercel Sandbox, Fly, Modal, plain SSH hosts, local Docker
• Settings → Experimental → Cloud VM para habilitar
• Orca es un thin wrapper: tu provider account, images y billing quedan tuyos

Features clave en detalle

Terminal Splits

Terminales Ghostty-class con WebGL rendering, infinite splits y scrollback que sobrevive restarts. xterm.js como foundation (mismo que VS Code), con themes importables desde Ghostty.

Design Mode

Click cualquier UI element en una ventana real de Chromium embebida y Orca envía su HTML, CSS y cropped screenshot directo al prompt del agente. El agente ve exactamente qué elemento estás viendo y puede sugerir cambios específicos.

GitHub y Linear nativo

Browse PRs, issues y project boards in-app. Abre un worktree desde cualquier task y review sin context switch. Soporta:

• GitHub: pull requests, issues, projects, Actions
• Linear: tasks via personal API token
• GitLab: soporte en docs

Annotate AI Diffs

Drop comentarios en cualquier línea de diff y envíalos al agente. Review, edita y commitea sin salir de Orca.

Drag Files to Agents

Editor VS Code con autosave everywhere. Drag files o images directo al prompt del agente.

Orca CLI

Los agentes también pueden drivear Orca. Script cualquier workflow:

orca worktree create    # Crear worktree
orca snapshot           # Snapshot del estado
orca click              # Click en UI elements
orca fill               # Fill forms/inputs

Esto permite que un agente coordinador cree worktrees para otros agentes, tome snapshots de progreso, y interactúe con UI elements programáticamente.

Account Switcher y Usage Tracking

Ve Claude y Codex usage y rate-limit resets. Hot-swap accounts sin re-logging in. Especialmente útil tras los rate limits tighten de Anthropic y OpenAI en mayo/junio 2026.

Computer Use

Deja que agentes operen desktop apps y UI visible cuando un workflow necesita interacción real.

Quick Open

Search across worktrees, files, agents, commands y repo context sin dejar tu flow.

Notifications y Unread State

Sabe cuando un agente termina o necesita atención. Marca threads como unread para volver después.

Rich Repo Previews

Preview Markdown, images, PDFs y repo docs en el workspace.

Workflow completo: de task a merged PR

1. Abre un proyecto en Orca
2. Crea N worktrees paralelos con el mismo prompt, cada uno con un agente diferente
3. Orca lanza cada agente en su worktree con su terminal propia
4. Streams de los N agentes aparecen en tabbed panes
5. Cuando terminan, Orca muestra side-by-side diff comparison
6. Selecciona hunks de cada agente via checkboxes en el 3-pane diff
7. Orca construye un merge commit en un fresh worktree
8. Tu teléfono recibe push notification cuando cualquier agente necesita input o termina
9. Envía follow-ups desde el mobile companion
10. Review el diff final, annota si necesario, commit y push

Mobile Companion en detalle

Pair tu desktop app con el mobile companion para:

• Monitorar todos los agentes desde tu teléfono
• Notificaciones push cuando un agente termina o necesita atención
• Send follow-ups desde cualquier lugar
• Steer el swarm sin estar en la computadora

Disponible en iOS (App Store / TestFlight) y Android (APK).

Costos reales

Concepto	Costo
Orca	Gratis (MIT license)
Claude Code	Subscription Anthropic (Plus/Pro/Max) o API key
Codex	Subscription OpenAI (Plus/Pro) o API key
OpenCode	Free / BYO API key
Cursor CLI	Subscription Cursor
GitHub Copilot CLI	Subscription GitHub Copilot
VPS para SSH worktrees	Tuyo (DigitalOcean $4/mes, Hetzner, etc.)
Cloud VMs	Tuyo (Vercel Sandbox, Fly, Modal — BYO provider)

Orca no vende managed VPS hosting. Remote modes siempre usan máquinas y cloud accounts que tú controlas.

Orca vs alternativas

Feature	Orca	Claude Squad	Agent Orchestrator	conductor.build
Licencia	MIT (open source)	MIT	Apache 2.0	Closed source
Stars	41.600+	~5.600	~9.200	—
UI	Desktop GUI + mobile	TUI	Desktop GUI + mobile	Mac GUI
Agentes	30+ CLI agents	10-20	25 harnesses	3-8
Aislamiento	Git worktrees + SSH	tmux + worktrees	Worktrees	Worktrees + checkpoints
Mobile	iOS + Android	No	iOS + Android	No
SSH remoto	Sí (auto-reconnect, port forwarding)	No	No	No
Design Mode	Sí (Chromium embebido)	No	No	No
GitHub/Linear	Nativo in-app	No	CI feedback	No
Merge visual	3-pane diff con checkboxes por hunk	No	Board view	Checkpoints
CLI scriptable	Sí (orca worktree create, snapshot, click, fill)	No	No	No
Account switcher	Sí (hot-swap, usage tracking)	No	No	No
Cloud VMs	Sí (Vercel, Fly, Modal, Docker)	No	No	No
Plataformas	macOS, Windows, Linux, iOS, Android	macOS, Linux	macOS, Windows, Linux, iOS, Android	macOS

Comunidad y soporte

• Discord: Join community
• Twitter / X: @orca_build
• WeChat: grupo 7 disponible
• Feedback: Request features en GitHub Issues
• Privacidad: ver telemetry docs para data anónima y cómo opt out
• Contribuir: ver CONTRIBUTING.md

Orca ship diariamente. El changelog en GitHub Releases es la real feature list.

Signed builds

Windows code signing sponsored/provided by SignPath.io, certificate by SignPath Foundation.

FAQ

¿Orca es gratis?

Sí. Orca es free y open source bajo MIT License. Pagas solo por las suscripciones/API keys de los agentes que ya usas (Claude Code, Codex, etc.). Orca no añade costo extra.

¿Necesito instalar los agentes por separado?

Sí. Orca no bundlea ni instala los agentes. Debes tener los CLIs instalados y autenticados antes de usarlos en Orca. La onboarding UI detecta agentes instalados automáticamente.

¿Funciona con mi agente favorito?

Si corre en una terminal, corre en Orca. 30+ agentes soportados out of the box, y cualquier CLI agent puede configurarse via custom setup.

¿Puedo correr agentes en un VPS remoto?

Sí. SSH worktrees te permiten correr agentes en cualquier SSH host con auto-reconnect y port forwarding. También puedes usar Remote Orca Server (orca serve) o Cloud VMs (Vercel Sandbox, Fly, Modal, Docker).

¿El mobile companion está disponible?

Sí. iOS via App Store o TestFlight, Android via APK. Pair con tu desktop para monitorar, recibir notificaciones y enviar follow-ups desde tu teléfono.

¿Cómo funciona el merge de múltiples agentes?

Orca muestra un 3-pane diff con checkboxes por hunk. Seleccionas qué partes quieres de cada agente y Orca construye un merge commit en un fresh worktree. No más git cherry-pick manual.

¿Qué es Design Mode?

Click cualquier UI element en el Chromium embebido de Orca y envía su HTML + CSS + screenshot directo al prompt del agente. El agente ve exactamente qué elemento estás viendo.

¿Puedo scriptar Orca?

Sí. La Orca CLI permite orca worktree create, snapshot, click, fill. Los agentes pueden drivear Orca para crear worktrees para otros agentes, tomar snapshots e interactuar con UI.

¿Orca consume tokens extra?

No. Orca maneja coordinación via estado externo (worktrees, files), no via context windows de LLMs. Los tokens que consumes son los de los agentes subyacentes haciendo su trabajo.

¿Qué plataformas soporta?

Desktop: macOS (Apple Silicon + Intel), Windows 10/11 x64, Linux (AppImage + .deb + .rpm). Mobile: iOS (App Store) y Android (APK). Headless: orca serve en Linux server.

Conclusión

Orca es el orquestador de agentes IA más completo del ecosistema open source en 2026. Con 41.600+ stars en GitHub y ships diarios, ha evolucionado de un orchestrator básico a un Agent Development Environment completo: parallel worktrees con merge visual, SSH worktrees para VPS remoto, mobile companion para monitorar desde el teléfono, Design Mode para feedback visual directo al agente, GitHub y Linear nativo, Orca CLI scriptable, account switcher para sobrevivir rate limits, y Cloud VMs para compute desechable. La filosofía de "bring your own subscription" lo hace accesible: no pagas extra por Orca, solo usas las suscripciones que ya tienes. La apuesta de Orca es que la parte paralela es el punto entero — un orchestration shell para cualquier agente, con un teléfono en tu bolsillo que te avisa cuando cualquiera termina. Para developers que ya usan múltiples agentes CLI y pierden tiempo coordinando terminales, Orca convierte el caos del paralelismo en un workflow visual, manejable y mobile-friendly. Si estás corriendo Claude Code + Codex + Cursor en terminales sueltas, Orca es el upgrade más directo.