oh-my-codex：给 Codex 加上多 Agent 编排与工作流模板，14.4K Star

用 Codex 处理需要同时改动十几个文件的复杂重构时，流程通常是这样的：先让 AI 理解架构，再写代码，然后 review，最后跑测试。整个过程像一个人在打仗，所有环节都要自己串起来，效率低还累。

原生 Codex 缺乏工作流编排能力，没有 hooks，没有 HUD，更不支持多 Agent 协作。虽然 OpenAI 近期做了升级，但重度用户仍然倾向于使用社区工具来补齐这些能力。

最近 GitHub Trending 上出现了一个项目——oh-my-codex（简称 OMX），已经获得 14.4K Star。

项目定位

可以把 OMX 理解为给 Codex 加了一个"指挥中心"。原生 Codex 像一个能干的执行者，你说什么它做什么，但遇到复杂任务时，你得自己当项目经理——拆解任务、分配工作、协调进度、检查质量。OMX 把这些管理工作自动化了。

它内置 30 多个预设角色（架构师、执行者、审查员等）、40 多个工作流模板（需求澄清、计划审批、持久执行等），还能让多个 AI Agent 并行干活。实现方式是 shell + tmux，不需要 fork Codex 的 Rust 代码。作者的解释很直接："Codex 是 Rust 写的，我没信心跟上游，所以用 shell + tmux 做了个 workaround。"

核心功能

角色一键切换

以前每次都要跟 Codex 说"你现在是架构师"，现在直接输入 $architect，AI 就自动切换到架构师模式。OMX 内置了 30 个角色，包括架构师、执行者、调试专家、安全审查员等。

工作流模板

OMX 内置 40 个常用工作流，输入关键字即可自动跑完：

• $deep-interview：帮你理清需求
• $ralplan：帮你出技术方案
• $ralph：按方案写代码
• $team：多个 AI 一起干活

Team 模式：多 Agent 并行

输入 $team 3:executor，就能同时启动 3 个 Codex 会话，每个 AI 在独立的 git 分支里干活，互不干扰。更有意思的是，Codex、Claude、Gemini 可以混在一个团队里，各干各的活。

监控看板

运行 omx hud --watch 可以看到实时进展：当前用的什么模型、在哪个 git 分支、还剩多少上下文，以及哪个 AI 在干活、干到第几轮了。长时间跑任务时特别有用。

安装与使用

先安装依赖：

npm install -g @openai/codex oh-my-codex

然后执行初始化：

omx setup

omx setup 会自动安装 30 个 agent prompts 和 40 个 skills，整个过程大约 2 分钟。

初始化完成后，一行命令启动：

omx --madmax --high

实战示例

假设要加一个用户登录功能，可以循序渐进：

先让 AI 理清需求：

$deep-interview "加个用户登录功能，没确定用 JWT 还是 Session"

AI 会问你用户量多大、是否需要单点登录、要不要记住登录状态等问题。需求明确后，让 AI 出技术方案：

$ralplan "根据上面说的，给我出个登录方案，注意安全性和性能"

最后选择执行方式：

# 一个 Agent 慢慢干，适合小需求
$ralph "按照方案实现登录功能"

# 或者开 3 个 Agent 一起干，并行加速
$team 3:executor "一个写后端接口，一个写前端页面，一个写测试"

整个流程就是：需求 → 方案 → 代码 → 测试 → 上线。

OMX 不是替代 Codex，而是给 Codex 加了一层编排能力，让你通过简单命令调度多个 AI Agent，使工作流更顺畅。

项目地址：https://github.com/Yeachan-Heo/oh-my-codex