Lo que necesitás
- Una compu con macOS, Windows 10/11 o Linux.
- Git y un proyecto en un repositorio.
- Al menos un agente de terminal instalado y logueado con tu cuenta: Claude Code, Codex, Gemini CLI, Cursor CLI, OpenCode…
Antes de arrancar
- Orca es gratis (licencia MIT). Los modelos no: cada agente usa tu suscripción o tu API key.
- Orca no se mete en el medio: los agentes hablan directo con su proveedor.
1 · Instalar Orca
| Sistema | Cómo |
|---|---|
| macOS | Con Homebrew: brew install --cask stablyai/orca/orca. O bajá el DMG (Apple Silicon o Intel) de onorca.dev/download. |
| Windows | Instalador para Windows 10/11 x64 desde onorca.dev/download. |
| Linux | AppImage universal desde onorca.dev/download. En Arch: yay -S stably-orca-bin. |
2 · Tu primer workspace
- Agregá tu proyecto. Abrí Orca y sumá la carpeta de tu repositorio. Aparece en el panel lateral, junto con todos tus proyectos.
- Creá un worktree por tarea. Cada tarea nueva es una copia del repo en su propio
git worktree: le ponés un nombre, elegís desde qué rama arranca y, si querés, la vinculás a un issue de GitHub, Linear, Jira o GitLab. - Elegí el agente. Al crear el worktree elegís qué agente arranca en la primera pestaña (Claude Code, Codex, Gemini…) o una terminal vacía.
- Repetí en paralelo. Abrí otro worktree con otra tarea y otro agente. Como cada uno trabaja en su propia copia, no se pisan los archivos.
3 · Conectar tus agentes y tus cuentas
- Instalá y logueá cada agente. Orca usa los agentes de terminal que ya tenés. Los más conocidos vienen preconfigurados en el selector de agentes; cualquier otro que corra en una terminal también funciona.
- Sumá más de una cuenta. En Settings → Accounts configurás tus cuentas. La barra de estado muestra el uso de la cuenta activa y el selector de cuentas, el de las demás. Orca sigue el uso de Claude Code, Codex, Gemini, OpenCode, Kimi Code, MiniMax y Muse Code.
- Combiná modelos. Por ejemplo: un worktree con Claude Code arma la función y otro con Codex la revisa. Desde la vista de diff comentás líneas y se las devolvés al agente.
4 · Conectar Linear y GitHub
- Linear. Abrí Settings → Integrations → Linear, pegá un token personal de Linear (Linear → Settings → API) y elegí tus equipos.
- Trabajá desde el issue. Desde un issue de Linear o de GitHub creás el worktree: Orca completa el nombre y le vincula el issue. Mover el issue a «In Progress» al crear el worktree es opcional, por equipo.
- Revisá y entregá sin salir. Ves el diff, hacés commit, push, abrís el PR y esperás los checks, todo adentro de Orca.
5 · El CLI para orquestar
Orca trae el comando orca para manejar la app desde cualquier terminal (o desde un agente). Se registra en Settings → General → Orca CLI.
| Comando | Para qué |
|---|---|
orca worktree create |
Crear un worktree nuevo. |
orca worktree ps |
Ver un resumen de todos los worktrees y sus agentes. |
orca orchestration task-create |
Crear tareas y repartirlas entre agentes (dispatch). |
orca orchestration run |
Arrancar el coordinador que reparte y espera las tareas. |
orca linear |
Leer el ticket de Linear vinculado, moverlo de estado y adjuntarle el PR. |
orca automations create |
Programar tareas que se repiten. |
Con la orquestación, una tarea larga se parte en fases: un agente coordinador le pasa cada fase al agente que quieras y espera a que termine.
Si algo falla
- El agente no aparece o no arranca. Instalalo y logueate primero en una terminal común; Orca usa ese mismo CLI.
- Un menú no se llama igual. Orca se actualiza casi todos los días. Actualizá la app y buscá el nombre en
onorca.dev/docs. - El comando
orcano existe. Registralo en Settings → General → Orca CLI y abrí una terminal nueva.