Orchestrator Mode
把一个自包含的任务交给 headless Codex worker，让它跑到完成，不必守着终端。
Orchestrator Mode 是 MadoAgent 把一个自包含任务交给 Codex worker 的方式，你不需要守着终端。它不是开一个交互式 Codex 会话盯着它打字，而是在一个新的图块里启动一个 headless、非交互 的 Codex 运行。worker 要么自己跑完，要么被 sandbox 拒绝操作——它从不停下来问你问题，所以没什么可守的。
它适合从 MadoAgent 派发的 fire-and-forget 工作："重构这个模块"、"为这张表写迁移"、"给这个文件生成测试"。你下指令，worker 跑，跑完你回来看。
Orchestrator Mode 创建的图块在标题栏带一个 Worker 徽章，让 headless worker 一眼就能与你自己开的终端区分开。该徽章在应用重载后仍然保留。
你能用它做什么
- 从 MadoAgent 派发一个 headless Codex worker，处理运行中不需要你介入的任务。
- 选择 sandbox 模式，控制 worker 能碰什么：
模式 worker 能做什么 read-only 读文件，但不能修改或运行有副作用的命令。 workspace-write（默认） 在工作目录内读写。 danger-full-access 无 sandbox 限制。必须显式选择——MadoAgent 不会自己选这个。 - 让 MadoAgent 监督进展 —— 它观察 worker 图块，在运行完成、失败或仍在进行时回报给你。
- 取消脱轨的 worker —— 当 MadoAgent 判断一次运行看起来不对劲时。
如何使用
- 用 Cmd+Shift+M（⌘⇧M）打开 MadoAgent。
- 请求派发一个 worker，例如"派发一个 Codex worker 把
auth.ts重构成一个类"。 - MadoAgent 开一个带 Worker 徽章的新终端图块，并在其中启动 headless Codex 运行。
- MadoAgent 轮询该图块，在 worker 完成、失败或仍在运行时告诉你。你也可以随时自己点开图块读输出。
默认 sandbox 是 workspace-write，目的是让被派发的 worker 不会在没有显式、刻意放宽的情况下碰到项目目录之外的任何东西。
常见用例
- "派发一个 Codex worker 为新的
users表写迁移。" 发出去，继续干活，MadoAgent 报告完成时回来看图块。 - "跑一个 read-only Codex worker 总结
payments/在做什么。" 用 read-only sandbox，worker 只能看不能改。 - "在一个 worker 里给
auth.ts生成测试，我这边继续写代码。" Worker 徽章让 headless 运行与你的交互式终端视觉上分开。
提示与最佳实践
- 分析类任务（总结、解释、审计）用 read-only——既然不该改任何东西，就没必要给写权限。
- 普通重构留在 workspace-write。只有当任务确实需要触及项目目录之外时才用 danger-full-access，并且要刻意选择。
- 如果 MadoAgent 报告 worker "仍在运行"但看起来脱轨了，让 MadoAgent 取消它，而不是干等。
- 把 worker 图块当作发生了什么的真相来源——MadoAgent 的摘要是为了方便，完整输出在图块里。
相关功能
- MadoAgent —— 你派发 worker 的面板。
- Agent Routing —— MadoAgent 如何决定把什么发到哪里。
- Ensemble Exploration —— 当你想在同一个问题上跑多个 worker 而不是一个时。
局限
- worker 在关闭审批的情况下运行——sandbox 不允许的任何操作会被自动拒绝，而不是卡在一个没人回答的 prompt 上。请据此规划 sandbox 模式。
- headless worker 不交互。如果任务运行中需要你回答权限 prompt，请改用交互式 Codex 图块。
- worker 跑在你本地的 Codex CLI 上；要启动它们，你需要先配置好 Codex。