OpenRig: organizar Claude Code y Codex en un equipo de agentes con YAML

Para quién es

OpenRig está pensado para desarrolladores que quieren organizar varios agentes de programación en un equipo fijo: un rig envuelve tus harness, defines el equipo de agentes en YAML y lo arrancas con un solo comando. Su capacidad más destacada es ejecutar Claude Code y Codex a la vez en el mismo rig, gestionados como un único sistema. Su valor está en el «equipo»: en lugar de atender cada agente en ventanas de terminal separadas, escribe los miembros en un mismo YAML y deja que un comando y verificaciones de preparación unificadas se encarguen.

Antes de empezar, revisa el entorno y no sigas hasta cumplir los cuatro puntos: Node.js 22 o 24 (22 en Apple silicon), tmux, macOS o Linux (Windows vía WSL2) y un Claude Code o Codex con sesión iniciada. Cubre cualquier carencia primero: solo con eso evitarás la mayoría de los errores posteriores. Si solo usas otros agentes, te quedas en Windows nativo o usas otra versión de Node, el soporte no está descrito oficialmente: tómalo como no confirmado.

Al revés, hay tres situaciones para esperar: usuarios que solo se manejan con interfaz gráfica y no quieren escribir configuración; quienes necesitan ejecutar directamente en Windows nativo (sin WSL2); y quienes quieran clientes distintos de Claude Code y Codex — la documentación oficial no cubre estos usos. Dicho de otro modo: si normalmente ejecutas un solo cliente y no necesitas arranque unificado, la estructura de equipo del rig aporta poco.

El primer intento en 3 minutos

Hay un único camino principal recomendado: instala el skill rigs en Claude Code con el comando oficial, suponiendo que el entorno de la sección anterior esté listo. Ejecuta en una terminal:

npx skills add https://github.com/mvschwarz/openrig/tree/v0.7.0/skills/rigs --skill rigs --agent claude-code

El v0.7.0 del comando es la ruta de versión fija que da la página oficial: cópialo tal cual. Instalado el skill, escribe en YAML la definición de tu equipo de agentes; el orden es: instalar el skill, escribir el YAML, inicializar si hace falta (rig setup) y arrancar (rig up). Oficialmente solo se dice que el equipo se define en YAML y se arranca con un comando; no hay campos, ejemplos ni ubicaciones de archivo. Para los detalles de configuración manda lo que indique el propio skill tras instalarse; no escribas la configuración por pura suposición.

Sigue la inicialización. Antes de ejecutar rig setup, conoce sus efectos secundarios: añade un bloque de OpenRig a ~/.tmux.conf; en macOS puede instalar tmux vía Homebrew; y, salvo que pases --no-herdr, también instala Herdr. Ese es el punto de confirmación previo — si no quieres Herdr, ejecútalo con --no-herdr.

Por último, el arranque: ejecuta rig up; levanta las sesiones de tmux, cada harness y los archivos de inicio, y ejecuta las verificaciones de preparación. Señales de éxito observables: aparecen en tmux las sesiones del equipo, cada harness arranca y las verificaciones dan resultado punto por punto. Si no hay sesiones o una verificación falla, vuelve a la lista del entorno y revisa la versión de Node y tmux. No se dice oficialmente si rig up modifica archivos o accede a la red: sin confirmar. A estas alturas ningún miembro ha hecho trabajo real; confirma primero un arranque sano antes de encargarle trabajo de verdad.

Casos de uso

Caso 1: que Claude Code y Codex colaboren en el mismo equipo. Escenario: usas ambos clientes y quieres tenerlos en un mismo sistema gestionado. Método: instalado el skill rigs, define los dos harness en el YAML del equipo y ejecuta rig up. Resultado esperable: ambos arrancan como un solo sistema, sus sesiones aparecen en tmux, las verificaciones dan resultado punto por punto y los dos miembros son visibles en tmux, lo que facilita comparar.

Caso 2: condensar la preparación diaria en un comando. Escenario: no quieres abrir tmux a mano y levantar los miembros uno a uno cada día. Método: con el YAML del equipo definido, ejecuta rig up al empezar la jornada y déjale las sesiones de tmux, los harness, los archivos de inicio y las verificaciones. Resultado esperable: la preparación repetitiva queda reducida a un comando, y el resultado de las verificaciones te dice directamente si el equipo está listo.

Ambos casos se encadenan bien: confirma primero con el caso 1 que la formación funciona y conviértela después en la entrada fija de cada día, como en el caso 2. Ambos casos se detienen donde se detiene la documentación oficial: cómo se reparten el trabajo los miembros tras arrancar y qué tareas ejecutan; no hay ejemplos oficiales y aquí no se inventa nada.

Límites de uso

• Entorno y clientes: la lista oficial se limita a Node.js 22 o 24 (22 en Apple silicon), tmux, macOS/Linux (WSL2) y un Claude Code o Codex con sesión iniciada; otros clientes, Windows nativo y otras versiones de Node quedan sin confirmar.
• Superficie de instalación y versión: la instalación va por npx skills add y el comando oficial queda atado a --agent claude-code; no hay marketplace de plugins ni vía equivalente para otros clientes documentada, no lo infieras por tu cuenta. La ruta de instalación apunta fija a v0.7.0 y no se describe cómo actualizar.
• Efectos secundarios y punto de confirmación: rig setup añade un bloque de OpenRig a ~/.tmux.conf, puede instalar tmux vía Homebrew e instala Herdr salvo que pases --no-herdr; confirma antes de ejecutar que aceptas estos cambios.
• Definición del equipo: los campos concretos del YAML, los ejemplos y las ubicaciones de archivo no figuran en la documentación oficial; no escribas la configuración a ciegas.
• Verificaciones de preparación: las ejecuta rig up, pero qué comprueba exactamente y qué hace ante un fallo no está documentado; fíate de la salida del comando y no des por hechos reintentos automáticos ni rollback.
• Comportamiento en tareas: OpenRig orquesta equipos; la documentación oficial no habla de reescribir textos ni de modificar archivos del usuario. El comportamiento de archivos, comandos y red de los miembros en ejecución depende del cliente que elijas; este artículo no saca conclusiones de seguridad adicionales.
• Sin confirmar: licencia y precios, desinstalación, comportamiento de salida y limpieza de rig up y el máximo de miembros por rig — nada de ello aparece en la documentación oficial.