code-yeongyu/oh-my-openagent

## 评价 # Oh My OpenAgent 你正在同时应付 Claude Code、Codex 和各种随机 OSS 模型。配置工作流。调试 agent。 我们已经做好了这些工作。测试了一切。保留了真正能派上用场的东西。 安装 oh-my-openagent。输入 `ultrawork`。大功告成。 ## 安装 oh-my-openagent 同一产品发布有两个版本： - **Ultimate 版 (omo for OpenCode)** — 完整的 omo。11 个 agent，54+ 个 lifecycle hook，5 个内置 MCP，所有 slash command，Team Mode，ulw-loop，ultrawork，hashline edits —— 应有尽有。 - **Light 版 (omo for Codex CLI)** — 适配 Codex 插件系统的可移植组件：`rules`、`comment-checker`、`git-bash`、`lsp`、`ultrawork`、`ulw-loop`、`start-work-continuation` 和 `telemetry`，以及用于 `ast_grep`、`grep_app`、`context7`、`git_bash` 和 `lsp` 的插件级 MCP。没有 agent orchestration，也没有 `team_*` 工具 —— Codex CLI 自身的界面负责完成这些工作。 选择你想要的版本。 ### TL;DR | 你想要 | 运行 | 落盘内容 | | :--- | :--- | :--- | | **Ultimate** (OpenCode) | `bunx oh-my-openagent install` (TUI 会引导你完成) | 在 `opencode.json` 中注册的插件 + agent/model 配置 + provider auth 提示 | | **Light** (Codex CLI) | `npx lazycodex-ai install` | `~/.codex/plugins/cache/sisyphuslabs/omo/` + 本地 Codex marketplace cache + `~/.codex/config.toml` marketplace/plugin/agent 块 + 可选的自主权限 + 位于 `~/.local/bin` 的组件 CLI | | **两者都要** | `bunx oh-my-openagent install --platform=both` | 包含以上两者 | `lazycodex-ai` 默认为 Codex Light 安装程序，通过 Node/npm 运行。共享的 `omo` CLI 中的 `--platform` 依然默认为 `opencode` (Ultimate)。 ### 给人类 **强烈建议：让 LLM agent 为你安装。** Ultimate 版的设置涉及订阅检测、11 个 agent 的模型选择以及各 provider 的身份验证 —— 人类在处理这些时很容易出错。而 LLM agent 会阅读完整指南并正确走完每一步。 将此 prompt 粘贴到 Claude Code、AmpCode、Cursor 或任何 agent 中： ``` Install and configure oh-my-openagent by following the instructions here: https://raw.githubusercontent.com/code-yeongyu/oh-my-openagent/refs/heads/dev/docs/guide/installation.md ``` 如果你只想要 **Light 版** (Codex CLI)，安装程序会询问是否将 Codex 配置为完全权限的自主模式。你可以自己用一行命令运行它： ``` npx lazycodex-ai install # 推荐的 non-interactive 模式： npx lazycodex-ai install --no-tui --codex-autonomous ``` 对于 Light 版，不需要 Bun。在 Node/npm 环境中使用 `npx lazycodex-ai install`。不正式支持全局安装；安装程序会将 Codex 插件直接写入 `~/.codex/`。 ### 给 LLM Agent 获取完整指南并逐步执行： ``` curl -fsSL https://raw.githubusercontent.com/code-yeongyu/oh-my-openagent/refs/heads/dev/docs/guide/installation.md ``` 该指南涵盖：平台选择、订阅访谈、provider 身份验证 (Anthropic / Gemini / Copilot / Z.ai / OpenCode Zen)、agent 与模型的匹配矩阵、模式 (`ultrawork`、`search`、`analyze`、`team`、`hyperplan`)、slash command、Light 版的 8 个 Codex 组件、Team Mode 和卸载。不要进行总结；请从头到尾仔细阅读。 ### 关于包和命令名称的说明 已发布的 npm 包和 CLI 二进制文件仍然命名为 `oh-my-opencode`（在更名过渡期间，以 `oh-my-openagent` 作为双重发布名）。在 `opencode.json` 内部，兼容层会优先选择插件条目 `oh-my-openagent`，而旧版 `oh-my-opencode` 条目在加载时会显示警告。插件配置文件通常仍然使用 `oh-my-opencode.json[c]`；系统可识别旧版和更名后的基础文件名。 推荐的 `bunx`/`npx` 调用方式是 `oh-my-openagent install`（或原始的 `oh-my-opencode install`）。该包还将 `omo` 作为 bin alias 一起发布，但**请不要**使用 `bunx omo` 或 `npx omo` —— `omo` 是由另一位作者开发的完全不同的、毫不相干的 npm 包，包管理器可能会解析到错误的包。`lazycodex-ai` 是一个单一用途的 Node/npm 安装程序包：`npx lazycodex-ai install` 会直接路由到 Codex Light 安装程序。它不是 Codex marketplace 的名称（marketplace repository 是 `code-yeongyu/lazycodex`）。Codex 看到的将是 marketplace `sisyphuslabs` 和插件 `omo`，启用方式为 `omo@sisyphuslabs`。 ### Telemetry 默认情况下会启用匿名 telemetry，以跟踪活跃安装数 (DAU/WAU/MAU)。对于这两个产品，每台机器**每天最多发送一次 (UTC 时间)** 单个事件，使用经过 SHA256 哈希处理的安装标识符（绝非原始主机名），并且不会创建 PostHog 人员画像。主插件会发出 `oh_my_openagent_daily_active`；Codex CLI Light 版会从两个来源（`install_completed` 和 `session_start`）发出 `omo_codex_daily_active`。 针对各个产品选择退出： - 主插件：`OMO_DISABLE_POSTHOG=1` 或 `OMO_SEND_ANONYMOUS_TELEMETRY=0` - Codex CLI Light 版：`OMO_CODEX_DISABLE_POSTHOG=1` 或 `OMO_CODEX_SEND_ANONYMOUS_TELEMETRY=0`（全局标志也会禁用 Codex） 请参阅 [Privacy Policy](docs/legal/privacy-policy.md) 和 [Terms of Service](docs/legal/terms-of-service.md)。 ## 跳过此 README 我们已经过了读文档的时代。只需将以下内容粘贴到你的 agent 中： ``` Read this and tell me why it's not just another boilerplate: https://raw.githubusercontent.com/code-yeongyu/oh-my-openagent/refs/heads/dev/README.md ``` ## ROADMAP 我们正在重构代码库，以支持多种 agent harness（OpenCode、Codex、Pi、Claude Code 等）。最紧迫的工作是包分层重构：将纯 TypeScript 核心逻辑、MCP server、skills 和 adapter shim 分离为不同的层，以便可以在各个 harness 之间重用相同的逻辑而无需重复。 ## 核心亮点 ### 🪄 `ultrawork` 你居然真的在读这个？不可思议。 安装。输入 `ultrawork`（或 `ulw`）。搞定。 下面的所有内容，每一项功能，每一次优化：你都不需要了解。它自己就能完美运行。 即使只有以下订阅，`ultrawork` 也能很好地工作（本项目与它们没有附属关系；这些属于个人推荐）： - [ChatGPT 订阅 ($20)](https://chatgpt.com/) - [Kimi Code 订阅 ($19)](https://www.kimi.com/code) - [GLM Coding Plan ($10)](https://z.ai/subscribe) - 如果你有资格使用按量计费 (pay-per-token)，使用 Kimi 和 Gemini 模型也不会花费太多。 | | 功能 | 版本 | 功能介绍 | | :---: | :------------------------------------------------------- | :------: | :--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | 🤖 | **Discipline Agents** | Ultimate | Sisyphus 编排 Hephaestus、Oracle、Librarian 和 Explore。一支完整的 AI 开发团队并行工作。 | | 🧩 | **Codex CLI Light 版** | Light | 运行在 OpenAI Codex CLI 内部的可移植 OMO 组件 (rules, comment-checker, git-bash, LSP, ultrawork, ulw-loop, start-work continuation, telemetry)。通过 `npx lazycodex-ai install` 安装。 | | 👥 | **Team Mode** (v4.0, opt-in) | Ultimate | Lead agent + 最多 8 个并行成员，实时 tmux 可视化，专用的 `team_*` 工具。支持 `hyperplan`（5 个挑剔的批评者）和 `security-research`（3 个 hunter + 2 个 PoC 工程师）。[文档 →](docs/guide/team-mode.md) | | ⚡ | **`ultrawork` / `ulw`** | Both | 一个词。激活所有 agent。直到完成才停止。 | | 🚪 | **[IntentGate](https://factory.ai/news/terminal-bench)** | Ultimate | 在分类或行动之前分析用户的真实意图。不再有字面上的误解。（Light 版仅识别 `ultrawork`/`ulw` 关键词。） | | 🔗 | **Hash-Anchored Edit Tool** | Ultimate | `LINE#ID` 内容哈希验证每一次更改。零过时行错误。灵感来源于 [oh-my-pi](https://github.com/can1357/oh-my-pi)。[Harness Problem 详解 →](https://blog.can.ac/2026/02/12/the-harness-problem/) | | 🛠️ | **LSP 集成** | Both | 诊断、导航、符号、workspace rename。为 agent 提供 IDE 精度。两个版本使用相同的 LSP MCP server。 | | 🔎 | **AST-Grep** | Ultimate | 支持模式感知的代码搜索，并支持跨 25 种语言重写。 | | 🧠 | **Background Agents** | Ultimate | 并行触发 5 个以上的专家。保持精简的 context。结果随时就绪。 | | 📚 | **内置 MCP** (web/docs/code search) | Ultimate | Exa (网络搜索)、Context7 (官方文档)、Grep.app (GitHub 搜索)。始终开启。 | | 🔁 | **Ralph Loop / `/ulw-loop`** | Ultimate | 自引用循环。在 100% 完成之前不会停止。 | | ✅ | **Todo Enforcer** | Ultimate | Agent 闲下来了？系统会把它拉回来。你的任务必定会被完成。 | | 💬 | **Comment Checker** | Both | 注释里没有 AI 垃圾话。代码读起来就像资深开发者写的一样。 | | 📐 | **Rules Injection** (`AGENTS.md` / `.omo/rules/**`) | Both | 项目规则和 AGENTS.md 会在每次 prompt 时自动加载到 agent 的 context 中。 | | 🎯 | **Ulw Loop** | Both | 基于 `.omo/ulw-loop/` 的持久多目标编排，带有 evidence audit。 | | 🖥️ | **Tmux 集成** | Ultimate | 完整的交互式终端。REPL、debugger、TUI。全部实时。 | | 🔌 | **Claude Code 兼容** | Ultimate | 你的 hooks、commands、skills、MCP 和插件？全都能在这里运行。 | | 🧬 | **Skill-Embedded MCP** | Ultimate | Skills 携带自己的 MCP server。无 context 膨胀。 | | 📋 | **Prometheus Planner** | Ultimate | 在任何执行之前进行访谈模式的战略规划。 | | 🔍 | **`/init-deep`** | Ultimate | 在整个项目中自动生成分层的 `AGENTS.md` 文件。极大地优化了 token 效率和 agent 性能。 | ### Discipline Agents **Sisyphus** (`claude-opus-4-7` / **`kimi-k2.6`** / **`glm-5.1`** ) 是你的主要编排者。他负责规划、委派任务给专家，并通过积极的并行执行推动任务完成。他不会半途而废。 **Hephaestus** (`gpt-5.5`) 是你的自主深度工作者。给他一个目标，而不是详细教程。他会探索代码库，研究模式，并在无需手把手指导的情况下端到端地执行。*真正的工匠。* **Prometheus** (`claude-opus-4-7` / **`kimi-k2.6`** / **`glm-5.1`** ) 是你的战略规划者。在访谈模式下：他会提出问题，确定范围，并在动一行代码之前制定详细的计划。 每个 agent 都针对其模型的特定优势进行了调优。无需手动调整模型。[了解更多 →](docs/guide/overview.md) ### Team Mode (v4.0) 一个 agent 很快。一个协调的团队是*毁灭性的*。 **Team Mode** 将 oh-my-openagent 从“一个带有 subagent 的 agent”变成了一个真正的多 agent 系统。一个 lead agent 编排一个由特定领域专家组成的团队，所有成员**并行**运行，并通过专用工具（`team_create`、`team_send_message`、`team_task_create`、`team_status` 等）进行通信。在带有焦点和网格窗口的 tmux 布局中，观看每个成员同时工作。 ``` // .opencode/oh-my-openagent.jsonc { "team_mode": { "enabled": true, "max_parallel_members": 4, "tmux_visualization": true } } ``` 重启 opencode，`team_*` 工具系列就会解锁。目前已经有两个基于此构建的 skills： - **`hyperplan`** —— 5 个充满敌意的 agent 会在写下一行代码之前，从正交角度将你的计划批驳得体无完肤。 - **`security-research`** —— 3 个漏洞 hunter + 2 个 PoC 工程师并行审计你的代码库，其严重性由*实际的可利用性*进行校准。 ### Agent Orchestration 当 Sisyphus 委派给 subagent 时，它不会挑选模型。它会挑选一个**类别**。该类别会自动映射到正确的模型： | 类别 | 用途 | | :------------------- | :--------------------------------- | | `visual-engineering` | 前端、UI/UX、设计 | | `deep` | 自主研究 + 执行 | | `quick` | 单文件更改、错别字 | | `ultrabrain` | 硬逻辑、架构决策 | Agent 说明它需要什么样的工作；harness 选择正确的模型。`ultrabrain` 现在默认路由到 GPT-5.5 xhigh。你什么都不用管。 ### Claude Code 兼容性 你精心调整了你的 Claude Code 配置。很好。 每一个 hook、command、skill、MCP、plugin 都能在这里原封不动地运行。完全兼容，包括插件。 ### 为你的 Agent 提供世界级的工具 LSP、AST-Grep、Tmux 和 MCP，真正的深度集成，而不是敷衍了事拼凑出来的。 - **LSP**：`lsp_rename`、`lsp_goto_definition`、`lsp_find_references`、`lsp_diagnostics`。为每个 agent 提供 IDE 精度。 - **AST-Grep**：支持模式感知的代码搜索，并支持跨 25 种语言重写。 - **Tmux**：完整的交互式终端。REPL、debugger、TUI 应用。你的 agent 始终保持在 session 中。 - **MCP**：网络搜索、官方文档、GitHub 代码搜索。全部内置。 ### Skill-Embedded MCP MCP server 会吞噬你的 context 预算。我们解决了这个问题。 Skills 带有它们自己的 MCP server。它们按需启动，限定于特定任务，并在完成后自动关闭。从而保持 context window 的整洁。 ### 更好的编码体验。Hash-Anchored Edits Harness problem 是真实存在的。大多数 agent 失败不是模型的错；而是编辑工具的问题。 受 [oh-my-pi](https://github.com/can1357/oh-my-pi) 启发，我们开发了 **Hashline**。agent 读取的每一行都会带有内容哈希标记： ``` 11#VK| function hello() { 22#XJ| return "world"; 33#MB| } ``` agent 通过引用这些标记来进行编辑。如果文件自上次读取后发生了更改，哈希值将不匹配，编辑会在发生任何损坏之前被拒绝。无需重现空格。零过时行错误。 Grok Code Fast 1：仅仅通过更改编辑工具，成功率就从 **6.7% 提升至 68.3%**。 ### 深度初始化。 `/init-deep` 运行 `/init-deep`。它会生成分层的 `AGENTS.md` 文件： ``` project/ ├── AGENTS.md ← project-wide context ├── src/ │ ├── AGENTS.md ← src-specific context │ └── components/ │ └── AGENTS.md ← component-specific context ``` Agent 会自动读取相关 context。实现零手动管理。 ### 规划。 Prometheus 遇到复杂任务？不要只能祈祷好运。 `/start-work` 会调用 Prometheus。他**会像真正的工程师一样对你进行访谈**，确定范围和模糊之处，并在接触代码之前构建一个经过验证的计划。agent 在开始之前就知道自己要构建什么。 ### Skills Skills 不仅仅是 prompt。每一个都包含： - 特定领域调整过的系统指令。 - 按需嵌入的 MCP server。 - 范围化权限，确保 agent 不越界。 内置：`playwright`（浏览器自动化）、`git-master`（原子提交、rebase 手术）、`frontend-ui-ux`（设计优先的 UI）。 在 `.opencode/skills/*/SKILL.md` 或 `~/.config/opencode/skills/*/SKILL.md` 下添加你自己的配置。 **想要完整的功能分解？** 请参阅 **[功能文档](docs/reference/features.md)**，详细了解 agent、hook、工具、MCP 及其他所有内容。 ## 卸载 要移除 oh-my-openagent： 1. **从你的 OpenCode 配置中移除插件** 编辑 `~/.config/opencode/opencode.json`（或 `opencode.jsonc`），并从 `plugin` 数组中移除 `"oh-my-openagent"` 或旧版 `"oh-my-opencode"` 条目： # 使用 jq jq '.plugin = [.plugin[] | select(. != "oh-my-openagent" and . != "oh-my-opencode")]' \ ~/.config/opencode/opencode.json > /tmp/oc.json && \ mv /tmp/oc.json ~/.config/opencode/opencode.json 2. **移除配置文件（可选）** # 删除在兼容性窗口期间识别到的 plugin config 文件 rm -f ~/.config/opencode/oh-my-openagent.jsonc ~/.config/opencode/oh-my-openagent.json \ ~/.config/opencode/oh-my-opencode.jsonc ~/.config/opencode/oh-my-opencode.json # 删除 project config（如果存在） rm -f .opencode/oh-my-openagent.jsonc .opencode/oh-my-openagent.json \ .opencode/oh-my-opencode.jsonc .opencode/oh-my-opencode.json 3. **验证移除** opencode --version # Plugin 不应再被加载 4. **移除 omo-codex (Codex CLI Light 版)** npx lazycodex-ai uninstall # 向后兼容的 alias： npx lazycodex-ai cleanup omo uninstall --platform=codex # 向后兼容的 alias： omo cleanup --platform=codex 卸载命令会删除受管的 `sisyphuslabs` Codex cache/marketplace 状态，在写入备份后从 `~/.codex/config.toml` 中剥离 `omo@sisyphuslabs` 插件和 hook 状态块，并移除安装清单中列出的 agent TOML 链接。如果特定项目仍保留有旧的项目本地 Codex 插件状态，请从该项目运行命令或传递 `--project `；它会修复已知的项目本地 `.codex/config.toml` 冲突，并报告项目本地的 `.codex` artifacts，而不会删除项目自有的文件。 ## 功能 那些你会觉得“本该如此”的功能。一旦用过，就再也回不去了。 查看完整的[功能文档](docs/reference/features.md)。 **快速概览：** - **Agents**：Sisyphus（主要 agent）、Prometheus（规划者）、Oracle（架构/调试）、Librarian（文档/代码搜索）、Explore（快速代码库 grep）、Multimodal Looker - **Background Agents**：像真正的开发团队一样并行运行多个 agent - **LSP & AST 工具**：重构、重命名、诊断、AST 感知代码搜索 - **Hash-anchored Edit Tool**：`LINE#ID` 引用会在每次更改前验证内容。精准修改，零过时行错误 - **Context Injection**：自动注入 AGENTS.md、README.md、条件规则 - **Claude Code 兼容性**：完整的 hook 系统、command、skill、agent、MCP - **内置 MCP**：websearch (Exa)、context7 (文档)、grep_app (GitHub 搜索) —— 由插件在 runtime 注入；在 `opencode mcp list` 中不可见（参见 [MCP 文档](docs/reference/features.md#native-vs-plugin-injected-mcps)） - **Session 工具**：列出、读取、搜索和分析 session 历史记录 - **生产力功能**：Ralph Loop、Todo Enforcer、Comment Checker、Think Mode 等 - **Doctor 命令**：内置诊断 (`bunx oh-my-opencode doctor`) 可验证插件注册、配置、模型和环境 - **模型回退**：`fallback_models` 可以在同一个数组中混合使用普通模型字符串和按回退对象的设置 - **文件 Prompt**：在 agent 配置中支持通过 `file://` 从文件加载 prompt - **Session 恢复**：从 session 错误、context window 限制和 API 失败中自动恢复 - **模型设置**：agent 与模型的匹配内置在[安装指南](docs/guide/installation.md#step-5-understand-your-model-setup)中 ## 配置 带有主观立场的默认配置，如果你坚持，也可以自行调整。 请参阅[配置文档](docs/reference/configuration.md)。 **快速概览：** - **配置位置**：用户配置加上一直遍历到 `$HOME` 的 `.opencode/oh-my-openagent.json[c]` 配置；最近的优先。旧版 `oh-my-opencode.json[c]` 仍然有效。 - **JSONC 支持**：支持注释和尾随逗号 - **Agents**：覆盖任何 agent 的模型、temperature、prompt 和权限 - **内置 Skills**：`playwright`（浏览器自动化）、`git-master`（原子提交） - **Sisyphus Agent**：主要编排者，搭配 Prometheus（规划者）和 Metis（计划顾问） - **Background Tasks**：针对每个 provider/model 配置并发限制 - **类别**：特定领域的任务委派（`visual`、`business-logic`、自定义） - **Hooks**：54+ 个 lifecycle hook（Team Mode 下为 61 个），均可通过 `disabled_hooks` 进行配置 - **MCP**：内置的 websearch (Exa)、context7 (文档)、grep_app (GitHub 搜索) —— runtime 注入，不显示在 `opencode mcp list` 中 - **LSP**：完全支持 LSP 及重构工具 - **实验性功能**：激进截断、自动恢复等 ## 作者注 **想了解背后的哲学？** 阅读 [Ultrawork 宣言](docs/manifesto.md)。 我在个人项目上烧掉了价值 2.4 万美元的 LLM token。尝试了所有工具。对一切进行了极其深入的配置。最终 OpenCode 胜出。 我遇到的每一个问题，其解决方案都已内置于这个插件中。装上就能用。 如果 OpenCode 是 Debian/Arch，那 oh-my-openagent 就是 Ubuntu/[Omarchy](https://omarchy.org/))。 深受 [AmpCode](https://ampcode.com) 和 [Claude Code](https://code.claude.com/docs/overview) 的影响。移植了他们的功能，并经常进行改进。仍在持续构建中。这就是 **Open**Code。 其他 harness 承诺提供多模型编排。我们真的交付了。还有稳定性。以及真正能起作用的功能。 我是这个项目最痴迷的用户： - 哪个模型的逻辑最敏锐？ - 谁是调试之神？ - 谁写的文章最好？ - 谁统治前端领域？ - 谁主导后端？ - 日常开发什么最快？ - 竞争对手在推出什么？ 这个插件提炼的结晶。取其精华。有改进建议吗？欢迎提交 PR。 **不要再为选择 harness 而苦恼了。** **我会去研究，窃取最好的部分，并发布在这里。** 听起来很狂？有更好的办法？欢迎贡献。随时欢迎你。 与提到的任何项目或模型均无关联。纯属个人实验。 致谢：LazyCodex 的命名灵感来源于 [LazyVim](https://github.com/LazyVim/LazyVim)。Ultragoal、UltraQA 和 Sparkshell 的想法受到 [oh-my-codex](https://github.com/Yeachan-Heo/oh-my-codex) 启发，专为 OmO 根据其理念进行了重新实现。 这个项目 99% 都是用 OpenCode 构建的。我不太懂 TypeScript，**但我亲自审查并在很大程度上重写了这份文档。** ## 受到以下公司的专业人士喜爱 - [Indent](https://indentcorp.com) - Spray（网红营销解决方案）、vovushop（跨境电商平台）和 vreview（AI 商业评论营销解决方案）的开发商。 - [Google](https://google.com) - [Microsoft](https://microsoft.com) - [Vercel](https://vercel.com) - [ELESTYLE](https://elestyle.jp) - elepay（多移动支付网关）和 OneQR（用于无现金解决方案的移动应用 SaaS）的开发商。 - [Deepgram](https://deepgram.com) *特别感谢 [@junhoyeo](https://github.com/junhoyeo) 提供的精美 hero image。*

标签：AI编程助手, MITM代理, SOC Prime, 代码生成, 开发工具, 暗色界面, 渗透测试工具, 网络调试, 自动化, 自动化攻击