Codex–MiMoCode Bridge

一个轻量的本地 MCP 桥接器：Codex 将需求澄清或代码实现交给 MiMoCode，再审核结果。底层只调用 mimo run --format json。

开发与验证

需要 Node.js 22+、npm 和已配置好的 MiMoCode CLI。

npm install
npm run build
npm test
npm run lint
npm run validate:plugin

构建会清理本项目 dist/，防止旧入口混入发布包。安装/更新插件是独立操作，以上命令不会修改已安装插件。找不到 mimo 时，可在启动 Codex 前将 CODEX_MIMO_COMMAND 设置为 CLI 可执行文件的绝对路径；兼容 MIMO_COMMAND，不接受附带参数的命令字符串。

Related MCP server: agent-herder

MCP 工具

cwd 必须是绝对目录。工作工具立即返回 queued 回执，每个物理项目目录同时运行一个任务。默认 MiMo 执行时限为 30 分钟，可明确设置 1 毫秒至 24 小时。续接只传新增要求；没有捕获到 MiMo session 的任务无法续接。

CLI 与 MCP 使用相同逻辑：

node dist/cli/main.js ask --cwd /absolute/project --task "澄清这个功能需要哪些输入"
node dist/cli/main.js implement --cwd /absolute/project --task "实现稳定的冒泡排序"
node dist/cli/main.js result --cwd /absolute/project --job-id job-xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx
node dist/cli/main.js resume --cwd /absolute/project --job-id job-xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx --task "增加降序选项"

执行与审核

每个任务只启动一个后台 worker。MiMoCode 直接在 cwd 执行，不创建副本，不回写、不切片、不自动重试，也不自动提交。ask 使用工具受限的只读 agent；implement 使用 MiMoCode 的 build agent。保留已有模型、认证、插件及其他 MCP 配置，仅禁用同名桥接器，避免递归调用。

退出码为 0、有最终文本且没有错误事件，表示调用完成。桥接器不依赖 session.post 回调，不把完成等同于代码验收。MiMo 执行的命令及退出码作为证据返回，Codex 仍需查看修改并选择必要检查。

Git 项目通过前后文件内容记录生成修改列表，保留已有未提交修改。Git 忽略的未跟踪文件（例如依赖和测试缓存）不参与记录；已经被 Git 跟踪的文件仍纳入。非 Git 项目或记录失败时返回 tool-events-only，命令造成的修改可能不完整，应独立审核。

工作结果保存在 .codex-mimo/jobs/ 和 .codex-mimo/reports/，中文/长任务写入 UTF-8 的 .codex-mimo/inputs/。建议将 .codex-mimo/ 加入 Git 忽略。结果默认精简，完整回答和命令可按需查看 reportPath。

Codex Desktop 信任并启用插件 hooks 后，工作回执会登记到本地等待器，完成后通知当前聊天获取结果；不需要模型轮询。等待器最多等待 30 分钟，超出后只提醒状态，不取消任务。未启用 hooks 时手动取结果。中断聊天会解除等待，取消 MiMo 任务需调用 mimo_cancel。

与旧版的差异

0.2 是精简重写，移除了 Compose、切片编排、临时工作区及回写、强制验收、supervisor、自定义通知服务和旧宿主适配。旧 API 不兼容。旧任务、日志和报告保留在磁盘，但新版本不管理或续接它们；更换版本前应结束旧 worker。

详见 设计 和 操作说明。