标签 Codex 下的文章

GitHub 日榜观察 · 第二名：oh-my-codex

仓库：Yeachan-Heo/oh-my-codex
网站：yeachan-heo.github.io/oh-my-codex-website
榜单：GitHub Trending · Today（按页面排序为当日第二名；榜单会随时变化，请以官方页为准）
快照参考（GitHub API）：约 11656 Star；1083 Fork；主语言 TypeScript；API 中 License 字段未标注；Archived False
撰稿说明：由定时任务调用 Cursor Agent 根据公开 README 与 API 整理，非项目方官方稿件。

它是什么

oh-my-codex（OMX） 是面向 OpenAI Codex CLI 的工作流层：不取代 Codex 的执行引擎，而是在其上补齐「更强的默认会话、从澄清到完成的一致流程、可复用的角色与 skills、以及落在项目里的状态与指引」。README 用一句话概括：OmX - Oh My codeX: Your codex is not alone. Add hooks, agent teams, HUDs, and so much more.

典型能力包括：用 $deep-interview、$ralplan、$team、$ralph 等约定技能串联工作；通过项目内的 AGENTS.md 做范围化指引；在 .omx/ 下持久化计划、日志、记忆与模式跟踪。若你只想用「裸」Codex、不要额外工作流，README 也明说可能不需要 OMX。

怎么安装

环境与依赖

  • Node.js 20+（README 徽章：node >=20）
  • 已全局安装并配置好 Codex CLI：npm install -g @openai/codex，并完成 Codex 鉴权
  • 若后续要用 团队持久运行时：macOS/Linux 需 tmux；原生 Windows 需 psmux（详见下文平台说明）

推荐默认一条龙（README「Recommended default flow」）

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

omx setup 会安装 prompts、skills、配置与 AGENTS 脚手架；omx --madmax --high 按 README 是偏「拉满」的启动方式（若机器吃紧可考虑降低并发，见「合规与风险」中的已知问题）。

团队模式相关（可选）

omx team 依赖 tmux 系后端，README 给出的安装示例：

平台安装
macOSbrew install tmux
Ubuntu/Debiansudo apt install tmux
Fedorasudo dnf install tmux
Archsudo pacman -S tmux
Windowswinget install psmux
Windows (WSL2)sudo apt install tmux

怎么使用

最小可跑路径（第一次会话）

  1. 按上一节完成安装后，用推荐方式启动：
omx --madmax --high
  1. 在 Codex 会话里（不是单独再开一个 shell 演示）按 README 的「canonical workflow」输入，例如：
$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"

语义上：$deep-interview 在需求边界不清时做澄清；$ralplan 把范围落成可审批的实现计划并权衡取舍；之后二选一：$team 做需要协调的并行执行，$ralph 做单一负责人持续推进的完成闭环。会话中还可通过 /skills 浏览已装 skills。

进阶操作面（非必读入门）

  • 团队运行时（需要 durable tmux/worktree 协调时再上，而非默认第一步）：
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>
  • 运维向：omx doctor 用于安装自检；omx hud --watch 为监控向界面，非主流程。
  • 只读探索 / Shell 辅助：
omx explore --prompt "find where team state is written"
omx sparkshell git status
omx sparkshell --tmux-pane %12 --tail-lines 400

更细的步骤与概念见仓库内文档（下一节链接）。

合规与风险

  • 许可证：README License 一节写明 MIT；npm 徽章亦为 MIT。GitHub API 返回的 license 可能为空，以仓库 README 与 npm 发布页为准做合规判断。
  • 供应链：通过 npm install -g oh-my-codex（及 @openai/codex）拉取依赖时，建议锁定版本、关注发行说明，并在企业环境走内部镜像与审计流程。
  • 数据与隐私：OMX 依附 Codex 与 OpenAI 侧配置工作，涉及代码与提示内容上传策略时，需按你方政策与 OpenAI 条款单独评估。
  • 已知问题（Intel Mac）：README 说明在部分 Intel Mac 上，带 --madmax --high 的启动可能拉高 syspolicyd / trustd CPU（Gatekeeper 并发校验）。可尝试：
    xattr -dr com.apple.quarantine $(which omx)、在系统安全设置里把终端加入 Developer Tools 允许列表，或降低并发（避免 --madmax --high）。
  • 归档状态：当前 API 显示 Archived: false，若日后变更请以仓库页为准。

适合谁

  • 已经在用 Codex CLI、希望有统一「澄清 → 定案 → 执行/并行」套路的开发者。
  • 需要在项目内沉淀计划、日志与运行时状态（.omx/）的小团队或个人。
  • 愿意接受一层约定（$deep-interview 等）来换更可重复工作流的人；若你坚持极简、零魔法命令，则可能不是目标用户。

推荐结论

值得在日榜语境下关注：OMX 把「Codex 仍是执行核心」讲清楚，同时给出可复制的默认路径与可选团队运行时，文档入口（Getting Started、Agents、Skills、Integrations）齐全。上手建议严格按 omx setup → omx --madmax --high 走一遍 README 示例，再决定是否启用 omx team；Intel Mac 若遇 CPU 尖峰，优先按官方 Known issues 降级并发或处理隔离属性。

延伸阅读