Orchestrator Mode

Orchestrator Mode es cómo MadoAgent entrega una tarea autocontenida a un worker de Codex sin que cuides un terminal. En lugar de abrir una sesión interactiva de Codex y verla escribir, MadoAgent lanza una ejecución de Codex headless, no interactiva en su propio tile. El worker o termina por sí solo o el sandbox rechaza la acción — nunca se detiene a preguntarte nada, así que no hay nada que cuidar.

Es la forma correcta para el trabajo fire-and-forget despachado desde MadoAgent: "refactoriza este módulo", "escribe la migración para esta tabla", "genera tests para este archivo". Pides, el worker corre, compruebas al volver cuando está listo.

Un tile creado por Orchestrator Mode lleva una insignia Worker en su barra de título, así un worker headless se distingue visualmente de un vistazo de un terminal que abriste a mano. La insignia sobrevive a una recarga de la app.

Qué puedes hacer con esto

• Despachar un worker de Codex headless desde MadoAgent para una tarea que no necesita tu entrada a mitad de ejecución.
• Elegir un modo de sandbox para controlar lo que el worker puede tocar:

  Modo	Qué puede hacer el worker
  read-only	Leer archivos, pero no modificarlos ni ejecutar comandos con efectos secundarios.
  workspace-write (predeterminado)	Leer y escribir dentro del directorio de trabajo.
  danger-full-access	Sin restricciones de sandbox. Hay que elegirlo explícitamente — MadoAgent nunca lo selecciona por su cuenta.

• Deja que MadoAgent supervise el progreso — vigila el tile del worker y reporta al volver cuando la ejecución terminó, falló o sigue corriendo.
• Cancelar un worker descarriado si MadoAgent juzga que la ejecución se ve fuera de control.

Cómo usarlo

1. Abre MadoAgent con Cmd+Shift+M (⌘⇧M).
2. Pide un worker despachado, por ejemplo "despacha un worker de Codex para refactorizar auth.ts convirtiéndolo en una clase".
3. MadoAgent abre un tile de terminal nuevo con una insignia Worker y lanza la ejecución headless de Codex dentro.
4. MadoAgent sondea el tile y te dice cuando el worker terminó, falló o sigue corriendo. También puedes hacer clic en el tile tú mismo para leer su salida en cualquier momento.

El sandbox por defecto es workspace-write específicamente para que un worker despachado no pueda tocar nada fuera del directorio del proyecto sin una elección explícita y deliberada de aflojarlo.

Casos de uso comunes

• "Despacha un worker de Codex para escribir la migración de la nueva tabla users." Lánzalo, sigue trabajando, revisa el tile cuando MadoAgent reporte que terminó.
• "Corre un worker de Codex read-only para resumir qué hace payments/." Usa el sandbox read-only para que el worker pueda mirar pero no cambiar nada.
• "Genera tests para auth.ts en un worker mientras yo sigo codificando aquí." La insignia Worker mantiene la ejecución headless visualmente separada de tus terminales interactivos.

Consejos y buenas prácticas

• Usa read-only para tareas de análisis (resumir, explicar, auditar) — no hay razón para dar acceso de escritura cuando nada debería cambiar.
• Quédate en workspace-write para refactors normales. Solo acude a danger-full-access cuando una tarea realmente necesita salir del directorio del proyecto, y elígelo deliberadamente.
• Si MadoAgent reporta un worker como "still running" pero parece descarriado, pide a MadoAgent que lo cancele en lugar de esperar.
• Trata el tile del worker como la fuente de la verdad de lo que pasó — el resumen de MadoAgent es una comodidad, el tile tiene la salida completa.

Funciones relacionadas

• MadoAgent — el panel desde el que despachas workers.
• Enrutamiento de agentes — cómo MadoAgent decide qué enviar a dónde.
• Ensemble Exploration — para cuando quieres varios workers sobre el mismo problema en lugar de uno.

Limitaciones

• Los workers corren con las aprobaciones desactivadas — cualquier cosa que el sandbox no permita se auto-rechaza en lugar de bloquearse en un mensaje que nadie responderá. Planifica tu modo de sandbox en consecuencia.
• Un worker headless no es interactivo. Si una tarea necesita que respondas a mensajes de permiso a mitad de ejecución, usa un tile de Codex interactivo en su lugar.
• Los workers corren en tu CLI de Codex local; necesitas Codex configurado para que arranquen.