用途
OMX(oh-my-codex)是面向 OpenAI Codex CLI 的多智能体编排层,用于在 Codex CLI 中组织复杂的多智能体工作流。它适合需要并行团队协作、分阶段流水线执行、持久化状态与记忆、以及角色化智能体分工的开发场景。
主要能力
角色提示词(30 个智能体)
- 核心开发:architect、planner、executor、debugger、verifier、explore,用于主开发流程。
- 质量保证:style-reviewer、quality-reviewer、api-reviewer、security-reviewer、performance-reviewer,用于代码审查通道。
- 领域专家:dependency-expert、test-engineer、build-fixer、designer、writer、qa-tester,用于专项任务。
- 产品策略:product-manager、ux-researcher、product-analyst、information-architect,用于产品规划。
工作流技能(40+)
- autopilot($autopilot):从想法到可运行代码的全自主执行。
- ralph($ralph):带验证器校验的自引用循环,直至完成。
- ultrawork($ulw):通过并行智能体编排实现最大并行度。
- team($team):使用 Codex CLI 原生团队协调 N 个智能体。
- plan($plan):带共识与审查模式的战略规划。
- research($research):并行科学家智能体进行综合研究。
- tdd($tdd):测试先行开发,红-绿-重构循环。
- build-fix($build-fix):修复构建错误、类型错误与工具链故障。
- code-review($code-review):跨所有质量维度的综合代码审查。
- security-review($security-review):聚焦漏洞与信任边界的安全审计。
- cancel($cancel):停止执行模式并清除活动状态。
MCP 服务器
- omx_state:持久化模式生命周期状态。
- omx_memory:面向长时间运行会话的记忆与记事本界面。
- omx_code_intel:代码智能与上下文。
- omx_trace:执行追踪与调试。
使用方式
安装与设置
前置条件:macOS 或 Linux(Windows 通过 WSL2)、Node.js >= 20、已安装 Codex CLI(npm install -g @openai/codex)、已配置 Codex 认证。
安装命令:
npm install -g oh-my-codex omx setup omx doctor
推荐启动配置:
omx --xhigh --madmax
角色提示词(在 Codex 内)
/prompts:architect "analyze current auth boundaries" /prompts:executor "implement input validation in login" /prompts:security-reviewer "audit OAuth flow"
工作流技能
$plan "ship OAuth callback safely" $autopilot "implement user registration" $team 3:executor "fix all TypeScript errors"
团队模式(终端)
omx team 4:executor "parallelize a multi-module refactor" omx team status <team-name> omx team resume <team-name> omx team shutdown <team-name>
启动标志
- --yolo:快速执行,最少验证。
- --high:高推理强度。
- --xhigh:超高推理强度。
- --madmax:映射到 Codex --dangerously-bypass-approvals-and-sandbox。
- --force:强制操作。
- --dry-run:预览而不执行。
- --verbose:详细输出。
分阶段流水线
OMX 实现结构化执行流水线:team-plan → team-prd → team-exec → team-verify → team-fix。
- Plan:工作的战略分解。
- PRD:产品需求定义。
- Exec:团队工作者的并行执行。
- Verify:交付物验证。
- Fix:自动化错误解决。
钩子扩展(v0.4.0+)
原生生命周期事件:session-start / session-end / session-idle、turn-complete。
插件工作流:
OMX_HOOK_PLUGINS=1 omx hooks test omx hooks init omx hooks status omx hooks validate omx hooks test
插件文件:.omx/hooks/*.mjs
配置
AGENTS.md 注入:默认情况下,OMX 注入项目级 AGENTS.md:
-c model_instructions_file="<cwd>/AGENTS.md"
环境控制:
OMX_BYPASS_DEFAULT_SYSTEM_PROMPT=0 omx OMX_MODEL_INSTRUCTIONS_FILE=/path/to/instructions.md omx
快速参考
- omx:启动带 HUD 的 Codex。
- omx setup:安装提示词、技能、配置接线。
- omx doctor:安装/运行时诊断。
- omx doctor --team:团队/集群诊断。
- omx team <n>:<role> "<task>":启动团队工作者。
- omx team status <name>:显示团队状态。
- omx team shutdown <name>:关闭团队。
- omx status:显示活动模式。
- omx cancel:取消执行模式。
- omx reasoning <mode>:设置推理强度(low/medium/high/xhigh)。
- omx hud:HUD 显示选项。
- omx help:显示帮助。
适用场景
- 使用 OpenAI Codex CLI 编排复杂的多智能体工作流。
- 在 tmux 中运行并行团队工作者以协调任务执行。
- 使用持久化 MCP 服务器进行状态、记忆与代码智能管理。
- 执行分阶段流水线(plan → prd → exec → verify → fix)。
- 利用基于角色的智能体提示词完成专项任务。
限制
- 需要 macOS 或 Linux(Windows 需通过 WSL2)。
- 需要 Node.js >= 20。
- 需要预先安装并配置 Codex CLI 及认证。
- 其他平台、收费、价格等信息暂未提供。
资源
- 网站:https://yeachan-heo.github.io/oh-my-codex-website/
- GitHub:https://github.com/Yeachan-Heo/oh-my-codex
- npm:https://www.npmjs.com/package/oh-my-codex
- 许可证:MIT License