项目简介

oh-my-codex（OMX） 是今日 GitHub Trending 排名第一的项目，目前已获得 14,031 颗 Star，主要语言为 TypeScript。

项目地址：https://github.com/Yeachan-Heo/oh-my-codex

OMX 是 OpenAI Codex CLI 的一个工作流层。它保持 Codex 作为执行引擎，并通过提供更好的默认会话、标准化工作流、可复用的技能和项目状态管理，让日常使用体验更佳。简单来说，OMX 不是 Codex 的替代品，而是 Codex 的增强层。

核心功能

标准化工作流

OMX 围绕四个核心技能构建了一套完整的工作流：

• $deep-interview：深度访谈，帮助澄清任务需求和边界
• $ralplan：制定并批准实施计划，评估利弊权衡
• $team：支持协调的并行任务执行（需要 tmux / psmux）
• $ralph：持久化完成循环，确保任务被推进到底

项目状态持久化

所有计划、日志、记忆和模式追踪都保存在项目根目录的 .omx/ 文件夹中，实现跨会话的状态持久化。

团队运行时

支持使用 tmux（macOS/Linux）或 psmux（Windows）进行持久的、协调的并行任务执行。

监控与诊断

• omx hud --watch：实时监控界面
• omx doctor：一键诊断安装状态

安装方法

前提条件

• Node.js 20+
• 已安装并配置 Codex CLI
• （可选，团队模式需要）macOS/Linux 安装 tmux，或 Windows 安装 psmux

安装命令

1

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

初始设置

安装完成后，运行以下命令完成初始化（安装提示词、技能、配置文件等）：

1

omx setup

快速开始

启动 OMX 会话

推荐使用高性能模式启动：

1

omx --madmax --high

推荐工作流

第一步：澄清需求

当任务范围或边界不明确时，使用 $deep-interview 技能：

1

$deep-interview "clarify the authentication change"

第二步：制定计划

基于澄清后的需求，使用 $ralplan 批准实施计划：

1

$ralplan "approve the safest implementation path"

第三步：执行任务

根据任务特点选择执行方式：

• 需要并行执行时，使用 $team：

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

• 需要持久化推进时，使用 $ralph：

  1	$ralph "carry the approved plan to completion"

其他常用命令

为什么值得关注

随着 AI 编程工具的快速发展，如何高效地管理和组织 AI Agent 的工作流成为了一个新的挑战。oh-my-codex 提供了一套经过实践验证的工作模式：

1. 先澄清，再执行：通过 $deep-interview 确保任务方向正确，避免无效劳动
2. 计划驱动：$ralplan 让每个任务都有明确的实施路径和风险评估
3. 并行提效：$team 支持多 Agent 协作，显著提升复杂任务的执行效率
4. 状态持久化：.omx/ 目录让任务可以跨会话延续，不再因会话中断而丢失上下文

这套工作流对于需要长期维护大型项目的开发者来说，具有很强的实用价值。

项目信息

• 仓库：Yeachan-Heo/oh-my-codex
• 最新版本：v0.11.12（发布于 2026-04-02）
• Star 数：14,031
• 主要语言：TypeScript
• 许可证：MIT