Yeachan-Heo/oh-my-codex

# oh-my-codex (OMX)

Start Codex stronger, then let OMX add better prompts, workflows, and runtime help when the work grows.

[](https://www.npmjs.com/package/oh-my-codex) [](https://opensource.org/licenses/MIT) [](https://nodejs.org) [](https://discord.gg/PUwSMR9XNk) **网站：** https://yeachan-heo.github.io/oh-my-codex-website/ **文档：** [入门指南](./docs/getting-started.html) · [Agents](./docs/agents.html) · [Skills](./docs/skills.html) · [集成](./docs/integrations.html) · [Demo](./DEMO.md) · [OpenClaw 指南](./docs/openclaw-integration.md) OMX 是 [OpenAI Codex CLI](https://github.com/openai/codex) 的工作流层。 它保留 Codex 作为执行引擎，并让以下操作变得更简单： - 默认启动更强的 Codex 会话 - 从明确需求到最终完成，运行一致的工作流 - 通过 `$deep-interview`、`$ralplan`、`$team` 和 `$ralph` 调用规范化的 skills - 将项目指引、计划、日志和状态保存在 `.omx/` 中 ## 核心维护者 | 角色 | 姓名 | GitHub | | --- | --- | --- | | 创始人 & 负责人 | Yeachan Heo | [@Yeachan-Heo](https://github.com/Yeachan-Heo) | | 维护者 | HaD0Yun | [@HaD0Yun](https://github.com/HaD0Yun) | ## 大使 | 姓名 | GitHub | | --- | --- | | Sigrid Jin | [@sigridjineth](https://github.com/sigridjineth) | ## 顶级协作者 | 姓名 | GitHub | | --- | --- | | HaD0Yun | [@HaD0Yun](https://github.com/HaD0Yun) | | Junho Yeo | [@junhoyeo](https://github.com/junhoyeo) | | JiHongKim98 | [@JiHongKim98](https://github.com/JiHongKim98) | | Lor | — | | HyunjunJeon | [@HyunjunJeon](https://github.com/HyunjunJeon) | ## 推荐的默认流程 如果你想要默认的 OMX 体验，请从这里开始： ``` npm install -g @openai/codex oh-my-codex omx setup omx --madmax --high ``` 然后在 Codex 内部正常工作： ``` $deep-interview "clarify the authentication change" $ralplan "approve the auth plan and review tradeoffs" $ralph "carry the approved plan to completion" $team 3:executor "execute the approved plan in parallel" ``` 这是主要路径。 强劲地启动 OMX，在需要时先明确需求，批准计划，然后选择 `$team` 进行协调的并行执行，或选择 `$ralph` 进行持久化的完成循环。 ## OMX 的用途 如果你已经喜欢 Codex 并希望围绕它获得更好的日常运行时，请使用 OMX： - 围绕 `$deep-interview`、`$ralplan`、`$team` 和 `$ralph` 构建的标准工作流 - 当任务需要时的专家角色和支持 skills - 通过作用域化的 `AGENTS.md` 提供项目指引 - 在 `.omx/` 下存储持久的计划、日志、记忆和模式跟踪状态 如果你只想要纯 Codex 而不需要额外的工作流层，你可能不需要 OMX。 ## 快速开始 ### 环境要求 - Node.js 20+ - 已安装 Codex CLI：`npm install -g @openai/codex` - 已配置 Codex 认证 - 如果后续需要持久的 team 运行时，在 macOS/Linux 上需要 `tmux` - 如果后续需要 Windows team 模式，在原生 Windows 上需要 `psmux` ### 一个良好的首次会话 以推荐的方式启动 OMX： ``` omx --madmax --high ``` 然后尝试规范化工作流： ``` $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" ``` 当批准的计划需要协调的并行工作时使用 `$team`，或者当一个持久的负责人应该持续推进至完成时使用 `$ralph`。 ## 一个简单的思维模型 OMX **不**替代 Codex。 它在 Codex 周围添加了一个更好的工作层： - **Codex** 执行实际的 agent 工作 - **OMX 角色关键词** 使有用的角色可复用 - **OMX skills** 使常见工作流可复用 - **`.omx/`** 存储计划、日志、记忆和运行时状态 大多数用户应该将 OMX 视为 **更好的任务路由 + 更好的工作流 + 更好的运行时**，而不是一个需要整天手动操作的命令界面。 ## 如果你是新手，从这里开始 1. 运行 `omx setup` 2. 使用 `omx --madmax --high` 启动 3. 当需求或边界尚不明确时，使用 `$deep-interview "..."` 4. 使用 `$ralplan "..."` 来批准计划并审查权衡 5. 选择 `$team` 进行协调的并行执行，或选择 `$ralph` 进行持久化的完成循环 ## 推荐的工作流 1. `$deep-interview` — 当需求或边界仍然模糊时，明确范围。 2. `$ralplan` — 将明确后的范围转化为批准的架构和实施计划。 3. `$team` 或 `$ralph` — 使用 `$team` 进行协调的并行执行，或者当你想要一个有单一负责人的持久化完成循环时使用 `$ralph`。 ## 常见的会话内界面 | 界面 | 用途 | | --- | --- | | `$deep-interview "..."` | 明确意图、边界和非目标 | | `$ralplan "..."` | 批准实施计划和权衡 | | `$ralph "..."` | 持久化的完成和验证循环 | | `$team "..."` | 当工作足够大时的协调并行执行 | | `/skills` | 浏览已安装的 skills 和支持辅助工具 | ## 高级 / 运维界面 这些很有用，但它们不是主要的入门路径。 ### Team 运行时 当你特别需要持久的 tmux/worktree 协调时使用 team 运行时，而不是作为开始使用 OMX 的默认方式。 ``` omx team 3:executor "fix the failing tests with verification" omx team status omx team resume omx team shutdown ``` ### Setup、doctor 和 HUD 这些是运维/支持界面： - `omx setup` 安装 prompts、skills、config 和 AGENTS 脚手架 - `omx doctor` 当看起来有问题时验证安装 - `omx hud --watch` 是一个监控/状态界面，不是主要的用户工作流 ### Explore 和 sparkshell - `omx explore --prompt "..."` 用于只读仓库查询 - `omx sparkshell ` 用于 shell 原生检查和有界验证 示例： ``` omx explore --prompt "find where team state is written" omx sparkshell git status omx sparkshell --tmux-pane %12 --tail-lines 400 ``` ### Team 模式的平台说明 `omx team` 需要兼容 tmux 的后端： | 平台 | 安装命令 | | --- | --- | | macOS | `brew install tmux` | | Ubuntu/Debian | `sudo apt install tmux` | | Fedora | `sudo dnf install tmux` | | Arch | `sudo pacman -S tmux` | | Windows | `winget install psmux` | | Windows (WSL2) | `sudo apt install tmux` | ## 已知问题 ### Intel Mac：启动期间高 `syspolicyd` / `trustd` CPU 占用 在某些 Intel Mac 上，OMX 启动 —— 特别是使用 `--madmax --high` 时 —— 可能会导致 `syspolicyd` / `trustd` CPU 使用率飙升，因为 macOS Gatekeeper 正在验证许多并发进程启动。 如果发生这种情况，请尝试： - `xattr -dr com.apple.quarantine $(which omx)` - 在 macOS 安全设置中将你的终端应用添加到开发者工具允许列表 - 使用较低的并发（例如，避免 `--madmax --high`） ## 文档 - [入门指南](./docs/getting-started.html) - [Demo 指南](./DEMO.md) - [Agent 目录](./docs/agents.html) - [Skills 参考](./docs/skills.html) - [集成](./docs/integrations.html) - [OpenClaw / 通知网关指南](./docs/openclaw-integration.md) - [贡献指南](./CONTRIBUTING.md) - [更新日志](./CHANGELOG.md) ## 语言 - [English](./README.md) - [한국어](./README.ko.md) - [日本語](./README.ja.md) - [简体中文](./README.zh.md) - [繁體中文](./README.zh-TW.md) - [Tiếng Việt](./README.vi.md) - [Español](./README.es.md) - [Português](./README.pt.md) - [Русский](./README.ru.md) - [Türkçe](./README.tr.md) - [Deutsch](./README.de.md) - [Français](./README.fr.md) - [Italiano](./README.it.md) - [Ελληνικά](./README.el.md) - [Polski](./README.pl.md) ## Star 历史 [](https://www.star-history.com/#Yeachan-Heo/oh-my-codex&type=date&legend=top-left) ## 许可证 MIT

标签：Agent团队, AI编程助手, CLI增强工具, GNU通用公共许可证, Hooks, MITM代理, Node.js, NPM包, OpenAI Codex, OSV-Scalibr, PyRIT, 人工智能, 人机交互, 代码执行引擎, 代码生成, 任务管理, 任务编排, 多智能体系统, 威胁情报, 工作流自动化, 开发者工具, 技术栈扩展, 提示词工程, 效率工具, 数字取证, 数据管道, 渗透测试工具, 用户模式Hook绕过, 策略决策点, 自动化攻击, 自动化脚本, 软件工程