[!TIP] 公开构建

维护者正在使用 Jobdori（一个基于深度定制的 OpenClaw 分支构建的 AI 助手）实时构建并维护 oh-my-opencode。每一个功能、每一次修复、每一次问题分类——都在我们的 Discord 上直播。

→ 在 #building-in-public 中观看整个过程

[!NOTE]

我们正在构建 Sisyphus 的完整产品化版本，以定义前沿智能体的未来。
请在此处加入候补名单 这里。

[!TIP] 与我们一起！

	加入我们的 Discord 社区，与贡献者和 oh-my-opencode 的其他用户交流。
	过去，oh-my-opencode 的新闻和更新会发布在我的 X 账号上。 由于该账号被误封，现在 @justsisyphus 代表我发布更新。
	在 GitHub 上关注 @code-yeongyu，了解更多项目。

Anthropic 因为我们的缘故封锁了 OpenCode。 是的，这是真的。 他们希望你被锁定在他们的生态系统中。Claude Code 看似不错的“监狱”，但终究还是个“监狱”。

我们在这里不搞锁定。我们兼容所有模型：Claude / Kimi / GLM 用于编排；GPT 用于推理；Minimax 用于速度；Gemini 用于创造力。 未来的趋势不是选择单一赢家，而是将它们协同起来。模型每个月都在变得更便宜、更智能。没有任何一家供应商会占据主导地位。我们正在为那个开放市场而努力，而不是他们的封闭花园。

评论

“它让我取消了 Cursor 的订阅。开源社区里正在发生着不可思议的事情。” - Arthur Guiot

“如果 Claude Code 需要 7 天才能完成一个人类需要 3 个月的工作，那么 Sisyphus 只需 1 小时就能完成。它就是能一直工作，直到任务完成。它是一个纪律严明的智能体。”
- B，量化研究员

“仅用一天时间，我就用 Oh My Opencode 消除了 8000 条 eslint 警告。”
- Jacob Ferrari

“我用 Ohmyopencode 和 ralph loop，在一夜之间将一个 4.5 万行的 tauri 应用程序转换成 SaaS 网站。一开始我给了它一个面试提示，让它对问题进行评分和推荐。看着它一步步完成工作，今天早上醒来发现网站几乎已经可以运行了，真是太神奇了！” - James Hargis

“用了 oh-my-opencode 后，你就再也回不去了。”
- d0t3ch

“我还没法准确地表达它究竟好在哪里，但开发体验已经提升到了一个全新的维度。” - 苔硯:こけすずり

“这个周末我在尝试用 open code、oh my opencode 和 supermemory 来制作一款 Minecraft/魂系风格的怪异作品。” “我一边出去午饭后散步，一边让它添加下蹲动画。[视频]” - MagiMetal

“你们应该把这个核心功能整合进去，并且把他招进来。说真的，这太棒了。”
- Henning Kilset

“如果能说服他，就赶紧雇佣 @yeon_gyu_kim 吧，这家伙彻底革新了 opencode。”
- mysticaltech

“Oh My OpenCode 实在太疯狂了。” - YouTube - Darren Builds AI

---

Oh My OpenCode

你在同时使用 Claude Code、Codex 和各种开源模型，还要配置工作流、调试智能体。

我们已经帮你把这些事情都做好了。经过全面测试，只保留真正可用的功能。

安装 OmO，输入 ultrawork，搞定。

安装

对于人类

将以下提示复制并粘贴到你的 LLM 智能体（Claude Code、AmpCode、Cursor 等）中：

按照这里的说明安装并配置 oh-my-opencode：
https://raw.githubusercontent.com/code-yeongyu/oh-my-openagent/refs/heads/dev/docs/guide/installation.md

或者阅读 安装指南，不过说实话，还是让智能体来做吧。人类手动配置很容易出错。

适用于 LLM 代理

获取安装指南并按照步骤操作：

curl -s https://raw.githubusercontent.com/code-yeongyu/oh-my-openagent/refs/heads/dev/docs/guide/installation.md

注意：请使用已发布的包和二进制文件名 oh-my-opencode。在 opencode.json 中，兼容层现在优先使用插件入口 oh-my-openagent，而旧版的 oh-my-opencode 入口仍会加载，但会显示警告。插件配置文件通常仍使用 oh-my-opencode.json 或 oh-my-opencode.jsonc，在过渡期间，旧版和重命名的文件名都会被识别。

---

跳过本 README

我们已经进入了无需阅读文档的时代。只需将以下内容粘贴到你的代理中即可：

阅读这段文字，并告诉我为什么它不只是另一个样板项目：https://raw.githubusercontent.com/code-yeongyu/oh-my-openagent/refs/heads/dev/README.md

亮点

🪄 ultrawork

你真的在看这个吗？太不可思议了。

安装后，输入 ultrawork（或 ulw）即可。搞定。

下面的所有功能、优化，你都不需要了解——它就是能用。

即使只订阅以下服务，ultrawork 也能很好地运行（本项目与这些服务无关，仅为个人推荐）：

• ChatGPT 订阅（$20）
• Kimi Code 订阅（$0.99，仅限本月）
• GLM 编码计划（$10）
• 如果你符合按令牌付费的条件，使用 Kimi 和 Gemini 模型的成本也不会很高。

	特性	作用
🤖	纪律型代理	西西弗斯协调赫菲斯托斯、奥拉克尔、图书管理员、探索者。相当于一个完整的 AI 开发团队并行工作。
⚡	ultrawork / ulw	一个词。所有代理都会自动激活，直到任务完成才会停止。
🚪	IntentGate	在分类或执行之前分析用户的真实意图。不再出现字面意义上的误解。
🔗	哈希锚定编辑工具	LINE#ID 内容哈希验证每一次更改。杜绝过时代码错误。灵感来自 oh-my-pi。Harness 问题 →
🛠️	LSP + AST-Grep	工作区重命名、预构建诊断、AST 感知的代码重写。为代理提供 IDE 级别的精确度。
🧠	后台代理	同时启动 5 个以上的专家代理。上下文保持精简，结果会在准备好时返回。
📚	内置 MCP	Exa（网页搜索）、Context7（官方文档）、Grep.app（GitHub 搜索）。始终可用。
🔁	Ralph 循环 / /ulw-loop	自引用循环。直到 100% 完成才会停止。
✅	待办事项强制执行器	代理闲置？系统会将其重新唤醒。你的任务一定会完成，就这么简单。
💬	注释检查器	注释中没有 AI 生成的垃圾代码。代码读起来就像资深开发者写的那样。
🖥️	Tmux 集成	完整的交互式终端。REPL、调试器、TUI 界面，全部实时可用。
🔌	Claude Code 兼容	你的钩子、命令、技能、MCP 和插件？在这里都能正常工作。
🎯	技能嵌入式 MCP	每个技能都自带自己的 MCP 服务器。不会导致上下文膨胀。
📋	Prometheus 规划器	在任何执行之前，以访谈模式进行战略规划。
🔍	/init-deep	自动在整个项目中生成分层的 AGENTS.md 文件。这既有助于提高令牌效率，也能提升代理的性能

纪律型智能体

西西弗斯（claude-opus-4-6 / kimi-k2.5 / glm-5）是你的主要协调者。他负责规划、委派给专业智能体，并以积极的并行执行推动任务完成，绝不半途而废。

赫菲斯托斯（gpt-5.4）是你的自主深度工作者。只需给他一个目标，而非具体步骤。他会自行探索代码库、研究模式，并端到端地执行任务，无需人工干预。真正的匠人。

普罗米修斯（claude-opus-4-6 / kimi-k2.5 / glm-5）是你的战略规划师。在“访谈模式”下，他会提问、明确范围，并在动笔写一行代码之前制定详细的计划。

每个智能体都根据其模型的独特优势进行调优。无需手动切换模型。了解更多 →

Anthropic 因为我们而封禁了 OpenCode。这就是为什么赫菲斯托斯被称为“真正的匠人”。这种讽刺正是我们有意为之。

我们在 Opus 上表现最佳，但 Kimi K2.5 + GPT-5.4 已经超越了原版 Claude Code，且无需任何配置。

智能体编排

当西西弗斯将任务委派给子智能体时，他并不会选择特定的模型，而是选择一个类别。该类别会自动映射到合适的模型：

类别	用途
visual-engineering	前端、UI/UX、设计
deep	自主研究与执行
quick	单文件修改、拼写错误
ultrabrain	复杂逻辑、架构决策

智能体指定工作类型，框架则自动选择合适的模型。ultrabrain 默认路由至 GPT-5.4 xhigh。你无需做任何操作。

Claude Code 兼容性

你已经完成了 Claude Code 的配置，做得很好。

这里的每一个钩子、命令、技能、MCP 和插件都保持原样运行。完全兼容，包括插件在内。

为你的智能体配备世界一流工具

LSP、AST-Grep、Tmux 和 MCP 真正实现了集成，而非简单拼凑。

• LSP：lsp_rename、lsp_goto_definition、lsp_find_references、lsp_diagnostics。为每个智能体提供 IDE 级别的精准度
• AST-Grep：跨 25 种语言的模式感知代码搜索与重写
• Tmux：完整的交互式终端。REPL、调试器、TUI 应用程序。你的智能体可以持续保持会话状态
• MCP：网络搜索、官方文档、GitHub 代码搜索。全部内置其中

技能嵌入式 MCP

MCP 服务器会消耗你的上下文预算。我们已经解决了这个问题。

每个技能都自带 MCP 服务器。按需启动，作用范围限定于当前任务，任务完成后即被销毁。这样可以保持上下文窗口的整洁。

更好的代码编辑。基于哈希锚定的编辑

编辑工具的问题确实存在。大多数智能体失败的原因并非模型本身，而是编辑工具。

“这些工具都无法为模型提供一个稳定且可验证的标识符，来指明它想要修改的代码行……它们都依赖于模型重新生成它之前见过的内容。而当模型无法做到这一点——这种情况经常发生——用户就会把责任归咎于模型。”

- Can Bölük，《编辑工具问题》

受 oh-my-pi 启发，我们实现了 Hashline。智能体读取的每一行都会附带内容哈希标签：

11#VK| function hello() {
22#XJ|   return "world";
33#MB| }

智能体通过引用这些标签来进行编辑。如果文件自上次读取以来发生了变化，哈希值将不匹配，编辑请求会被拒绝，从而避免代码损坏。无需重现空格，也不会出现过时行错误。

快速掌握代码 1：仅凭更换编辑工具，成功率就从 6.7% 提升至 68.3%。

深度初始化。/init-deep

运行 /init-deep。它会生成分层的 AGENTS.md 文件：

project/
├── AGENTS.md              ← 项目级上下文
├── src/
│   ├── AGENTS.md          ← src 目录级上下文
│   └── components/
│       └── AGENTS.md      ← 组件级上下文

智能体会自动读取相关上下文。无需手动管理。

规划。普罗米修斯

面对复杂任务？不要随意提示并寄希望于运气。

使用 /start-work 调用普罗米修斯。他会像真正的工程师一样与你对话，明确范围和模糊之处，制定经过验证的计划，然后再开始编写代码。智能体在动手之前就知道自己要构建什么。

技能

技能不仅仅是简单的提示。每个技能都包含：

• 针对特定领域的系统指令
• 内置的按需 MCP 服务器
• 作用范围受限的权限。确保智能体不会越界

内置技能：playwright（浏览器自动化）、git-master（原子提交、变基手术）、frontend-ui-ux（以设计为导向的 UI）。

你也可以添加自己的技能：.opencode/skills/*/SKILL.md 或 ~/.config/opencode/skills/*/SKILL.md。

**想了解完整的功能列表吗？**请参阅 功能文档，其中详细介绍了智能体、钩子、工具、MCP 等所有内容。

---

**初次使用 oh-my-opencode？**请阅读 概述，了解你所拥有的功能；或者查看 编排指南，了解智能体如何协作。

卸载

要卸载 oh-my-opencode：

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. 移除配置文件（可选）

   # 移除兼容期内识别的插件配置文件
   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
   
   # 移除项目级配置（如果存在）
   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
   # 插件不应再被加载
   

功能特性

这些功能会让你觉得它们本就该存在。一旦使用，你就再也回不去了。

查看完整的功能文档。

快速概览：

• 代理：西西弗斯（主代理）、普罗米修斯（规划者）、奥拉克尔（架构/调试）、图书管理员（文档/代码搜索）、探索者（快速代码库 grep）、多模态观察者
• 后台代理：像真正的开发团队一样并行运行多个代理
• LSP & AST 工具：重构、重命名、诊断、AST 感知的代码搜索
• 哈希锚定编辑工具：LINE#ID 引用会在应用每次更改之前验证内容。实现精准编辑，零过时行错误
• 上下文注入：自动注入 AGENTS.md、README.md 和条件规则
• Claude Code 兼容性：完整钩子系统、命令、技能、代理和 MCP
• 内置 MCP：网络搜索（Exa）、context7（文档）、grep_app（GitHub 搜索）
• 会话工具：列出、阅读、搜索和分析会话历史
• 生产力功能：拉尔夫循环、待办事项强制执行、注释检查器、思考模式等
• Doctor 命令：内置诊断程序（bunx oh-my-opencode doctor）可验证插件注册、配置、模型和环境
• 模型回退：fallback_models 可以在同一数组中混合普通模型字符串和每个回退的设置对象
• 文件提示：通过代理配置中的 file:// 支持从文件加载提示
• 会话恢复：自动从会话错误、上下文窗口限制和 API 失败中恢复
• 模型设置：代理与模型的匹配已内置于安装指南中

配置

有观点的默认设置，如果你坚持的话也可以调整。

请参阅配置文档。

快速概览：

• 配置位置：兼容层同时识别 oh-my-openagent.json[c] 和旧版 oh-my-opencode.json[c] 插件配置文件。现有安装通常仍使用旧版文件名。
• JSONC 支持：支持注释和尾随逗号
• 代理：可为任何代理覆盖模型、温度、提示和权限
• 内置技能：playwright（浏览器自动化）、git-master（原子提交）
• 西西弗斯代理：主协调器，配备普罗米修斯（规划者）和墨提斯（计划顾问）
• 后台任务：可按提供商/模型配置并发限制
• 类别：领域特定的任务委派（视觉、业务逻辑、自定义）
• 钩子：25+ 个内置钩子，均可通过 disabled_hooks 进行配置
• MCP：内置网络搜索（Exa）、context7（文档）、grep_app（GitHub 搜索）
• LSP：全面支持 LSP，并提供重构工具
• 实验性功能：激进截断、自动恢复等

作者注

想了解哲学理念吗？ 请阅读超工作宣言。

---

我在个人项目上烧掉了 2.4 万美元的 LLM token。试遍了所有工具，把所有东西都调到了极限。最终胜出的是 OpenCode。

我遇到的每一个问题，解决方案都已内置于这个插件中。安装后即可使用。

如果 OpenCode 是 Debian/Arch，那么 OmO 就是 Ubuntu/Omarchy。

深受 AmpCode 和 Claude Code 的影响。许多功能被移植过来，且往往有所改进。我们仍在持续构建中。这就是 OpenCode。

其他框架承诺多模型编排，而我们直接交付。稳定性同样出色，而且功能真正实用。

我是这个项目的最狂热用户：

• 哪个模型的逻辑最敏锐？
• 谁是调试之神？
• 谁写得最好？
• 谁在前端领域占主导地位？
• 谁是后端专家？
• 日常使用哪个模型最快？
• 竞争对手都在推出什么？

这个插件就是精华的提炼。取其精华。如果有改进意见，欢迎提交 PR。

别再为选择框架而纠结了。 我会研究、借鉴最佳方案，并将其整合到这里。

听起来很自负？有更好的办法吗？那就贡献出来吧。我们非常欢迎。

与文中提到的任何项目或模型均无关联，纯属个人实验。

该项目的 99% 都是用 OpenCode 构建的。我其实不太懂 TypeScript。但这份文档是我亲自审阅并大幅改写的。

受到以下专业人士的喜爱：

• Indent
  • 开发 Spray - 影响力营销解决方案、vovushop - 跨境电商平台、vreview - AI 商业评论营销解决方案
• Google
• Microsoft
• ELESTYLE
  • 开发 elepay - 多移动支付网关、OneQR - 用于无现金解决方案的移动应用 SaaS

特别感谢 @junhoyeo 提供的这张精彩海报图片。

oh-my-openagent 快速上手指南

oh-my-openagent（简称 OmO）是一个强大的开源 AI 代理编排工具，旨在打破单一模型的限制，通过协调多个主流模型（如 Claude、Kimi、GLM、GPT 等）来实现高效的自动化开发。其核心特性 ultrawork 可一键激活全套代理团队，自动完成任务直至结束。

环境准备

在开始之前，请确保你的开发环境满足以下要求：

• 操作系统：支持 macOS、Linux 或 Windows (WSL2 推荐)。
• 前置依赖：
  • 已安装 Node.js (建议 v18 或更高版本)。
  • 已安装 Git。
  • 拥有至少一个主流大模型的 API Key 或订阅账号（项目推荐组合：ChatGPT + Kimi + GLM，以获得最佳性价比和效果）。
• 终端环境：建议使用支持 Tmux 的终端模拟器，以获得完整的交互式体验。

提示：本项目不强制绑定特定服务商，支持灵活配置多个模型提供商以实现“编排”而非“锁定”。

安装步骤

你可以通过让现有的 AI 编程助手（如 Cursor、Claude Code、AmpCode 等）自动完成安装，也可以手动执行。

方式一：让 AI 代理自动安装（推荐）

如果你正在使用其他 AI 编程工具，直接复制以下指令发送给它们，它们会自动读取官方文档并完成配置：

Install and configure oh-my-opencode by following the instructions here:
https://raw.githubusercontent.com/code-yeongyu/oh-my-openagent/refs/heads/dev/docs/guide/installation.md

方式二：手动安装

若需手动操作，请先获取安装指南脚本：

curl -s https://raw.githubusercontent.com/code-yeongyu/oh-my-openagent/refs/heads/dev/docs/guide/installation.md

按照文档指引完成二进制文件或 npm 包的安装。

注意：

• 发布的包名和二进制名称为 oh-my-opencode。
• 在 opencode.json 配置文件中，插件入口推荐使用 oh-my-openagent，但为了兼容旧版本，oh-my-opencode 依然有效（会显示警告）。
• 配置文件通常命名为 oh-my-opencode.json 或 oh-my-opencode.jsonc。

基本使用

安装完成后，无需记忆复杂的命令或配置工作流。OmO 的核心设计理念是“极简主义”。

启动全能模式

在终端中进入你的项目目录，只需输入以下命令即可启动全套代理团队：

ultrawork

或者使用简写：

ulw

发生了什么？ 执行该命令后，系统将自动激活包括 Sisyphus（总控）、Hephaestus（构建）、Oracle（分析）、Librarian（文档）和 Explore（探索）在内的多个专业代理。它们将并行工作，直到任务完全完成。

典型工作流示例

假设你需要修复一个复杂的 Bug 或重构模块：

1. 在终端运行 ulw。
2. 输入你的自然语言需求（例如：“重构用户认证模块，增加 OAuth2 支持并修复现有的会话泄露问题”）。
3. 系统会自动分析意图（IntentGate），调用后台多个专家代理并行处理。
4. 代理会自动进行代码搜索、AST 分析、编写代码、运行测试并修复 Lint 警告。
5. 如果代理中途停滞，"Todo Enforcer" 机制会将其唤醒，确保任务不烂尾。
6. 最终输出可用的代码结果。

进阶循环模式

对于需要反复迭代直到完美的大型任务，可以使用 Ralph Loop 模式：

/ulw-loop

此模式下，代理会进入自我参照循环，不断检查和完善结果，直到达到 100% 完成度才停止。

---

注：本工具强调开放市场策略，建议根据实际需求配置不同模型的 API Key（如使用 Kimi 处理长上下文，GLM 处理快速响应，Claude 处理复杂逻辑），以发挥最大效能。