🎯 OpenCode插件系列: oh-my-opencode

Posted on May 3, 2026

类型：全面的 Agent Harness（列表中最全面的）

1. 这是什么插件？

oh-my-opencode（简称：OmO）是一个集成的"agent harness"，它不仅仅是一个普通的插件 - 这是一个完整的包，将 OpenCode 从简单的工具转化为完整专业的工作系统，其中有一个 AI agent 团队并行工作。

这个插件基于一个理念：没有哪个模型在所有事情上都是最好的，所以它针对不同的任务使用不同的模型（Claude Opus、Kimi K2.5、GPT-5.3 Codex、Gemini），每个 agent 专门负责特定的功能。

它提供的 Agents：

  • Sisyphus（主要协调器）— 规划、分配任务，而且不完成任务不会停止。
  • Hephaestus（深度工作者）— 独自处理大型任务，无需逐步解释。
  • Prometheus（规划者）— 在执行前先与你进行面谈并制定计划。
  • Oracle、Librarian、Explore — 分别专注于架构、文档和代码库搜索。

2. 在什么场景下使用？

当你想将 OpenCode 转变为接近 Claude Code 或 Cursor 的完整体验时使用它，具有以下特点：

  • ✅ 后台 Agents — 并行运行 5+ 个 agents，每个都有独立的上下文
  • ✅ LSP + AST-Grep 工具 — 具有 IDE 精确度的重构和重命名
  • ✅ Hash-Anchored 编辑工具 — 精确修改，避免"stale-line errors"
  • ✅ 集成即用的 MCPs：Exa（网络搜索）、Context7（文档）、Grep.app（GitHub 搜索）
  • ✅ Ralph Loop (/ulw-loop) — 自动循环，直到任务 100% 完成
  • ✅ Tmux 集成 — 完整的交互式终端（REPLs、debuggers、TUIs）
  • ✅ Skill-Embedded MCPs — 带有专用 MCP 服务器的 skills
  • ✅ 与 Claude Code 兼容 — 所有 hooks、commands、skills、MCPs、插件都能工作
  • ✅ /init-deep — 为每个文件夹生成分层级的 AGENTS.md 文件

3. 如何使用？

安装（推荐方法）

打开你的任意 AI agent（Claude Code、Cursor 等）并输入：

按照这里的说明安装和配置 oh-my-opencode：
[<https://raw.githubusercontent.com/code-yeongyu/oh-my-opencode/refs/heads/dev/docs/guide/installation.md>](<https://raw.githubusercontent.com/code-yeongyu/oh-my-opencode/refs/heads/dev/docs/guide/installation.md>)

或者手动添加到 ~/.config/opencode/opencode.json：

{
  "$schema": "[<https://opencode.ai/config.json>](<https://opencode.ai/config.json>)",
  "plugin": ["oh-my-opencode"]
}

日常使用

只需一个词：ultrawork（或简称 ulw）。

ulw build a Nuxt 4 dashboard with auth and dark mode

所有的 agents 将并行工作，系统会自动为每个任务选择合适的模型。

额外配置

  • 配置文件：.opencode/oh-my-opencode.jsonc（项目级）或 ~/.config/opencode/oh-my-opencode.jsonc（全局级）
  • 支持 JSONC（注释和尾随逗号）
  • 可以控制模型、权限、hooks 和分类

推荐的订阅（以获得更经济的运行）：

  • ChatGPT Subscription（$20）
  • Kimi Code Subscription（$0.99）
  • GLM Coding Plan（$10）

4. 何时使用？

在以下场景使用它：

  • ✅ 处理需要多个 agents 并行工作的大型项目
  • ✅ 对现有代码库进行大量重构（如工作代码库基础层）
  • ✅ 需要接近 Cursor/Claude Code 的完整体验但要求开源
  • ✅ 希望通过将任务分配到更便宜的模型来节省 tokens
  • ✅ 喜欢自动化的 agentic workflow 和 orchestration

不要在以下场景使用：

  • ❌ 处理简单快速的任务（会造成过度设计）
  • ❌ 不想处理多个模型和 agents
  • ❌ 工作简单，只需要一个轻量级插件
  • ❌ 处理小型项目且没有复杂需求

⚠️ 重要注意事项

  1. 与其他插件的冲突：如果与 opencode-supermemory 一起使用，需要禁用其 auto-compact hook。
  2. Conductor 协同：与 opencode-conductor 作为技术负责人配合良好。
  3. 许可证：SUL-1.0（他们自己的许可证）。
  4. 卸载：如果要移除，需要从配置文件和相关配置文件中删除。

🔗 有用的链接