OmX (oh-my-codex)：给 Codex 补上工作流、角色与团队协作的一层

OmX (oh-my-codex)：给 Codex 补上工作流、角色与团队协作的一层

【免费下载链接】oh-my-codexOmX - Oh My codeX: Your codex is not alone. Add hooks, agent teams, HUDs, and so much more.项目地址: https://gitcode.com/GitHub_Trending/oh/oh-my-codex

OmX（oh-my-codex）是架在 OpenAI Codex CLI 之上的一层工作流工具。它不替代 Codex，而是让会话一开始就更稳：把澄清需求、审批计划、多目标执行串成一条流程，并提供可复用的角色、技能与多代理团队。适合已在使用 Codex、想让复杂任务更好落地的开发者。

适合什么时候引入 OmX

如果你只用 Codex 做一次性小改动，多半用不上它。当你开始处理跨多步的任务、需要固定的“先计划后执行”节奏，或希望多个代理并行干活时，它才真正有价值。一个简单的判断：你更想要一套可重复的流程，而不是每次手动敲命令，那就值得引入。

OmX 能帮你解决什么问题

下面按“你实际能省下的事”来分，而不是罗列功能清单。

把澄清、计划、执行串成一条线

• 内置一条默认流程：先用$deep-interview澄清需求边界，再用$ralplan审批实现计划，最后用$ultragoal把计划落成可跟踪的多目标执行。
• 计划、日志、状态都沉淀在项目的.omx/目录里，可回溯、可续接，不用每次自己决定下一步该干什么。

用角色与技能复用常见动作

• 内置约 30 个角色提示（如架构分析、安全审查、调试）与 40 个技能（如$autopilot、$team、$ralph），用$关键字即可调用。
• 常用动作直接复用，不必从零写提示词；按需加载 2 到 5 个相关技能即可，不建议一次全挂。

多代理团队并行推进

• $team/omx team基于 tmux 起多个并行 worker，支持 Codex 与 Claude 混编，任务在共享队列里领取与交接。
• 适合体量较大、可拆分的任务；遇到很小的原子任务时，它可能只起 1 个 worker 并给出“过度编排”提示。

OmX 怎么快速开始 🚀

• 前提：Node 20+、已安装并登录 Codex CLI（可用codex --version确认），并建议配好 Git。
• 官方安装方式是装 npm 包：npm install -g oh-my-codex。
• 装完跑omx doctor检查安装是否完整，再做一次真实执行冒烟测试，确认当前 Codex 配置能完成一次真实模型调用。
• 之后在项目里用omx启动即可；想要更强的会话可用omx --madmax --xhigh（仅在可信仓库使用）。

效果如何验证，适合哪些项目

• 项目自带一个可视化基准，用来比较不同代理生成同一任务（如浏览器小游戏）的产出差异，可以直观看结构、控制说明与视觉完整度。
• 更适合：已有 Git 仓库、任务可拆分、需要固定流程的中大型项目；不太适合追求“纯 Codex、零额外层”的轻量用法。
• omx doctor负责安装检查，omx hud --watch是运行时的监控面板，两者都属于“看得见的状态”，但不是主工作流。

OmX 上手前要注意哪些限制

• 默认面向 macOS/Linux + Codex CLI；原生 Windows 是次要路径，稳定性与文档都偏少，WSL2 通常更稳。
• --madmax会绕过审批与沙箱护栏，只在可信仓库用；在 Git 仓库里建议配合--worktree=<任务名>做隔离。
• 多会话并行时，给每个会话单独的OMX_ROOT，避免共享同一运行目录导致冲突。
• omx doctor变绿只代表安装没问题，不代表鉴权与模型调用一定通，最好补一次真实执行测试。

想先试的话，可以先在一个低风险项目里跑一遍doctor加冒烟测试，确认环境没问题，再用默认流程试一个真实小任务，觉得某一步多余再决定要不要精简。参考材料可看官方入门文档与团队编排源码。

【免费下载链接】oh-my-codexOmX - Oh My codeX: Your codex is not alone. Add hooks, agent teams, HUDs, and so much more.项目地址: https://gitcode.com/GitHub_Trending/oh/oh-my-codex