Orchestrator Mode

Orchestrator Mode est la façon dont MadoAgent confie une tâche autonome à un worker Codex sans que vous ayez à surveiller un terminal. Au lieu d'ouvrir une session Codex interactive et de la regarder taper, MadoAgent lance une exécution Codex headless, non interactive dans son propre tile. Le worker soit termine seul, soit le sandbox rejette l'action — il ne s'arrête jamais pour vous poser une question, il n'y a donc rien à surveiller.

C'est la bonne forme pour le travail fire-and-forget dispatché depuis MadoAgent : « refactore ce module », « écris la migration pour cette table », « génère les tests pour ce fichier ». Vous demandez, le worker tourne, vous revenez vérifier quand c'est fait.

Un tile créé par Orchestrator Mode porte un badge Worker dans sa barre de titre, afin qu'un worker headless soit visuellement distinguable au premier coup d'œil d'un terminal que vous avez ouvert à la main. Le badge survit à un rechargement de l'application.

Ce que vous pouvez faire

• Dispatcher un worker Codex headless depuis MadoAgent pour une tâche qui n'a pas besoin de votre entrée en cours d'exécution.
• Choisir un mode sandbox pour contrôler ce que le worker est autorisé à toucher :

  Mode	Ce que le worker peut faire
  read-only	Lire des fichiers, mais ni les modifier ni exécuter de commandes à effet de bord.
  workspace-write (par défaut)	Lire et écrire dans le répertoire de travail.
  danger-full-access	Aucune restriction de sandbox. À choisir explicitement — MadoAgent ne le sélectionne jamais de lui-même.

• Laisser MadoAgent superviser la progression — il surveille le tile du worker et rapporte quand l'exécution est terminée, échouée ou toujours en cours.
• Annuler un worker déraillé si MadoAgent juge que l'exécution part en vrille.

Comment l'utiliser

1. Ouvrez MadoAgent avec Cmd+Shift+M (⌘⇧M).
2. Demandez un worker dispatché, par exemple « dispatche un worker Codex pour refactorer auth.ts en une classe ».
3. MadoAgent ouvre un nouveau tile de terminal avec un badge Worker et lance l'exécution Codex headless à l'intérieur.
4. MadoAgent sonde le tile et vous dit quand le worker est terminé, échoué ou toujours en cours. Vous pouvez aussi cliquer le tile vous-même pour lire sa sortie à tout moment.

Le sandbox par défaut est workspace-write précisément pour qu'un worker dispatché ne puisse rien toucher en dehors du répertoire du projet sans un choix explicite et délibéré de l'assouplir.

Cas d'usage courants

• « Dispatche un worker Codex pour écrire la migration de la nouvelle table users. » Lancez-le, continuez à bosser, vérifiez le tile lorsque MadoAgent signale la fin.
• « Lance un worker Codex en read-only pour résumer ce que fait payments/. » Utilisez le sandbox read-only afin que le worker puisse regarder mais rien changer.
• « Génère les tests pour auth.ts dans un worker pendant que je continue à coder ici. » Le badge Worker maintient l'exécution headless visuellement séparée de vos terminaux interactifs.

Conseils et bonnes pratiques

• Utilisez read-only pour les tâches d'analyse (résumer, expliquer, auditer) — il n'y a aucune raison d'accorder l'écriture lorsque rien ne doit changer.
• Restez sur workspace-write pour les refactors normaux. N'atteignez danger-full-access que lorsqu'une tâche a vraiment besoin d'atteindre l'extérieur du répertoire du projet, et choisissez-le délibérément.
• Si MadoAgent signale un worker comme « toujours en cours » mais qu'il semble déraillé, demandez à MadoAgent de l'annuler plutôt que d'attendre la fin.
• Considérez le tile du worker comme la source de vérité de ce qui s'est passé — le résumé de MadoAgent est un confort, le tile a la sortie complète.

Fonctionnalités associées

• MadoAgent — le panneau depuis lequel vous dispatchez des workers.
• Routage d'agents — comment MadoAgent décide quoi envoyer où.
• Ensemble Exploration — lorsque vous voulez plusieurs workers sur le même problème plutôt qu'un seul.

Limitations

• Les workers tournent avec les approbations désactivées — tout ce que le sandbox n'autorise pas est auto-rejeté plutôt que de bloquer sur un prompt que personne ne répondra. Planifiez votre mode sandbox en conséquence.
• Un worker headless n'est pas interactif. Si une tâche a besoin que vous répondiez à des prompts de permission en cours d'exécution, utilisez plutôt un tile Codex interactif.
• Les workers tournent sur votre CLI Codex locale ; vous avez besoin de Codex configuré pour qu'ils démarrent tout court.