Orca: coordine agentes sin perder la identidad del trabajo
Arquitectura de Orca: hosts, worktrees y celdas relay
Separe ejecución de tareas, acceso headless y relay móvil sin asumir una única ruta para todas las conexiones.
Qué aprenderás
- Ubicación y ejecución
- Componentes del relay
- Push es otra ruta
Antes de empezar
- Lectura básica de comandos y configuración
- Entorno de ensayo desechable y autorizado
Identifique host, worktree y evidencia de aceptación sin automatizar merges ni borrar trabajo pendiente.
Conclusiones clave
- Una ruta sin host puede ser ambigua.
- El relay tiene workspace propio.
- Push no es el transporte de sesión.
Ubicación y ejecución
Los worktrees organizan archivos y los terminales ejecutan agentes o shells. En remoto pueden estar en otra máquina. Registre host junto a ruta para no inspeccionar un directorio parecido en el equipo equivocado.
El contrato ready distingue el destino alcanzable para clientes del listener que debe proteger el operador. Esas direcciones tienen responsabilidades diferentes incluso cuando se parecen en una instalación local.
Componentes del relay
cloud/README.md describe conexiones WebSocket salientes de teléfonos y escritorios hacia celdas. Un director asigna hosts y coordina migraciones; las celdas transportan conexiones. Esto describe el relay, no toda conexión directa o SSH.
cloud/ es un workspace pnpm independiente con contrato, servidor y operación propios. Compilar el paquete de escritorio no configura automáticamente un relay privado. Su despliegue necesita otra preparación.
Push es otra ruta
El documento separa push gateway y relay. El gateway envía notificaciones mediante APNs y FCM. Recibir una notificación no demuestra que la sesión interactiva funcione ni que el código generado sea correcto.
El README explica limitaciones de entrega FCM sin conexión. Observe ejecución, conexión y notificaciones por separado. Inspeccionamos esa arquitectura documental sin auditar cifrado ni probar entrega móvil real.
Cómo elegir
| Criterio | Opción A | Opción B |
|---|---|---|
| Best when | You need predictable behavior and easy auditing | You need adaptive optimization and have reliable telemetry |
| Main risk | May leave performance on the table | Can become difficult to explain or debug |
Pasos de implementación
- 1
Registre el host de cada terminal.
- 2
Separe relay de endpoints directos.
- 3
Observe push independientemente.
Ejemplo para copiar
Tarea → worktree y terminal del host
Teléfono / escritorio → celda ← director
Escritorio → push gateway → APNs / FCMPreguntas frecuentes
¿Una notificación confirma éxito?
Compruebe el resultado de tarea; la notificación es otro evento.
¿Compilar escritorio despliega relay?
No. Tiene configuración y workspace separados.
Fuentes
- Orca / README.mdFuente verificada 2026-09-18
- Orca / docs/reference/headless-linux-server.mdFuente verificada 2026-09-18
- Orca / cloud/README.mdFuente verificada 2026-09-18