← 返回目录
O

oh-my-openagent

社区
面向复杂代码库的多智能体编码 harness,横跨 OpenCode 与 Codex CLI
GitHub 源仓库 ↗
★ 67.3k Stars 分类 · 开发工具 非常热门
52FMRS · D
可靠性
7/20
安全与权限
9/20
维护活跃度
14/20
文档质量
13/20
安装易用性
9/20

README 引用了多条社交媒体上的用户好评(如称赞其消灭大量 eslint 警告、替代 Cursor 订阅等),均为项目自行摘录、未经第三方独立核实的第三方证言。README 还提到一条推文称 Anthropic 因该项目而屏蔽了 OpenCode,这是作者陈述的说法,来源为链接的第三方推文,本资料未对此说法做独立验证。

查看 FMRS 评分方法 →

oh-my-openagent(也称 omo/lazycodex)是一个第三方社区维护的编码智能体 harness,分为 Ultimate 版(面向 OpenCode,含 11 个智能体、54+ 生命周期钩子、内置 MCP、Team Mode 等全部功能)与 Light 版(面向 Codex CLI,包含规则注入、注释检查、git-bash、LSP、ultrawork、ulw-loop 等可移植组件)。它编排多个模型(Claude、GPT、Kimi、GLM、Gemini 等),并内置 websearch(Exa)、context7、grep_app 等 MCP 服务器,同时提供 LSP 与 ast-grep 工具,帮助智能体在真实代码库上自主完成任务直至收尾。

工具能力

lsp_rename
通过 LSP 在整个代码库范围内重命名符号。
lsp_goto_definition
通过 LSP 跳转到符号的定义位置。
lsp_find_references
通过 LSP 查找某个符号的所有引用。
lsp_diagnostics
通过 LSP 获取代码的诊断信息(错误/警告)。
team_create
在 Team Mode 下创建一个由主控智能体与多名成员组成的团队会话。
team_send_message
在团队主控与成员智能体之间发送消息。
team_task_create
为团队成员创建具体任务项。
team_status
查询团队成员及其任务的当前状态。

安装接入

Ultimate 版(OpenCode):运行 bunx oh-my-openagent install,通过 TUI 完成订阅检测、11 个智能体的模型选择及各服务商鉴权,安装后插件会写入 opencode.json 的 plugin 数组。Light 版(Codex CLI):运行 npx lazycodex-ai install(非交互推荐用 --no-tui --codex-autonomous),安装程序会写入 ~/.codex/plugins/cache/sisyphuslabs/omo/、本地 Codex marketplace 缓存、~/.codex/config.toml 中的 marketplace/plugin/agent 配置块,并在 ~/.local/bin 放置组件 CLI。也可用 --platform=both 同时安装两个版本。注意不要使用 bunx omo/npx omo,该别名与另一无关的第三方 npm 包同名,可能解析错误。

claude_desktop_config.json
{"plugin": ["oh-my-openagent"]}

选型与风险

适合谁

  • 已经在使用 OpenCode 或 Codex CLI 作为智能体宿主、希望多模型协同编排的开发者
  • 需要自动生成分层 AGENTS.md 与项目规则注入的团队
  • 愿意让智能体拥有较大自主编辑/执行权限以换取速度的用户

不适合谁

  • 希望使用体量小、权限单一的标准 MCP 工具服务器的用户
  • 需要对每次文件修改/命令执行都进行严格人工审核的场景
  • 要求官方厂商支持而非社区维护插件的项目
  • 不使用 OpenCode 或 Codex CLI 作为智能体宿主的用户

所需权限

  • 对项目代码库的读写权限(用于自主编辑代码)
  • 执行 shell/终端命令的权限(tmux 集成、git-bash 组件)
  • 访问互联网以调用内置 MCP(Exa 网页搜索、Context7 文档、grep_app 代码搜索)
  • 各 LLM 服务商的 API 密钥/订阅鉴权(Anthropic、OpenAI、Kimi、GLM、Gemini、Copilot 等)
  • Codex Light 版还需写入 `~/.codex/` 配置、插件缓存目录及 `~/.local/bin`

风险与副作用

  • 智能体拥有较广的自主文件编辑与命令执行权限,ultrawork 模式在判定任务完成前不会停止,可能产生大量未经人工审核的改动
  • Codex Light 版安装程序提供 `--codex-autonomous` 全权限自动模式,会取消命令确认环节
  • 默认启用匿名遥测(基于哈希机器标识,每台机器每日至多一次上报),需手动设置环境变量关闭
  • 为第三方社区项目,README 注明正在进行多 harness 重构,行为可能随版本变化而不稳定
  • 需要配置多个第三方模型服务商的凭证/订阅,攻击面随之增加
  • bin 别名 `omo` 与另一个无关第三方 npm 包同名,包管理器可能解析到错误的包

常见排障

  1. 运行 `bunx oh-my-opencode doctor`(或 oh-my-openagent doctor)检查插件注册、配置、模型与环境变量
  2. 确认 `opencode.json` 的 plugin 数组中存在 `oh-my-openagent` 或旧名 `oh-my-opencode`
  3. 检查配置文件解析顺序:从项目 `.opencode/oh-my-openagent.json[c]` 逐级向上查找至 `$HOME`,就近生效
  4. Codex Light 版:核对 `~/.codex/config.toml` 中的 marketplace/plugin/agent 配置块,并检查 `~/.codex/plugins/cache/sisyphuslabs/omo/` 是否存在
  5. 切勿使用 `bunx omo`/`npx omo`,应使用 `oh-my-openagent`、`oh-my-opencode` 或 `lazycodex-ai`
  6. 若 Team Mode 的 team_* 工具未出现,确认 `team_mode.enabled` 已设为 true 并重启 opencode

使用场景

在 OpenCode 中用多智能体(Sisyphus、Hephaestus、Prometheus 等)自主完成复杂编码任务
输入 ultrawork/ulw 让系统自动规划、委派并持续推进任务直到完成
启用 Team Mode 进行 hyperplan(多个对抗性评审智能体挑战方案)或并行安全研究
在 Codex CLI 中使用轻量可移植组件(规则注入、LSP、ast-grep、注释检查)而无需完整的智能体编排

支持客户端

OpenCode完整支持
Codex CLI完整支持