Orchestrator Mode
完結する自己完結型タスクを、ターミナルの子守をせずに最後まで走らせるヘッドレス Codex ワーカーに任せる。
Orchestrator Mode は、MadoAgent がターミナルの子守をせずに自己完結型タスクを Codex ワーカーに任せる方法です。対話型の Codex セッションを開いてタイピングを見守る代わりに、MadoAgent は独自のタイルで ヘッドレス・非対話型 の Codex 実行を立ち上げます。ワーカーは自力で終わるかサンドボックスがアクションを拒否するかのいずれかで、決して質問のために止まることはないため、子守するものは何もありません。
これは MadoAgent からディスパッチする「撃ちっ放し」の作業に適した形です — 「このモジュールをリファクタリング」「このテーブルのマイグレーションを書く」「このファイルのテストを生成」。頼むとワーカーが走り、終わったら確認するだけです。
Orchestrator Mode が作成したタイルはタイトルバーに Worker バッジを持つため、ヘッドレスワーカーを手で開いたターミナルと一目で区別できます。バッジはアプリ再読み込みを生き残ります。
できること
- ヘッドレス Codex ワーカーをディスパッチ — 実行中にあなたの入力が要らないタスクを MadoAgent から任せられます。
- サンドボックスモードを選ぶ — ワーカーが触れる範囲を制御します:
モード ワーカーにできること read-only ファイルを読めるが、変更や副作用のあるコマンドは実行できない。 workspace-write（デフォルト） 作業ディレクトリ内で読み書きできる。 danger-full-access サンドボックス制限なし。明示的に選ばれないといけない — MadoAgent は単独でこれを選ぶことはない。 - MadoAgent に進行を監視させる — ワーカータイルを見守り、ランが終了・失敗・実行中のいずれかを報告します。
- 暴走したワーカーをキャンセル — MadoAgent がランを外れていると判断した場合。
使い方
- Cmd+Shift+M（⌘⇧M）で MadoAgent を開きます。
- ワーカーのディスパッチを頼みます。例えば「
auth.tsをクラスへリファクタリングする Codex ワーカーをディスパッチして」。 - MadoAgent が Worker バッジ付きの新しいターミナルタイルを開き、その中でヘッドレス Codex ランを起動します。
- MadoAgent がタイルをポーリングし、ワーカーが終了・失敗・実行中のいずれかを伝えます。いつでも自分でタイルをクリックして出力を読むこともできます。
デフォルトのサンドボックスが workspace-write なのは、明示的に緩めない限りディスパッチされたワーカーがプロジェクトディレクトリ外に触れないようにするためです。
よくあるユースケース
- 「新しい
usersテーブルのマイグレーションを書く Codex ワーカーをディスパッチして」 撃ち放し、作業を続け、MadoAgent が終了を報告したらタイルを確認。 - 「
payments/が何をしているか要約する読み取り専用 Codex ワーカーを走らせて」 read-only サンドボックスで、ワーカーは見るだけ触れない。 - 「ここでコードを書き続ける間に、
auth.tsのテストをワーカーで生成して」 Worker バッジがヘッドレスランを対話型ターミナルと視覚的に分けておきます。
ヒントとベストプラクティス
- 分析タスク（要約、説明、監査）には read-only を使いましょう — 何も変更しないのに書き込み権限を与える理由はありません。
- 通常のリファクタリングには workspace-write のままに。danger-full-access は、タスクが本当にプロジェクトディレクトリ外に触れる必要があるときだけ意識的に選びましょう。
- MadoAgent がワーカーを「まだ実行中」と報告しているのに暴走しているように見えるなら、待つより MadoAgent にキャンセルさせましょう。
- 何が起きたかの真実の源はワーカータイルです — MadoAgent の要約は便利ですが、完全な出力を持つのはタイルです。
関連機能
- MadoAgent — ワーカーをディスパッチするパネルです。
- エージェントルーティング — MadoAgent が何をどこへ送るかをどう決めるか。
- Ensemble Exploration — 1 つではなく同じ問題に複数のワーカーが欲しい場合。
制限事項
- ワーカーは承認をオフにして実行されます — サンドボックスが許可しないものはすべて、誰も答えないプロンプトでブロックする代わりに自動拒否されます。サンドボックスモードを計画的に選びましょう。
- ヘッドレスワーカーは対話型ではありません。タスクが実行中に許可プロンプトへの回答を要するなら、代わりに対話型 Codex タイルを使いましょう。
- ワーカーはローカルの Codex CLI で走るため、開始するには Codex が設定済みである必要があります。