oh-my-codex 是什么?

oh-my-codex(OMX)是叠加在 OpenAI Codex CLI 之上的工作流与运行时层。它不替换 Codex,而是补上项目级指引、计划与状态目录、可复用技能、团队调度、hooks 和 HUD。官方主力路径是 macOS 或 Linux 上的 Codex CLI,原生 Windows 与 Codex App 目前属于支持较弱的路径。

⭐ 31,868 Stars 🍴 2,466 Forks TypeScript — 作者: Yeachan-Heo
来源: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.6

核心功能

按范围生成项目指引

omx 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-codex
团队与运行状态

OMX 在 Codex 之上管理团队任务、tmux 会话与 HUD,并把计划、日志、记忆和模式状态放进 .omx/,方便长任务中断后继续。

来源:github.com/Yeachan-Heo/oh-my-codex
两层安装检查

omx doctor 检查文件、hooks 和运行时形态;官方还要求用 codex login status 和 omx exec 做一次真实模型请求,才能覆盖认证与 provider 配置问题。

来源:github.com/Yeachan-Heo/oh-my-codex/blob/main/docs/getting-started.html

技术架构

OMX 以 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-codex

项目知识图谱

知识图谱:项目核心节点(中心)+ 核心功能(内环六边形)+ 关键技术依赖(外环 chip) Node.js 20+ 与 npmNode.js 20+ 与… 已安装、可在 PATH 中找到且已认证的 Codex CLI已安装、可在 PA… Git;推荐用于项目工作流和 worktree 隔离Git;推荐用于项… macOS/Linux 团队运行建议安装 tmuxmacOS/Linux 团… 按范围生成项目指引 从计划到交付的技能入口 团队与运行状态 两层安装检查 oh-my-codex 项目本体 核心功能 关键依赖

技术栈

语言TypeScript,另含部分 Rust 运行时组件框架OpenAI Codex CLI 上层的 npm CLI、技能和 hooks
Node.js 20+ 与 npm已安装、可在 PATH 中找到且已认证的 Codex CLIGit;推荐用于项目工作流和 worktree 隔离macOS/Linux 团队运行建议安装 tmux
本机 CLI;项目或用户范围配置;运行状态保存在 .omx/
来源:github.com/Yeachan-Heo/oh-my-codex/blob/main/docs/getting-started.html

快速上手

先运行 codex --version,确认现有 Codex CLI 可用,再执行 npm install -g oh-my-codex 和 omx doctor。进入具体 Git 项目后运行 omx setup --scope project --merge-agents;随后用 codex login status 检查登录,并按官方 smoke test 运行 omx exec --skip-git-repo-check -C . "Reply with exactly OMX-EXEC-OK"。日常任务可以从 $plan 开始,批准计划后用 $ultragoal 推进;只有任务适合并行时再调用 $team。若 Codex 是 Homebrew 安装,不要把 @openai/codex 和 oh-my-codex 合并进同一条 npm 全局安装命令。
来源:github.com/Yeachan-Heo/oh-my-codex/blob/main/docs/getting-started.html

使用场景

适合已经使用 Codex CLI、希望把需求澄清、计划、长任务检查点、并行团队、代码审查和验证变成固定流程的个人或团队。第一次使用应在小型 Git 仓库里完成 setup、doctor 和真实请求检查,再决定是否采用 tmux、worktree 或更高权限的启动参数。只想直接使用原生 Codex,或主要在原生 Windows、Codex App 中工作时,OMX 的收益和支持程度都较有限。

来源:github.com/Yeachan-Heo/oh-my-codex

优势与局限

优势

  • 保留 Codex 作为执行引擎,安装后仍能沿用原有认证与项目
  • 把技能、团队、HUD、计划和状态放进同一套 CLI 工作流
  • doctor 与真实模型 smoke test 分开,能区分安装形态和认证调用问题
  • MIT 许可,官方 npm 包与仓库身份写得清楚

局限

  • 官方明确把 macOS/Linux + Codex CLI 作为推荐路径,原生 Windows 和 Codex App 支持较弱
  • Node.js、Codex CLI、认证、Git 以及可选 tmux 共同构成较长的故障链
  • --madmax 会绕过审批和沙箱,只应在可信仓库并配合独立 worktree 使用
  • 同名或 OMX v2 第三方项目并非官方发布线,安装时必须核对仓库和 npm 包名
来源: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.6

实测与证据

status: 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.6

同类项目对比

OpenAI 官方 Codex CLI 本身是可在本机运行的编码代理,提供独立安装、登录和基础交互;OMX 依赖它,再增加固定技能入口、项目范围 setup、.omx/ 状态、团队调度和 HUD。想减少中间层时直接用 Codex CLI;需要一套有状态的长任务与多代理流程时再加 OMX。

来源:github.com/openai/codex

总结评价

OMX 适合愿意接受额外运行层、并且确实需要长任务状态、团队协作和固定审查流程的 Codex CLI 用户。先在小仓库完成 project scope setup、doctor 与真实请求检查;确认收益后再启用 tmux 团队或高权限模式。

来源:github.com/Yeachan-Heo/oh-my-codex/blob/main/docs/getting-started.html

常见问题

oh-my-codex 会替换 OpenAI Codex CLI 吗?

不会。OMX 是上层工作流,实际代码执行和模型调用仍由已安装并完成认证的 Codex CLI 负责。

当前应该从 $plan 还是旧稿里的 $deep-interview 开始?

一般任务可从 $plan 开始,再用 $ultragoal 推进。需求模糊时先用 $deep-interview,再进入 $ralplan 和 $ultragoal。

为什么 omx doctor 通过后还要运行 omx exec?

doctor 检查安装形态、文件和运行时依赖;omx exec 才覆盖认证、profile、provider 与真实模型请求。

oh-my-codex 在 Windows 或 Codex App 上能稳定使用吗?

官方推荐 macOS/Linux 加 Codex CLI。原生 Windows 和 Codex App 目前属于支持较弱的路径,可能出现不一致行为。

资料与核验范围
本文依据项目公开资料整理。版本、安装命令和功能边界可能随上游更新,请以所列来源和项目当前版本为准。 资料核对时间: 2026-09-23 13:55.

参考材料:README、GitHub API、依赖文件