Cap 1: Qué es Orca
Qué es Orca
Orca es un IDE de nueva generación diseñado para orquestar múltiples agentes de IA (Claude Code, Codex, Gemini, entre otros) en paralelo. Su arquitectura se basa en git worktrees, lo que permite que cada agente trabaje en una copia aislada del repositorio sin conflictos.
A diferencia de un IDE tradicional donde tú escribes código, Orca se centra en que tú diriges agentes que escriben código por ti, cada uno en su propio contexto aislado.
Por qué importa para devs con IA
El flujo de trabajo actual con agentes de IA tiene limitaciones claras:
- Un agente a la vez: si usas Claude Code en terminal, solo puedes ejecutar una tarea por vez
- Conflictos de archivos: dos agentes editando el mismo repo causan colisiones
- Revisión fragmentada: los diffs generados por IA se revisan en herramientas separadas
- Contexto perdido: cada agente no sabe qué están haciendo los demás
Orca resuelve estos problemas con un enfoque integrado.
flowchart TB
subgraph Orca["Orca IDE"]
direction TB
O[Orquestador] --> A1[Agente 1<br/>Claude Code]
O --> A2[Agente 2<br/>Codex]
O --> A3[Agente 3<br/>Gemini]
end
subgraph Worktrees["Git Worktrees"]
A1 --> W1[worktree/feature-auth]
A2 --> W2[worktree/fix-api]
A3 --> W3[worktree/refactor-ui]
end
W1 --> R[(Repo principal)]
W2 --> R
W3 --> R
Filosofía de diseño
Orca se construye sobre tres principios:
- Aislamiento por worktree: cada agente opera en su propio directorio de trabajo, eliminando conflictos
- Revisión humana central: el desarrollador revisa diffs, aprueba commits y hace merge desde una interfaz unificada
- Agnóstico de agente: soporta cualquier agente CLI (Claude Code, Codex, Aider, etc.) como ciudadano de primera clase
Componentes principales
| Componente | Función |
|---|---|
| Editor | Editor de código integrado con syntax highlighting |
| Terminal | Múltiples terminales donde corren los agentes |
| Diff Viewer | Revisión visual de cambios generados por cada agente |
| Worktree Manager | Crear, cambiar y eliminar worktrees |
| Browser | Navegador integrado para preview y Design Mode |
| Git Panel | Staging, commits y push desde la UI |
Orca vs alternativas
| Característica | Orca | VS Code + Copilot | Cursor | Terminal pura |
|---|---|---|---|---|
| Multi-agente paralelo | Si | No | No | Manual |
| Git worktrees nativos | Si | No | No | Manual |
| Revisión de diffs IA | Integrada | Parcial | Parcial | Manual |
| Browser integrado | Si | No | No | No |
| Design Mode | Si | No | No | No |
| Agentes agnósticos | Si | Solo Copilot | Solo Claude | Si |
Requisitos del sistema
- macOS 12+ / Windows 10+ / Linux con X11 o Wayland
- Git 2.20+ (soporte de worktrees)
- Al menos un agente CLI instalado (Claude Code, Codex, etc.)
- 8 GB RAM mínimo (16 GB recomendado para múltiples agentes)
Repositorio y comunidad
Orca es un proyecto open source disponible en github.com/stablyai/orca. La comunidad se organiza a través de GitHub Issues y Discussions.
Qué aprenderás en este tutorial
A lo largo de los siguientes capítulos cubriremos:
- Instalación en los tres sistemas operativos principales
- Worktrees: la base de todo el flujo multi-agente
- Multi-agente: ejecutar Claude Code, Codex y otros en paralelo
- Revisión de commits: workflow para revisar y aprobar código generado por IA
- GitHub: integración con PRs, Issues y Actions
- Design Mode: inspección visual con el browser integrado
- CLI: automatización y scripting con
orcadesde terminal