Oh My OpenAgent

项目定位#

Oh My OpenAgent 是基于 OpenCode（v1.0.150+）框架的 AI 编码代理插件，本身不是独立 LLM，依赖外部模型 API（Claude、GPT、Gemini、GLM、Kimi、MiniMax 等），旨在作为 Claude Code 等封闭方案的开放替代。

多代理编排体系#

项目构建了 11 个专用代理，每个针对模型特性优化：

• Sisyphus（主编排）：默认使用 claude-opus-4-7 / kimi-k2.5 / glm-5，负责规划与委派
• Hephaestus（自主深度工作者）：默认使用 gpt-5.4，端到端探索执行
• Prometheus（战略规划）：面试模式，编码前生成详细计划
• Oracle（架构/调试）、Librarian（文档/代码搜索）、Explore（快速代码库搜索）、Atlas、Metis、Momus、Multimodal-Looker、Sisyphus-Junior

代理类别路由：visual-engineering（前端/UI/UX）、deep（自主研究+执行）、quick（单文件修改）、ultrabrain（复杂逻辑/架构决策）。

核心创新#

Hash-Anchored Edit Tool (Hashline)#

受 oh-my-pi 启发，每行附带内容哈希标识（如 11#VK| function hello()），编辑时验证哈希防止过期行编辑导致的文件损坏。README 声称将 Grok Code Fast 编辑成功率从 6.7% 提升至 68.3%（待独立验证）。

ultrawork / Ralph Loop#

• ultrawork（或 ulw）：单命令激活所有代理并行执行
• /ulw-loop（Ralph Loop）：自引用循环，任务未 100% 完成不停止

三层 MCP 系统#

1. 内置远程 MCP：Exa（网络搜索）、Context7（官方文档）、Grep.app（GitHub 搜索）
2. 项目级 MCP：通过 .mcp.json 配置
3. Skill-Embedded MCP：技能自带 MCP 服务器，按需启动、任务完成后释放，不占用上下文窗口

IDE 级工具集成#

• LSP：lsp_rename、lsp_goto_definition、lsp_find_references、lsp_diagnostics
• AST-Grep：支持 25 种语言的模式感知代码搜索与重写
• Tmux：全交互式终端集成（REPL、调试器、TUI 应用）
• IntentGate：分类/执行前分析真实用户意图

Claude Code 兼容性#

完全兼容 Claude Code 的 hooks、commands、skills、MCPs、plugins，支持无缝迁移。

/init-deep#

自动生成层级化 AGENTS.md（项目级 → 目录级 → 组件级），代理自动加载相关上下文。

内置 Skills#

• playwright：浏览器自动化
• git-master：原子提交、变基操作
• frontend-ui-ux：设计优先的 UI 开发
• 支持自定义 Skills，放置于 .opencode/skills/*/SKILL.md 或 ~/.config/opencode/skills/*/SKILL.md

架构概要#

以 TypeScript 编写（1,766 源文件，约 377k LOC），使用 Bun 运行时与构建。CLI 框架为 Commander.js，配置校验使用 Zod v4（32 个 schema），MCP 协议使用 @modelcontextprotocol/sdk。提供 11 个预编译平台二进制包（含 AVX2 + baseline 变体），安装后无需额外运行时。

初始化流程：loadPluginConfig() → createManagers()（TmuxSessionManager, BackgroundManager, SkillMcpManager, ConfigHandler）→ createTools()（26 tools）→ createHooks()（52 hooks：Core 43 + Continuation 7 + Skill 2）→ createPluginInterface()（10 个 OpenCode hook 处理器）。

作为 @opencode-ai/plugin 插件运行，通过 6 阶段配置管道（provider → plugin-components → agents → tools → MCPs → commands）注入能力。

安装与使用#

前提条件： 需先安装 OpenCode（v1.0.150+）

推荐安装（通过 LLM Agent）：

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

手动安装： bunx oh-my-opencode install

支持平台： macOS (ARM64, x64)、Linux (x64, ARM64, Alpine/musl)、Windows (x64)

验证： bunx oh-my-opencode doctor

安装后需在 ~/.config/opencode/opencode.json 的 plugin 数组中确认 "oh-my-openagent" 存在。配置文件支持用户级（~/.config/opencode/oh-my-openagent.json[c]）和项目级（.opencode/oh-my-openagent.json[c]），兼容旧名称 oh-my-opencode.json[c]。

外部集成#

• OpenClaw：双向外部集成（Discord/Telegram/webhook/command）
• Jobdori：作者用于实时构建和维护的 AI 助手

规模指标#

5,237+ commits、75 branches、185 tags、19 个功能模块、104 个 barrel index.ts 文件。当前版本 v3.17.4。

许可协议#

SUL-1.0（Sustainable Use License）：允许非商业/个人使用及内部商业用途，禁止收费分发。

待确认信息#

• 独立官网：未发现，文档内嵌于 GitHub 仓库 docs/ 目录
• npm 包发布状态：package.json 中包名为 oh-my-opencode，推断 npm 地址存在但未直接访问验证
• 部分默认模型名称（如 claude-opus-4-7、gpt-5.4）在收集时点可能尚未公开发布，待确认是否为占位或前瞻配置
• README 声称 Anthropic 因本项目屏蔽了 OpenCode，该说法无法在此验证
• Discord 社区链接未直接提供