OpenRig explicado: coordinar agentes de programación con supervisión
Arquitectura de OpenRig: de RigSpec a puestos activos
Sigue las declaraciones hasta el daemon, tmux y los adaptadores de runtime
Qué aprenderás
- Declara el equipo
- Sigue una petición de arranque
- Separa visor y ejecución
Antes de empezar
- Node 22 o 24 y tmux en un host compatible
- Una cuenta de proveedor funcional y un repositorio desechable
Convierte el primer equipo owner/checker en evidencia de adopción segura
Conclusiones clave
- Topología declarada y disponibilidad real son estados distintos.
- SQLite conserva coordinación; tmux aloja terminales.
- La vida del visor no determina la del puesto.
Declara el equipo
RigSpec describe pods, miembros, aristas y continuidad. AgentSpec reutiliza instrucciones, skills, hooks, perfiles y contratos de inicio. La vista previa permite inspeccionar la topología antes de lanzar puestos.
Una declaración no garantiza que la cuenta autentique ni que el contrato de inicio termine. Compara el grafo previsto con la salida real de `rig ps --nodes`.
Sigue una petición de arranque
La CLI envía una petición up al daemon local. Este coordina servicios y persiste estado en SQLite, mientras tmux y los adaptadores alojan los procesos de proveedor. El kernel aporta soporte operativo separado.
La identidad lógica del puesto permanece aunque cambie la sesión que lo ocupa. La dirección estable facilita localizar al revisor, pero la continuidad del contexto requiere comprobarse tras reiniciar.
Separa visor y ejecución
La TUI dibuja grafo y tabla de puestos. herdr o cmux organizan terminales; tmux sigue siendo la capa subyacente de sesiones. El README describe la antigua interfaz React como mantenimiento.
Si falla la pantalla, distingue fallo del daemon, de tmux, del adaptador y del visor. Reiniciar todo porque se cerró una ventana puede duplicar el trabajo.
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
Examina RigSpec y AgentSpec por separado.
- 2
Compara el plan con los puestos realmente activos.
- 3
Diagnostica daemon, tmux, runtime y visor individualmente.
Ejemplo para copiar
RigSpec + AgentSpec -> plan de CLI
CLI / MCP / TUI -> daemon -> SQLite
daemon -> puesto tmux -> runtime proveedorPreguntas frecuentes
¿La TUI ejecuta a los agentes?
No. Muestra estado; las sesiones residen en tmux y los adaptadores.
¿Un puesto es siempre la misma conversación?
No. La función estable puede pasar a otra sesión.
Fuentes
- OpenRig / README.mdFuente verificada 2026-10-04
- OpenRig / docs/reference/rig-spec.mdFuente verificada 2026-10-04
- OpenRig / docs/reference/agent-spec.mdFuente verificada 2026-10-04
- OpenRig / packages/cli/src/commands/up.tsFuente verificada 2026-10-04
- OpenRig / docs/reference/instance-layout.mdFuente verificada 2026-10-04