Yeachan-Heo/oh-my-codex

这是什么？

核心功能

• 01从需求澄清、规划到持久化执行的标准工作流
• 02通过 .omx/ultragoal 检查点账本管理多目标长任务
• 03借助 tmux 和独立 git worktree 实现并行智能体协作
• 04提供命名 worktree 隔离，支持并发会话启动
• 05mission 命令可顺序执行提示词清单，并支持状态查看与恢复
• 06提供会话导出、执行时间线和 token 用量查询命令

适用场景

• 在 Codex 修改代码前，把模糊的功能需求整理为经过确认的计划
• 跨会话推进需要检查点记录的长时间、多步骤重构
• 把大任务拆分到独立 worktree 中由多个并行车道处理
• 把一组 Codex 提示词排成清单，无人值守地依次执行

快速上手

1. 1

   通过 npm 安装 Codex CLI（如已通过 Homebrew 安装则跳过）

   npm install -g @openai/codex
2. 2

   全局安装 oh-my-codex

   npm install -g oh-my-codex
3. 3

   运行 doctor 检查以验证安装

   omx doctor
4. 4

   在 git 项目目录中启动 OMX

   omx

使用前须知

• !主要面向 macOS 或 Linux；原生 Windows 支持较少，行为可能不一致。
• !需要 Node.js 20+ 以及已完成认证的 Codex CLI。
• !推荐的持久化团队运行时需要在 macOS 或 Linux 上安装 tmux。
• !--madmax 标志会关闭 Codex 的审批和沙箱防护，仅应在可信环境中使用。

标签

常见问题

oh-my-codex 是什么？

为 OpenAI Codex CLI 增加规划、持久化目标执行、多智能体协作和状态管理的工作流层。 oh-my-codex（OMX）是构建在 OpenAI Codex CLI 之上的工作流层。Codex 仍负责实际执行，OMX 则提供一套标准流程：先用 `$deep-interview` 澄清需求，再用 `$ralplan` 制定计划，最后通过 `$ultragoal` 持久化地完成多目标任务；在单个任务内部，可用 `$team` 进行多车道并行协作。

oh-my-codex 可以免费使用吗？用的什么许可证？

oh-my-codex 以 MIT 许可证开源。用于商业产品前，请先确认许可证条款。

oh-my-codex 还在维护吗？

活跃维护中。oh-my-codex 最近一次提交是在 2026年10月20日。

oh-my-codex 适合用来做什么？

在 Codex 修改代码前，把模糊的功能需求整理为经过确认的计划 跨会话推进需要检查点记录的长时间、多步骤重构 把大任务拆分到独立 worktree 中由多个并行车道处理 把一组 Codex 提示词排成清单，无人值守地依次执行

oh-my-codex 怎么安装和运行？

通过 npm 安装 Codex CLI（如已通过 Homebrew 安装则跳过）: npm install -g @openai/codex 全局安装 oh-my-codex: npm install -g oh-my-codex 运行 doctor 检查以验证安装: omx doctor 在 git 项目目录中启动 OMX: omx

在哪里获取 oh-my-codex？

源代码和安装说明在 GitHub 上：https://github.com/Yeachan-Heo/oh-my-codex