OpenRig explicado: coordinar agentes de programación con supervisión
Leer el código de OpenRig: `up`, `send` y la cola
Tres puntos de entrada distinguen arranque, comunicación y propiedad del trabajo
Qué aprenderás
- Empieza por el arranque
- Sigue un mensaje
- Revisa efectos de setup
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
- Aceptar una orden CLI no implica puesto listo.
- Los mensajes no sustituyen registros de cola.
- setup y up tienen ámbitos de efecto diferentes.
Empieza por el arranque
`packages/cli/src/commands/up.ts` interpreta el origen, ofrece `--plan`, selecciona operación local o remota y muestra planes de restauración. Rechaza un archivo de topología de host usado como fuente de rig.
El camino CLI explica decisiones y errores visibles. Para comprobar un inicio real hay que seguir la respuesta del daemon e inspeccionar nodos; interpretar argumentos no garantiza un puesto activo.
Sigue un mensaje
`send.ts` analiza el destino, llama al daemon e informa entrega o error. La dirección explícita permite auditar a qué rol y a qué rig llegó la petición.
La entrega no equivale a completar una tarea. El README indica que send no crea cola: examina `queue.ts` para propietario, estado y consulta, sin confundir chat con registro de trabajo.
Revisa efectos de setup
`setup.ts` prepara la máquina, mientras `up.ts` inicia un rig. Son ámbitos de cambio diferentes. Contrasta la implementación con la tabla del README antes de probarlos en tu estación principal.
Esta revisión leyó archivos fijados, pero no ejecutó daemon ni SDK de proveedor; tampoco cubrió todas las ramas de error de una CLI extensa.
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
Sigue una respuesta de `up --plan` hasta el daemon.
- 2
Compara entrega de send con propiedad en la cola.
- 3
Enumera escrituras de setup antes del primer inicio real.
Ejemplo para copiar
up.ts -> plan -> daemon -> estado del puesto
send.ts -> destino -> entrega
queue.ts -> responsable -> tarea registradaPreguntas frecuentes
¿`rig send` devuelve un ID de tarea?
No. Quien recibe el mensaje debe registrar el trabajo en la cola.
¿Se ejecutó el código analizado?
No. Solo se leyeron archivos CLI y documentación de una revisión fijada.
Fuentes
- OpenRig / packages/cli/src/commands/up.tsFuente verificada 2026-10-04
- OpenRig / packages/cli/src/commands/send.tsFuente verificada 2026-10-04
- OpenRig / packages/cli/src/commands/queue.tsFuente verificada 2026-10-04
- OpenRig / packages/cli/src/commands/setup.tsFuente verificada 2026-10-04
- OpenRig / README.mdFuente verificada 2026-10-04