哦我的法典（OMX）

让Codex以更强的状态启动，随后在工作规模扩大时，由OMX添加更优的提示、工作流和运行时辅助。

官网: https://yeachan-heo.github.io/oh-my-codex-website/ 文档: 入门 · 代理 · 技能 · 集成 · 演示 · OpenClaw指南 社区: Discord — oh-my-codex及相关工具的共享OMX/社区服务器。

OMX是针对OpenAI Codex CLI的工作流层。

它保留了Codex作为执行引擎，并使以下操作更加便捷：

• 默认启动更强大的Codex会话
• 从澄清到完成执行一致的工作流
• 使用$deep-interview、$ralplan、$team和$ralph调用标准技能
• 将项目指导、计划、日志和状态保存在.omx/中

核心维护者

职位	姓名	GitHub
创建者 & 首席	Yeachan Heo	@Yeachan-Heo
维护者	HaD0Yun	@HaD0Yun

大使

姓名	GitHub
Sigrid Jin	@sigridjineth

主要贡献者

姓名	GitHub
HaD0Yun	@HaD0Yun
Junho Yeo	@junhoyeo
JiHongKim98	@JiHongKim98
Lor	—
HyunjunJeon	@HyunjunJeon

推荐的默认流程

若想体验OMX的默认功能，请从这里开始：

npm install -g @openai/codex oh-my-codex
omx setup
omx --madmax --high

然后在Codex中正常工作：

$deep-interview "clarify the authentication change"
$ralplan "approve the auth plan and review tradeoffs"
$ralph "carry the approved plan to completion"
$team 3:executor "execute the approved plan in parallel"

这就是主要路径。先以较强的状态启动OMX，必要时先澄清需求，批准方案后，再选择$team进行协调并行执行，或$ralph用于持续的完成循环。

OMX适用场景

如果你已经喜欢使用Codex，并希望围绕它获得更好的日常运行体验，那么可以使用OMX：

• 围绕$deep-interview、$ralplan、$team和$ralph构建的标准工作流
• 当任务需要时提供的专业角色和支持技能
• 通过限定范围的AGENTS.md进行项目指导
• 在.omx/下持久化存储计划、日志、记忆和模式跟踪信息

如果你只需要纯粹的Codex，而不需要额外的工作流层，那么可能并不需要OMX。

快速入门

要求

• Node.js 20+
• 已安装Codex CLI：npm install -g @openai/codex
• 已配置Codex认证
• 如果后续需要持久化的团队运行环境，macOS/Linux上需安装tmux
• 如果后续需要Windows团队模式，原生Windows上需安装psmux

第一次良好体验

按推荐方式启动OMX：

omx --madmax --high

然后尝试标准工作流：

$deep-interview "clarify the authentication change"
$ralplan "approve the safest implementation path"
$ralph "carry the approved plan to completion"
$team 3:executor "execute the approved plan in parallel"

当批准的计划需要协调并行工作时使用$team，或者当需要一个持续的负责人推动完成时使用$ralph。

简单的理解模型

OMX并不会取代Codex。

它在Codex周围增加了一个更好的工作层：

• Codex 执行实际的代理任务
• OMX角色关键词 使有用的角色可复用
• OMX技能 使常见工作流可复用
• .omx/ 存储计划、日志、记忆和运行时状态

大多数用户应将OMX视为更好的任务路由 + 更好的工作流 + 更好的运行时，而不是全天手动操作的命令界面。

新手入门指南

1. 运行omx setup
2. 使用omx --madmax --high启动
3. 当请求或边界尚不明确时，使用$deep-interview "..."
4. 使用$ralplan "..."批准计划并评估权衡
5. 选择$team进行协调并行执行，或$ralph用于持续的完成循环

推荐的工作流程

1. $deep-interview — 在请求或边界仍模糊时澄清范围。
2. $ralplan — 将澄清后的范围转化为已批准的架构与实施方案。
3. $team或$ralph — 使用$team进行协调并行执行，或使用$ralph当您希望由一位负责人持续推动完成时。

常见的会话界面

界面	用途
$deep-interview "..."	澄清意图、边界和非目标
$ralplan "..."	批准实施方案及权衡
$ralph "..."	持续的完成与验证循环
$team "..."	当工作量足够大时进行协调并行执行
/skills	浏览已安装的技能及辅助工具

高级/运维界面

这些界面很有用，但并非主要的入门路径。

团队运行环境

团队运行环境应在特别需要持久化的tmux/工作树协调时使用，而不是作为使用OMX的默认方式。

omx team 3:executor "fix the failing tests with verification"
omx team status <team-name>
omx team resume <team-name>
omx team shutdown <team-name>

设置、诊断与HUD

这些是运维/支持界面：

• omx setup 安装提示、技能、AGENTS脚手架、.codex/config.toml以及OMX管理的原生Codex钩子文件.codex/hooks.json
• omx doctor 在出现问题时验证安装情况
• omx hud --watch 是监控/状态界面，而非主要的用户工作流

对于非团队会话，原生Codex钩子现在是标准的生命周期界面：

• .codex/hooks.json = 原生Codex钩子注册
• .omx/hooks/*.mjs = OMX插件钩子
• omx tmux-hook / notify-hook / derived watcher = tmux + 运行时回退路径

有关当前原生/回退矩阵，请参阅Codex原生钩子映射。

探索与 sparkshell

• omx explore --prompt "..." 用于只读仓库查询
• omx sparkshell <command> 用于原生 Shell 检查和有限范围的验证

示例：

omx explore --prompt "查找团队状态写入的位置"
omx sparkshell git status
omx sparkshell --tmux-pane %12 --tail-lines 400

团队模式的平台说明

omx team 需要一个兼容 tmux 的后端：

平台	安装命令
macOS	brew install tmux
Ubuntu/Debian	sudo apt install tmux
Fedora	sudo dnf install tmux
Arch	sudo pacman -S tmux
Windows	winget install psmux
Windows (WSL2)	sudo apt install tmux

已知问题

Intel Mac：启动时 syspolicyd / trustd CPU 使用率过高

在某些 Intel Mac 上，OMX 启动——尤其是使用 --madmax --high 选项时——可能会导致 syspolicyd / trustd 的 CPU 使用率激增，因为 macOS Gatekeeper 需要同时验证大量进程的启动。

如果出现这种情况，请尝试：

• xattr -dr com.apple.quarantine $(which omx)
• 将您的终端应用添加到 macOS 安全设置中的开发者工具允许列表中
• 降低并发度（例如，避免使用 --madmax --high）

文档

• 入门指南
• 演示指南
• 代理目录
• 技能参考
• Codex 原生钩子映射
• 集成
• OpenClaw / 通知网关指南
• 贡献指南
• 变更日志

语言

• 英语
• 한국어
• 日本語
• 简体中文
• 繁體中文
• Tiếng Việt
• Español
• Português
• Русский
• Türkçe
• Deutsch
• Français
• Italiano
• Ελληνικά
• Polski
• Українська

贡献者

角色	姓名	GitHub
创建者 & 项目负责人	Yeachan Heo	@Yeachan-Heo
维护者	HaD0Yun	@HaD0Yun

星标历史

许可证

MIT

oh-my-codex (OMX) 快速上手指南

oh-my-codex (OMX) 是专为 OpenAI Codex CLI 设计的工作流增强层。它不替代 Codex，而是通过标准化的角色（Agents）、技能（Skills）和持久化状态管理，让 Codex 在执行复杂任务时更强大、更连贯。

环境准备

在开始之前，请确保您的开发环境满足以下要求：

• Node.js: 版本需 >= 20。
• Codex CLI: 必须已安装并配置好 OpenAI 认证。
• 终端复用器 (可选但推荐):
  • macOS / Linux: 需安装 tmux (用于团队并行模式)。
  • Windows (原生): 需安装 psmux。
  • Windows (WSL2): 需安装 tmux。

提示：国内用户若遇到 npm 安装缓慢，可临时切换至国内镜像源： npm config set registry https://registry.npmmirror.com

安装步骤

1. 全局安装依赖 同时安装 OpenAI Codex 和 oh-my-codex：

   npm install -g @openai/codex oh-my-codex
   

2. 初始化配置 运行设置命令，自动安装提示词、技能模板、AGENTS.md 脚手架以及 Codex 原生钩子：

   omx setup
   

基本使用

1. 启动强化会话

推荐使用“高并发”模式启动，以获得最佳的初始性能：

omx --madmax --high

2. 标准工作流示例

进入 Codex 交互界面后，建议遵循以下标准化流程来处理复杂任务：

• 第一步：澄清需求 当任务边界或需求模糊时，使用 $deep-interview 进行深度访谈以明确范围。

  $deep-interview "clarify the authentication change"
  

• 第二步：制定并批准计划 使用 $ralplan 将澄清后的需求转化为具体的架构和实施计划，并审查权衡方案。

  $ralplan "approve the safest implementation path"
  

• 第三步：执行任务 根据任务规模选择执行模式：

  • 并行协作模式 ($team)：适用于大型任务，需要协调多个执行者并行工作。

    $team 3:executor "execute the approved plan in parallel"
    

  • 持续完成模式 ($ralph)：适用于由单一负责人持续推动直至完成的任务。

    $ralph "carry the approved plan to completion"
    

3. 常用辅助命令

在会话中，您可以随时使用以下命令查看可用技能或探索项目：

• 浏览已安装的技能列表：

  /skills
  

• 只读探索仓库内容（非交互式）：

  omx explore --prompt "find where team state is written"
  

---

核心理念：将 OMX 视为“更好的任务路由 + 更优的工作流 + 更强的运行时”，而非手动操作的命令集合。让 Codex 负责实际执行，让 OMX 负责流程编排。