oh-my-codex(OMX)是叠加在 OpenAI Codex CLI 之上的工作流与运行时层。它不替换 Codex,而是补上项目级指引、计划与状态目录、可复用技能、团队调度、hooks 和 HUD。官方主力路径是 macOS 或 Linux 上的 Codex CLI,原生 Windows 与 Codex App 目前属于支持较弱的路径。
来源:github.com/Yeachan-Heo/oh-my-codex 查看 GitHub 仓库 → 📘 使用教程 →旧稿引用的默认命令和版本已经落后:当前 README 把 $plan、$ultragoal、$team、$code-review、$ultraqa 列为可独立调用的核心入口,最新正式版也已到 v0.21.6。
来源:github.com/Yeachan-Heo/oh-my-codex/releases/tag/v0.21.6omx setup 可以明确选择 project 或 user 范围。项目范围会把持久规则放在真实项目中,并通过 .omx/setup-scope.json 记录该工作根的设置策略。
来源:github.com/Yeachan-Heo/oh-my-codex/blob/main/docs/getting-started.html当前 README 提供 $plan、$ultragoal、$team、$code-review 和 $ultraqa 等入口,且明确说明它们可以独立使用;需求模糊时还能走 $deep-interview、$ralplan、$ultragoal 的深入路径。
来源:github.com/Yeachan-Heo/oh-my-codexOMX 在 Codex 之上管理团队任务、tmux 会话与 HUD,并把计划、日志、记忆和模式状态放进 .omx/,方便长任务中断后继续。
来源:github.com/Yeachan-Heo/oh-my-codexomx doctor 检查文件、hooks 和运行时形态;官方还要求用 codex login status 和 omx exec 做一次真实模型请求,才能覆盖认证与 provider 配置问题。
来源:github.com/Yeachan-Heo/oh-my-codex/blob/main/docs/getting-started.htmlOMX 以 Node.js/TypeScript CLI 发布为 npm 包 oh-my-codex,底层执行仍由本机已安装并完成认证的 Codex CLI 负责。setup 写入选定范围的指导与技能配置;运行时在 .omx/ 保存计划、日志、记忆和模式状态。macOS/Linux 的团队模式可用 tmux 承载 leader、worker 和 HUD;使用命名 worktree 时,每个并发任务落在独立 Git checkout。
来源:github.com/Yeachan-Heo/oh-my-codexNode.js 20+ 与 npm已安装、可在 PATH 中找到且已认证的 Codex CLIGit;推荐用于项目工作流和 worktree 隔离macOS/Linux 团队运行建议安装 tmux适合已经使用 Codex CLI、希望把需求澄清、计划、长任务检查点、并行团队、代码审查和验证变成固定流程的个人或团队。第一次使用应在小型 Git 仓库里完成 setup、doctor 和真实请求检查,再决定是否采用 tmux、worktree 或更高权限的启动参数。只想直接使用原生 Codex,或主要在原生 Windows、Codex App 中工作时,OMX 的收益和支持程度都较有限。
来源:github.com/Yeachan-Heo/oh-my-codex截至 2026-09-23,最新正式版为 v0.21.6,发布于 2026-09-21。这是维护与可靠性版本,修复 tmux HUD 生命周期、AGENTS 范围、认证与凭据记录、Team 调度和 Windows 启动问题,并更新依赖。
来源:github.com/Yeachan-Heo/oh-my-codex/releases/tag/v0.21.6status: docs-only | checked_at: 2026-09-23 | environment: 只核对官方仓库、Getting Started、package 元数据与 GitHub Releases | limitations: 未安装 npm 包,未执行 setup、doctor、omx exec、团队模式或任何绕过审批的启动参数,也未验证实际 Codex 账号、模型调用和 tmux 行为 | observed_output: 官方 package 版本和最新正式 release 均为 0.21.6;release 发布于 2026-09-21,重点是 tmux HUD 生命周期、AGENTS 范围、认证记录、Team/Windows 启动可靠性和依赖更新
来源:github.com/Yeachan-Heo/oh-my-codex/releases/tag/v0.21.6OpenAI 官方 Codex CLI 本身是可在本机运行的编码代理,提供独立安装、登录和基础交互;OMX 依赖它,再增加固定技能入口、项目范围 setup、.omx/ 状态、团队调度和 HUD。想减少中间层时直接用 Codex CLI;需要一套有状态的长任务与多代理流程时再加 OMX。
来源:github.com/openai/codexOMX 适合愿意接受额外运行层、并且确实需要长任务状态、团队协作和固定审查流程的 Codex CLI 用户。先在小仓库完成 project scope setup、doctor 与真实请求检查;确认收益后再启用 tmux 团队或高权限模式。
来源:github.com/Yeachan-Heo/oh-my-codex/blob/main/docs/getting-started.html不会。OMX 是上层工作流,实际代码执行和模型调用仍由已安装并完成认证的 Codex CLI 负责。
一般任务可从 $plan 开始,再用 $ultragoal 推进。需求模糊时先用 $deep-interview,再进入 $ralplan 和 $ultragoal。
doctor 检查安装形态、文件和运行时依赖;omx exec 才覆盖认证、profile、provider 与真实模型请求。
官方推荐 macOS/Linux 加 Codex CLI。原生 Windows 和 Codex App 目前属于支持较弱的路径,可能出现不一致行为。