Oh My Codex（简称 OMX）不是另一个大模型聊天工具，而是一个轻量、可扩展、面向工程实践的「AI 编程工作流增强层」。它深度集成于 OpenAI 官方的 Codex CLI（一个基于命令行调用 Codex 模型进行代码生成与重构的工具），但为其注入了项目感知、多角色协作、状态记忆和标准化流程等关键能力。简单说：它让原本“单打独斗”的 AI 编程助手，变成一位懂你项目、会拆任务、能组团队、还记笔记的智能协作者。
核心功能
- 开箱即用的强化启动：首次运行即加载预设提示模板、项目上下文引导和最佳实践规则，告别每次手动写冗长指令的低效操作。
- 标准化全流程工作流：从需求澄清（$deep-interview）、方案规划（$ralplan）、多智能体协同执行（$team），到最终复盘（$ralph），覆盖 AI 编程全生命周期。
- 可插拔的智能体团队（Agent Teams）：支持按需调用不同角色的 AI 智能体——如前端专家、测试工程师、文档撰写者，它们共享项目状态并协同完成复杂任务。
- 项目级状态持久化：所有对话记录、生成计划、决策依据、中间产物自动保存在项目根目录下的
.omx/文件夹中，确保上下文不丢失、过程可追溯、结果可复现。 - HUD（抬头显示）式实时辅助：在终端中动态展示当前任务进度、已调用技能、依赖状态和建议下一步，让 AI 协作过程更透明、更可控。
- 开放集成生态：原生支持与 OpenClaw（开源 AI 工具链）、VS Code 插件、CI/CD 流水线等对接，轻松嵌入现有开发环境。
适合哪些人用
如果你是以下角色之一，Oh My Codex 极可能成为你日常开发中的“隐形生产力杠杆”：
• 独立开发者 / 小团队工程师：想快速用 AI 完成原型验证、脚本编写或遗留系统迁移，又不愿陷入反复调试提示词的泥潭；
• 技术负责人 / 工程师导师：希望统一团队 AI 使用规范，沉淀项目知识，降低新人上手门槛；
• AI 工具链探索者：关注 Agent、RAG、Workflow 等前沿范式，渴望在真实编码场景中动手实践而非仅看 Demo；
• 教育工作者 / 技术布道者：需要向学生或听众清晰演示“如何让 AI 真正理解一个项目”，而非孤立地生成单个函数。
快速上手
只需三步，5 分钟内即可体验 OMX 的强大工作流：
- 前提安装：确保已安装 Node.js v20+ 和官方
@openai/codex-cli（通过npm install -g @openai/codex-cli）； - 全局安装 OMX：运行
npm install -g oh-my-codex； - 进入任意项目目录，启动增强版 Codex：执行
omx（会自动检测并加载.omx/配置），然后尝试输入$team "帮我用 React 写一个带搜索的 Todo 列表"，观察多角色协同响应过程。
更多进阶用法（如自定义技能、集成 Git Hooks、配置 HUD 显示项）详见其官网文档与中文友好的 Docs 目录。
项目信息
OmX – Oh My codeX: Your codex is not alone. Add hooks, agent teams, HUDs, and so much more.
TypeScript｜11595 Star｜MIT 开源协议｜GitHub 项目地址
Oh My Codex 不是试图取代 Codex，而是让它真正“扎根”于你的项目土壤——让每一次 AI 编程，都更像一次有准备、有分工、有记录、有成长的高效协作。
