企业官网建设流程全解析

oh-my-codex（OmX）：Codex CLI 增强工作流层，从单兵到多代理团队的完整上手指南

【免费下载链接】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

如果你已经在用 Codex CLI，oh-my-codex（简称 OmX）就是套在它上面的一层工作流编排：Codex 继续当真正干活的引擎，OmX 负责把提示词、流程和运行时状态管好。它能帮你把固定流程跑起来、把任务拆给多个代理并行、还能一屏盯住进度，少敲一堆重复指令。

为什么需要它

痛点很具体：Codex CLI 默认是"一问一答"式单会话，它不会主动把任务拆成「澄清 → 规划 → 执行 → 验证」的固定节奏，也不帮你把常用角色和检查步骤沉淀成可复用资产。结果就是每个新项目，你都得重新口头交代边界、重新盯进度、手动切角色。OmX 补的就是这一层——它是 Codex CLI 的增强工作流层，不额外引入模型，只在你现有 Codex 之上做任务路由、工作流和运行时。

核心能力拆解

用 hooks 钩子把工作流自动化

• 自定义插件放在.omx/hooks/*.mjs，默认启用，export OMX_HOOK_PLUGINS=0可整体关闭。
• 能监听session-start、pre-tool-use、post-tool-use、turn-complete等生命周期事件，把"每次都要手动做"的动作写成脚本。
• 脚手架 + 校验一条命令跑通，不用自己摸事件格式。

omx hooks init && omx hooks validate

事件契约和插件 SDK 详见 docs/hooks-extension.md。

多代理团队怎么搭

• 命令行直接起队：omx team 3:executor "修复失败用例并验证"，3 个 executor worker 各自落到独立 git worktree 并行干活，互不污染。
• 会话内用$team "..."，在某个长任务故事里触发协调式并行；需要单一 owner 死磕到底时则用$ralph。
• 起停成对：omx team status查询、omx team resume恢复、omx team shutdown收尾，状态写进.omx/state/team/<team-name>/，中断后可续跑。

如何一屏盯住 Codex 会话状态

• HUD 是一个监控/状态面板，定位是"看状态"，不是主操作入口。
• 在 tmux 会话里自动开一个 2~3 行的 pane，展示 leader 以及 team / ultragoal 的推进情况。
• 终端高度不够时它会自动让位，不会挤坏你的 Codex 界面。

omx hud --watch

上手实操：三步跑通 OmX ⚙️

前置只需 Node.js 20+ 和一个已登录的codex命令。建议先codex --version确认：

git clone https://gitcode.com/GitHub_Trending/oh/oh-my-codex npm install -g oh-my-codex omx setup --scope project --merge-agents omx doctor omx --help

omx doctor体检安装形态，omx --help列出全部命令。想先做真实冒烟测试，可跑一次omx exec验证当前环境的鉴权与模型调用是否正常。

适合谁 / 怎么选

• 已经在用 Codex CLI、想要固定流程、多代理并行和状态可见的人：上 OmX 收益最大。
• 只想要"纯 Codex 一问一答"、不打算沉淀流程的人：直接用 Codex CLI 更省事，这层可以跳过。
• 平台偏好 macOS / Linux；team模式依赖tmux，原生 Windows 是次要路径。
• 产出差异可以用基准图感受一下，不同配置下生成的浏览器界面（Tetris 示例）对比如下：

把它当成"更好的任务路由 + 更好的工作流 + 更好的运行时"来用，而不是一个要你整天手动操作的命令面板。想深入，看官方 Getting Started、Skills 参考 与 Hooks 扩展文档。

【免费下载链接】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