oh-my-openagent

v4.0.0

Published

4 days ago

The Best AI Agent Harness - Batteries-Included OpenCode Plugin with Multi-Model Orchestration, Parallel Background Agents, and Crafted LSP/AST Tools

0High
0Medium
0Low

code-yeongyu

opencode plugin oracle librarian agents ai llm

[!TIP] Building in Public
维护者正在使用 Jobdori 实时开发和维护 oh-my-openagent。Jobdori 是基于 OpenClaw 深度定制的 AI 助手。每个功能开发、每次修复、每次 Issue 分类，都在 Discord 上实时进行。
→ 在 #building-in-public 频道中查看

[!NOTE]
OmO 由上述的 Jobdori 进行维护。认识你专属的 Jobdori — Dori。在此处加入等待名单。

[!TIP] 加入我们！
| | 加入我们的 Discord 社区，与贡献者及其他 oh-my-openagent 用户交流。 | | :-----| :----- | | | 关于 oh-my-openagent 的更新过去发布在我的 X 账号上。因为账号被意外停用，现在由 @justsisyphus 代为发布更新。 | | | 在 GitHub 上关注 @code-yeongyu 获取更多项目信息。 |

这是 oh-my-openagent 运行 Team Mode 的画面。搭配 Kimi K2.6 和 GPT-5.5。

Anthropic 因为我们屏蔽了 OpenCode。 这是真的。 他们想把你锁住。Claude Code 是个漂亮的牢笼，但仍然是牢笼。
你不需要为 2 小时的工作付 200 美元。未来不是选一个赢家，而是把所有赢家编排到一起。模型每个月都在变便宜、变聪明。没有任何一个供应商能够独占。我们是在为那个开放的市场而构建，不是为他们的围墙花园。

English | 한국어 | 日本語 | 简体中文

评价

"因为它，我取消了 Cursor 的订阅。开源社区正在发生令人难以置信的事情。" - Arthur Guiot

"如果人类需要 3 个月完成的事情 Claude Code 需要 7 天，那么 Sisyphus 只需要 1 小时。它会一直工作直到任务完成。它是一个极度自律的智能体。" - B, 量化研究员

"用 Oh My Opencode 一天之内解决了 8000 个 eslint 警告。" - Jacob Ferrari

"我用 Ohmyopencode 和 ralph loop 花了一晚上的时间，把一个 45k 行代码的 tauri 应用转换成了 SaaS Web 应用。从面试模式开始，让它对我提供的提示词进行提问和提出建议。看着它工作很有趣，今早醒来看到网站基本已经跑起来了，太震撼了！" - James Hargis

"用 oh-my-opencode 吧，你绝对回不去了。" - d0t3ch

"我很难准确描述它到底哪里牛逼，但开发体验已经达到完全不同的维度了。" - 苔硯:こけすずり

"这周末我用 open code、oh my opencode 和 supermemory 瞎折腾一个像我的世界/魂系一样的怪物游戏。吃完午饭去散步前，我让它把下蹲动画加进去。[视频]" - MagiMetal

"你们真该把这个合并到核心代码里，然后把他招安了。说真的，这东西实在太牛了。" - Henning Kilset

"如果你们能说服 @yeon_gyu_kim，赶紧招募他。这个人彻底改变了 opencode。" - mysticaltech

"Oh My OpenCode 简直疯了。" - YouTube - Darren Builds AI

Oh My OpenAgent

你同时折腾着 Claude Code、Codex、各种奇奇怪怪的开源模型。配工作流。给 Agent 调 Bug。

这些事我们替你做完了。全部测试过。只留下真正跑得起来的。

装上 oh-my-openagent。敲 ultrawork。就完事了。

安装

给人类看的

复制并粘贴以下提示词到你的 LLM Agent (Claude Code, AmpCode, Cursor 等):

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

或者你也可以直接去读安装指南，但说真的，让 Agent 去干吧。人类配环境总是容易敲错字母。

给 LLM Agent 看的

获取安装指南并照做：

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

注意：已发布的 npm 包名和 CLI 二进制名仍然是 oh-my-opencode（过渡期间同时以 oh-my-openagent 的名字双重发布）。在 opencode.json 中，兼容性层现在优先使用插件入口 oh-my-openagent，而旧的 oh-my-opencode 条目仍会以警告的形式加载。插件配置文件通常仍使用 oh-my-opencode.json 或 oh-my-opencode.jsonc，在过渡期间新旧两种文件名都会被识别。

匿名遥测默认开启，用于统计活跃安装数(DAU/WAU/MAU)。每台机器每个 UTC 日最多发送一次事件,使用哈希化的安装标识符,绝不会使用原始主机名,且不会创建 PostHog person profile。可通过 OMO_SEND_ANONYMOUS_TELEMETRY=0 或 OMO_DISABLE_POSTHOG=1 禁用。详见隐私政策和服务条款。

跳过这个 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

核心亮点

🪄 `ultrawork`

你竟然还在往下读？真有耐心。

安装。输入 ultrawork（或者 ulw）。搞定。

下面的内容、所有特性、所有优化，你全都不需要知道。它就是能跑。

即使只订阅了下面这几个，ultrawork 也能跑得很好（本项目与它们没有任何关联，纯属个人推荐）：

ChatGPT 订阅 ($20)
Kimi Code 订阅 ($19)
GLM Coding 套餐 ($10)
如果你能使用按 token 计费的方式，用 Kimi 和 Gemini 模型花不了多少钱。

自律军团 (Discipline Agents)

Sisyphus (claude-opus-4-7 / kimi-k2.6 / glm-5.1) 是你的主指挥官。他负责制定计划、分配任务给专家团队，并以极其激进的并行策略推动任务直至完成。他从不半途而废。

Hephaestus (gpt-5.4) 是你的自主深度工作者。你只需要给他目标，不要给他具体做法。他会自动探索代码库模式，从头到尾独立执行任务，绝不会中途要你当保姆。名副其实的正牌工匠。

Prometheus (claude-opus-4-7 / kimi-k2.6 / glm-5.1) 是你的战略规划师。他通过访谈模式，在动一行代码之前，先通过提问确定范围并构建详尽的执行计划。

每一个 Agent 都针对其底层模型的特点进行了专门调优。你无需手动来回切换模型。阅读背景设定了解更多 →

Anthropic 因为我们屏蔽了 OpenCode。这就是为什么我们将 Hephaestus 命名为"正牌工匠 (The Legitimate Craftsman)"。这是一个故意的讽刺。
我们在 Opus 上运行得最好，但仅仅使用 Kimi K2.5 + GPT-5.4 就足以碾压原版的 Claude Code。完全不需要配置。

智能体调度机制

当 Sisyphus 把任务分配给子智能体时，他选择的不是具体的模型，而是 类别 (Category)。系统会自动将类别映射到最合适的模型：

智能体只需要说明要做什么类型的工作，框架就会挑选出最合适的模型去干。ultrabrain 现在默认路由到 GPT-5.4 xhigh。你完全不需要操心。

完全兼容 Claude Code

你已经花了大力气调教好了 Claude Code 的配置？太好了。

这里完美兼容所有的 Hook、命令、技能、MCP 以及插件。所有配置直接生效，包括插件系统。

赋予 Agent 世界级的开发工具

LSP、AST-Grep、Tmux、MCP 并不是用胶水勉强糊在一起的，而是真正深度的集成。

LSP: 支持 lsp_rename、lsp_goto_definition、lsp_find_references 和 lsp_diagnostics。给 Agent 提供 IDE 般的精准操作。
AST-Grep: 支持 25 种编程语言，能够理解语法树的模式匹配和代码重写。
Tmux: 真实的交互式终端环境，支持 REPL、调试器以及 TUI 工具。Agent 的进程持久运行。
MCP: 内置 Web 搜索、官方文档直连以及 GitHub 级代码搜索。

技能专属的按需 MCP 服务器

一堆全局 MCP 服务器极其消耗 Context 额度，我们修好了这个问题。

现在每个技能 (Skill) 都带着自己的专属 MCP。只在执行该任务时启动，任务完成即刻销毁。Context 窗口始终清爽。

拒绝瞎改：基于内容哈希的编辑工具 (Hash-Anchored Edits)

Harness 问题是真的。绝大多数所谓的 Agent 故障，其实并不是大模型变笨了，而是他们用的文件编辑工具太烂了。

"目前所有工具都无法为模型提供一种稳定、可验证的行定位标识……它们全都依赖于模型去强行复写一遍自己刚才看到的原文。当模型一旦写错——而且这很常见——用户就会怪罪于大模型太蠢了。"
- Can Bölük, The Harness Problem

受 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              ← 全局级架构与约定
├── src/
│   ├── AGENTS.md          ← src 级规范
│   └── components/
│       └── AGENTS.md      ← 组件级详细说明

Agent 会自动顺藤摸瓜加载对应的 Context，免去了你所有的手动喂喂喂的麻烦。

让 Agent 动手前先过脑子：Prometheus

碰到了硬骨头？千万不要扔个 Prompt 就双手合十祈祷。

输入 /start-work，召唤 Prometheus 出场。他会像一个真实的主管那样去采访你，主动深挖需求、指出模糊地带，并在改动哪怕一行代码之前产出经过严密论证的计划。你的 Agent 终于知道了自己在干嘛。

技能系统 (Skills)

这里的 Skills 绝不只是一段无脑的 Prompt 模板。它们包含了：

面向特定领域的极度调优系统指令。
按需加载的独立 MCP 服务器。
对 Agent 能力边界的强制约束。

默认内置：playwright（极其稳健的浏览器自动化）、git-master（全自动的原子级提交及 rebase 手术）、frontend-ui-ux（设计感拉满的 UI 实现）。

想加你自己的？放进 .opencode/skills/*/SKILL.md 或者 ~/.config/opencode/skills/*/SKILL.md 就行。

想看所有的硬核功能说明吗？ 点击查看 详细特性文档 (Features)，深入了解 Agent 架构、Hook 流水线、核心工具链和所有的内置 MCP 等等。

第一次用 oh-my-openagent？ 阅读 Overview 了解你拥有哪些功能，或查看 Orchestration Guide 了解 Agent 如何协作。

如何卸载

要移除 oh-my-openagent：

从你的 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

清除配置文件（可选）

# 移除兼容期间被识别的插件配置文件
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

确认卸载成功

opencode --version
# 这个时候就应该没有任何关于插件的输出信息了

Features

那种"这个功能本来就该一直存在"的感觉。一用就回不去。

完整内容请见 Features Documentation。

简要概览：

Agents: Sisyphus（主 Agent）、Prometheus（规划师）、Oracle（架构/调试）、Librarian（文档/代码检索）、Explore（快速 grep）、Multimodal Looker
后台 Agents: 像真正的开发团队那样并行跑多个 Agent
LSP & AST 工具: 重构、重命名、诊断、AST 感知的代码检索
基于哈希的编辑工具: LINE#ID 引用在应用每次修改前都会验证内容。外科手术级编辑，零陈旧行错误
上下文注入: 自动注入 AGENTS.md、README.md、条件规则
Claude Code 兼容: 完整的 Hook 系统、命令、技能、Agents、MCP
内置 MCP: websearch（Exa）、context7（文档）、grep_app（GitHub 检索）
会话工具: 列出、读取、搜索、分析会话历史
效率功能: Ralph Loop、Todo Enforcer、Comment Checker、Think Mode 等
Doctor 命令: 内置诊断（bunx oh-my-opencode doctor），验证插件注册、配置、模型和环境
模型回退: fallback_models 可以在同一数组中混合使用普通模型字符串和 per-fallback 对象配置
文件提示词: 通过 file:// 在 Agent 配置中从文件加载提示词
会话恢复: 从会话错误、上下文窗口上限、API 失败中自动恢复
模型设置: Agent 与模型的匹配已内置在安装指南中

配置

我们有自己主见的默认值。如果你真要改，也可以调。

详细内容见 Configuration Documentation。

简要概览：

配置文件位置: 兼容性层同时识别 oh-my-openagent.json[c] 和旧的 oh-my-opencode.json[c] 插件配置文件。现有安装仍大多使用旧文件名。
JSONC 支持: 支持注释和尾逗号
Agents: 可对任意 Agent 覆盖模型、temperature、prompts 和权限
内置技能: playwright（浏览器自动化）、git-master（原子提交）
Sisyphus Agent: 主调度器，搭配 Prometheus（规划师）和 Metis（计划顾问）
后台任务: 按 provider/model 配置并发上限
类别: 按领域的任务委托（visual、business-logic、自定义）
Hooks: 25+ 内置 Hook，都可以通过 disabled_hooks 控制
MCPs: 内置 websearch（Exa）、context7（文档）、grep_app（GitHub 检索）
LSP: 包括重构工具的完整 LSP 支持
Experimental: 激进截断、自动 resume 等

闲聊环节 (Author's Note)

想知道做这个插件的哲学理念吗？ 阅读 Ultrawork Manifesto。

我为了做个人项目，烧掉了整整 $24,000 的 LLM API Token 费用。我把市面上每个宣称好用的代码 Agent 全试了一遍，配置选项被我翻得底朝天。最后我得出了结论，OpenCode 赢了。

我踩过的坑、撞过的南墙，它们的终极解法现在全都被硬编码到了这个插件里。你只需要安装，然后直接用。

如果把 OpenCode 喻为底层的 Debian/Arch，那么 oh-my-openagent 毫无疑问就是开箱即用的 Ubuntu/Omarchy。

本项目受到 AmpCode 和 Claude Code 的深刻启发。我把他们好用的特性全都搬了过来，且在很多地方做了底层强化。它仍在活跃开发中，因为毕竟，这是 OpenCode。

其他调度框架只会给你画饼画一张很酷的 Multi-Agent 大饼。我们把饼烙出来了。不仅能用，而且极其稳定。所有的功能都不是为了炫技，而是真的能把任务干完。

因为我自己就是这个项目最偏执、最神经质的极端用户：

哪个模型在处理变态业务逻辑时最不容易晕？
谁是修 Bug 的神？
谁文笔最好、最不 AI 味？
谁能在前端交互上碾压一切？
后端性能谁来扛？
谁又快又便宜适合打杂？
竞争对手们今天又发了啥牛逼的功能，能抄吗？

这个插件是以上一切的结晶 (Distillation)。直接拿走去用。如果有更好的点子，PR 大门永远敞开。

别再浪费时间去到处对比选哪个框架好了。 我会去市面上调研，把最强的特性全偷过来，然后在这更新。

听起来很自大吗？如果你有更牛逼的实现思路，那就交 PR，热烈欢迎。

郑重声明：本项目与文档中提及的任何框架或大模型供应商均无利益相关，这完完全全就是一次走火入魔的个人硬核实验成果。

本项目 99% 的代码都是直接由 OpenCode 生成的。我本人其实并不懂 TypeScript。但我以人格担保，这个 README 是我亲自审核并且大幅度重写过的。

以下公司的专业开发人员都在用

Indent
- 开发了 Spray（意见领袖营销系统）、vovushop（跨境电商独立站）、vreview（AI 赋能的电商买家秀营销解决方案）。
Google
Microsoft
Vercel
ELESTYLE
- 开发了 elepay（全渠道移动支付网关）、OneQR（专为无现金社会打造的移动 SaaS 生态系统）。

特别感谢 @junhoyeo 为我们设计的令人惊艳的首图（Hero Image）。