Oh My Codex（OMX）
为 Codex CLI 加入可复用的开发工作流、专业角色和运行时协作工具。
- Star 数
- ★ 34k
- 最近更新
- 今天
- License
- MIT
- 主语言
- TypeScript
- FA 评分
- 61/100 · 存在缺口
30 秒速览
- 运行形态
- 可在哪里用
- 平台专用Codex
- 费用
- 软件免费，模型调用费用自付
- 上手难度
- 中 · 需要几步配置
- 开始前需要
- 典型场景
- 希望在 Codex CLI 中统一需求澄清、方案评审和多阶段执行流程的开发者。
- 不适合
- 需要原生支持 Claude Code 或其他非 Codex 代理平台的团队
- 要求 Windows 获得与 macOS/Linux 同等支持的团队
- 源码审查
- 61/100 · 存在缺口
这个 Agent 能做什么，适合哪些场景？
OMX 是围绕 OpenAI Codex CLI 构建的工作流层，Codex 仍负责实际执行代码任务。它通过 CLI 提供 $deep-interview、$ralplan、$ultragoal 和 $team 等独立或串联使用的工作流，以及可复用的角色与技能。OMX 可在项目或用户范围安装提示、技能、AGENTS 指引和钩子，并将计划、日志及运行状态保存在 .omx/。在 macOS/Linux 上，配合 tmux 和 Git worktree 可运行持久团队会话；它也提供 HUD、诊断和会话检查等运维命令。项目另提供 Codex 插件布局，但插件仍需已安装的 omx CLI；推荐路径是已认证的 Codex CLI 加 OMX。
通过 npm install -g oh-my-codex 安装 omx 命令，并使用 omx setup --scope project 或 --scope user 配置作用范围。启动时，OMX 可将 Codex 放入指定 Git worktree，并在 macOS/Linux 的 tmux 环境中管理会话。用户可用 $deep-interview 澄清需求、用 $ralplan 形成计划，再用 $ultragoal 保存检查点并执行；需要并行工作时可运行 $team。OMX 将项目指导、计划、日志和状态写入 AGENTS.md、.omx/ 等位置，提供 omx doctor、omx hud 和 omx session 命令进行检查与查看。它调用当前环境中的 Codex CLI，因此首次实际模型调用还需要 Codex 已完成认证。
- 希望在 Codex CLI 中统一需求澄清、方案评审和多阶段执行流程的开发者。
- 需要将长任务拆成带有
.omx/ultragoal检查点的团队或个人开发者。 - 在 Git 项目中使用独立 worktree 隔离高权限 Codex 会话的工程师。
- 需要在 macOS/Linux 的 tmux 中协调多个 Codex 工作进程的团队。
- 需要查看 Codex 会话用量、时间线或终端状态的 OMX 用户。
如何安装或部署这个 Agent？
需要 Node.js 20+ 和已安装、已认证的 Codex CLI。若 Codex 已安装，执行：
npm install -g oh-my-codex在目标 Git 项目中进行项目级配置：
omx setup --scope project --merge-agents也可选择用户级配置：
omx setup --scope user推荐的团队运行时需要 macOS/Linux 上的 tmux；Windows 原生运行路径支持较少。
如何使用这个 Agent？
先检查安装和认证，并从目标 Git 项目启动一个命名 worktree：
omx doctor
codex login status
omx exec --skip-git-repo-check -C . "Reply with exactly OMX-EXEC-OK"
omx --worktree=feat/task --madmax --xhigh在 Codex 会话中按需运行工作流：
$deep-interview "clarify the authentication change"
$ralplan "approve the auth plan and review tradeoffs"
$ultragoal "execute the approved plan with checkpoint evidence"如某个任务确实需要并行协作，可在执行路径中使用 $team。--madmax 会绕过审批和沙箱限制，README 建议仅在可信环境中使用，并优先配合 worktree。
这个 Agent 有哪些优点和局限？
- 工作流阶段可单独调用，也可使用
$autopilot按需求澄清、规划、执行的顺序串联。 $ultragoal将多阶段任务检查点持久化到.omx/ultragoal，支持跨轮次跟进。- 提供 Git worktree 启动、tmux 团队运行时，以及 HUD 和会话诊断命令。
- 支持项目级或用户级设置，且可通过
.omx/保存项目计划、日志和状态。
- 核心运行依赖 OpenAI Codex CLI 与其认证配置，README 未说明可切换到其他代理运行时。
- 推荐体验主要针对 macOS/Linux；Windows 原生运行及 Codex App 支持较少且可能不稳定。
- 团队运行时在 macOS/Linux 上推荐使用 tmux；Windows 路径需要 psmux 且支持较弱。
- 安装和项目配置涉及全局 npm 安装、作用范围选择及持久指导文件；团队协作还需配置运行时。
这个 Agent 与同类方案有什么区别？
README 将 OMX 定位为 Codex 的附加工作流层；若只想使用不带额外工作流层的原生 Codex，README 表示可能不需要 OMX。README 还提到 gajae-code 是偏简单、较轻量的相关选择。
与相关度最高的同类 agent 并排比较关键指标。
| Agent | 源码审查 | 形态 / 费用 | Star | 最近更新 | 主语言 | 完整支持的平台 |
|---|---|---|---|---|---|---|
| Oh My Codex（OMX） 当前 | 61 · 存在缺口 | 命令行工具免费 + 模型费 | ★ 34k | 今天 | TypeScript | Codex |
| AgentsMesh | 45 · 缺口较多 | 自托管服务免费版 + 付费版 | ★ 2.4k | 26 天前 | Go | Codex · Claude Code |
| Pi Dynamic Workflows | 88 · 表现良好 | Agent 插件 / 技能免费 + 模型费 | ★ 555 | 13 天前 | TypeScript | — |
| Bernstein | 78 · 表现良好 | 命令行工具免费 + 模型费 | ★ 1.3k | 今天 | Python | Codex · Claude Code · OpenAI API |
FollowAgents 如何评估这个 Agent？
查看各维度的扣分理由
README说明启动时会检查 npm 更新并在会话结束后提示或安排更新，也明确了 --madmax 会移除 Codex 审批与沙箱保护，并建议配合 worktree；这些内容支持一定的用户知情和确认。扣分原因：候选产品包含 hooks、团队、MCP 和会话导出等能力，但给出的文件未呈现完整权限模型、数据流清单或敏感数据处理细节；会话导出默认不脱敏。依赖清单和覆盖式版本约束存在，但未见漏洞审计或依赖治理证据。维护者有署名，发布者身份仍按题设视为未知。
README区分了 Codex CLI、Node、tmux/Windows psmux 等前置条件，说明了部分冲突和工作树状态，并提供 doctor 与真实调用的检查路径；CI 文件展示了格式、静态检查、构建和测试任务。扣分原因：这些是文档与工作流定义，不是本次修订已通过的执行证据；所给 CI 内容不完整，且外部工具与服务仍可能不可用。
README明确面向已有 Codex CLI、希望增加工作流和运行时辅助的用户，列出从规划到执行的典型场景，并区分普通会话、团队、任务队列和高级操作。它说明原生 Windows 与 Codex App 支持较弱，也指出 --madmax 的安全边界。扣分原因：skill 与钩子的触发边界在所给内容中只部分说明，环境支持虽有细节但并未证明跨环境行为。
README的信息层次、快速开始、命令示例和常见限制较充分；根目录可见 MIT 许可证，Cargo.toml 与 package.json 的版本一致，且 README列出维护角色。扣分原因：给出的材料没有变更日志或维护责任与更新承诺的详细约定，版本信息也只能确认当前清单一致，不能说明版本历史治理。
OMX提供可复用工作流、技能、团队执行、HUD和持久状态，并有清楚的命令示例，普通 Codex 用户可以据此判断其潜在用途。扣分原因：功能面广且运行时涉及额外依赖、配置与状态目录；文件未提供足以量化时间或成本收益的证据，也没有展示实际输出质量。
README中的安装、运行和能力声明大多有具体命令或文档入口；package.json列出依赖与脚本，CI文件列出计划执行的检查。扣分原因：给出的 CI 不是完整材料，且缺少这些检查已通过的结果；不同文件之间只有有限的交叉印证，不能将配置当作运行事实。
- README明确表示 --madmax 会移除审批与沙箱保护；应将其视为高风险启动方式，并遵循文档建议使用隔离的 worktree。
- 会话导出默认不包含系统与开发者消息，但文本不会自动脱敏；分享导出内容前应检查敏感信息。
- 材料列出了依赖、更新机制和检查命令，但没有提供本次修订的实际检查结果或完整数据流审查。
常见问题
使用 OMX 还需要什么？
OMX 会替代 Codex 来执行代码吗？
--madmax 是否适合所有仓库？
可以只安装 Codex 插件使用 OMX 吗？
omx CLI；插件不是全局 CLI 与作用范围设置的替代品。