oh-my-codex 是什么?

oh-my-codex(OMX)是面向 OpenAI Codex CLI 的工作流增强层,由 Yeachan Heo 开发(与 oh-my-claudecode 同作者,面向 Codex 而非 Claude Code)。它保持 Codex 作为执行引擎,在其上加更强的默认会话、统一的「从澄清到完成」工作流、hooks、agent teams、HUD(运行时状态显示)等,并把项目指引、计划、日志和状态保存在 .omx/ 目录。规范默认工作流通过 $deep-interview、$ralplan、$ultragoal 调用。许可为 MIT,TypeScript,约 29,444 stars;npm 包名为 oh-my-codex。官方明确推荐路径为 macOS/Linux + Codex CLI,原生 Windows/Codex App 非默认体验、支持较少。

⭐ 29,750 Stars 🍴 2,365 Forks TypeScript 作者: Yeachan-Heo
来源:README.md(标题、首段、Recommended default flow、CAUTION、Official project);GitHub 仓库元数据(stars=29444、language=TypeScript) 查看 GitHub 仓库 →

为什么值得关注

Codex CLI 用户同样需要更强的默认提示、统一工作流和多智能体/运行时增强,而 OMX 把这些一站补齐——「让你的 Codex 不再孤军作战」。它与广受欢迎的 oh-my-claudecode 出自同一作者、理念一致(零负担地增强官方 CLI),社区共用、迭代活跃,因而获得高关注。截至数据采集约 29,444 stars。

来源:README.md(描述、首段、Community);GitHub 仓库元数据(stars=29444)

核心功能

更强的默认 Codex 会话

保持 Codex 作为执行引擎,开箱即用地启动更强的会话,并以 omx 开关(如 --madmax --high)调节运行强度。

来源:README.md(首段、Recommended default flow)
统一默认工作流

提供从澄清到完成的一致工作流,规范入口为 $deep-interview、$ralplan、$ultragoal。

来源:README.md(首段、canonical default workflow)
hooks、agent teams 与 HUD

为 Codex 添加 hooks、多智能体团队和运行时 HUD 等增强,把单一 Codex 扩展为更有组织的工作流系统。

来源:README.md(描述「Add hooks, agent teams, HUDs」)
状态持久化到 .omx/

把项目指引、计划、日志和状态保存在工作区的 .omx/ 目录,便于跨会话延续与可追溯。

来源:README.md(首段 keep ... in .omx/)

技术架构

OMX 是 TypeScript 编写、以 npm 包(oh-my-codex)安装的工作流层,叠加在 OpenAI Codex CLI 之上、保持 Codex 为执行引擎。它通过 hooks、agent teams、HUD 等增强 Codex,并提供一套规范默认工作流:$deep-interview(澄清/深度访谈式需求)、$ralplan(规划)、$ultragoal(目标推进),把项目指引、计划、日志与状态持久化到工作区的 .omx/ 目录。安装时可让 npm 一并管理 Codex CLI(@openai/codex);omx setup 初始化,omx --madmax --high 等开关调节运行强度。官方强调主力适配 macOS/Linux + Codex CLI。

来源:README.md(首段、Recommended default flow、CAUTION、Docs 的 Agents/Skills/Integrations)

项目知识图谱

知识图谱:项目核心节点(中心)+ 核心功能(内环六边形)+ 关键技术依赖(外环 chip) OpenAI Codex CLI(@openai/codex,执行引擎)OpenAI Codex C… Node.js ≥ 20 更强的默认 Codex 会话 统一默认工作流 hooks、agent teams 与 HUDhooks、agent teams… 状态持久化到 .omx/ oh-my-codex 项目本体 核心功能 关键依赖

中心为项目本体,内环 = 核心功能模块,外环 = 关键技术依赖;按 deep.json 中的 core_features 与 tech_stack.key_deps 自动生成

技术栈

语言TypeScript框架OpenAI Codex CLI 之上的工作流层
OpenAI Codex CLI(@openai/codex,执行引擎)Node.js ≥ 20
npm 包 oh-my-codex 安装;主力适配 macOS/Linux;可选 OpenClaw 集成
来源:README.md(首段、Recommended default flow、CAUTION、Node 徽章、OpenClaw guide)

快速上手

推荐路径为 macOS/Linux + Codex CLI。若已装 Codex CLI:npm install -g oh-my-codex,然后 omx setup,再 omx --madmax --high 启动增强会话;若还没有 Codex CLI 并想让 npm 管理它,则先 npm install -g @openai/codex 再装 oh-my-codex。日常用 $deep-interview / $ralplan / $ultragoal 走默认工作流,状态保存在 .omx/。注意原生 Windows 与 Codex App 非默认体验、可能不稳定且支持较少;官方包以 oh-my-codex 为准,「OMX v2」等第三方名称非官方延续。
来源:README.md(Recommended default flow、CAUTION、Official project)

使用场景

适合 OpenAI Codex CLI 用户想要更强默认配置、统一工作流和多智能体/运行时增强、又不想自己折腾的开发者:用 $deep-interview 澄清需求、$ralplan 规划、$ultragoal 推进,用 hooks/agent teams/HUD 增强执行与可观测,并把计划与状态留在 .omx/ 便于延续。它与 oh-my-claudecode 理念一致,面向 Codex 生态。建议在 macOS/Linux 上使用以获得官方主力支持。

来源:README.md(首段、Recommended default flow、CAUTION)

优势与局限

优势

  • 为 Codex CLI 一站补齐更强默认、统一工作流、hooks/agent teams/HUD
  • 规范默认流程(deep-interview/ralplan/ultragoal)清晰,状态持久化到 .omx/
  • 与广受欢迎的 oh-my-claudecode 同作者、理念一致,社区活跃
  • 保持 Codex 为执行引擎,叠加增强而非替换,迁移负担小

局限

  • 强绑定 OpenAI Codex CLI,非 Codex 用户用不上
  • 官方主力适配 macOS/Linux,原生 Windows/Codex App 体验受限、支持少
  • 效果依赖 Codex 与所用模型;功能多需理清工作流
  • 存在非官方「OMX v2」等同名第三方项目,需认准官方仓库与 oh-my-codex 包
来源:README.md(CAUTION、Official project、首段)

最新版本

本页未列出具体版本号;OMX 以 npm 包 oh-my-codex 持续发布,与 oh-my-claudecode 共用社区并同步迭代。更新以完善 Codex 的默认工作流、agent teams、HUD 与集成为主。官方安装目标始终以本仓库与 oh-my-codex 包为准。

来源:README.md(Official project、npm 徽章、Community)

总结评价

oh-my-codex 是 oh-my-claudecode 在 OpenAI Codex 生态的对应版:保持 Codex 为执行引擎,叠加更强默认、统一的澄清到完成工作流、hooks/agent teams/HUD,并把状态留在 .omx/,让 Codex 用户零负担地获得更有组织的体验。对想增强 Codex CLI 又不愿自己折腾的开发者很合适,且有同作者成熟项目的理念背书。要清楚它强绑定 Codex、官方主力只在 macOS/Linux、并需认准官方包以避开同名第三方项目。作为 Codex 的工作流增强层,它定位清晰、生态衔接好。

来源:综合 README.md 的定位、默认工作流与平台支持说明
透明度声明
本页内容由 AI(大语言模型)基于以下公开材料自动生成:GitHub README、代码目录结构、依赖文件、Release 信息。 分析时间: 2026-05-24 13:27. 质量评分: 100/100.

数据来源:README、GitHub API、依赖文件