oh-my-openagent

社区

面向复杂代码库的多智能体编码 harness，横跨 OpenCode 与 Codex CLI

分类: 开发工具第 227 / 438
Stars: ★ 70.7k 非常热门
运行环境: Node.js · Bun
凭据: 可选 API Key
许可证: 其他 / 未声明
最近提交: 今天
工具数: 8

52FMRS · D

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

最强项 · 维护活跃度 14/20 最弱项 · 可靠性 7/20

可靠性

7/20

安全与权限

9/20

维护活跃度

14/20

文档质量

13/20

安装易用性

9/20

查看各项评分依据

可靠性 7/20: 未提供服务器清单（manifest标注为'not cached'），README中也未包含任何工具的输入/输出schema、真实调用示例或CI/测试证据，无法验证声明的'5个内置MCP'、'54+生命周期钩子'等功能是否与实际行为一致。项目自带'Doctor Command'诊断和'Session Recovery'描述，但均无可复核的执行证据。983个未关闭issue侧面反映出复杂系统中存在较多故障报告。按静态评审规则，无可验证执行证据时不得超过12分，因证据几乎缺失，评为7分。
安全与权限 9/20: 遥测默认开启（非默认关闭），仅提供事后opt-out开关，收集经SHA256哈希处理的安装标识符并上报PostHog，虽声明未创建用户画像但仍是持续的对外数据流；安装过程会修改全局配置文件（如~/.codex/config.toml、opencode.json）并写入~/.local/bin等位置；Codex Light版本明确提供'autonomous full-permissions mode'选项，一旦启用意味着代理可在较低确认强度下执行操作。README还建议用户粘贴指令让LLM代理直接抓取并'end-to-end'执行远程安装文档，这种模式本身存在被篡改文档实施提示注入的结构性风险。未见证据表明存在恶意代码、凭据窃取或不可逆的危险默认操作，但权限最小化与操作确认机制的披露不完整，故不落入红线区间，评为9分。
维护活跃度 14/20: 项目star数高、有明确ROADMAP、Discord社区、多语言README和活跃的'building in public'运营节奏，表明当前维护活跃、有明确的维护者身份（code-yeongyu/Sisyphus Labs）。但GitHub许可证字段为NOASSERTION，而README徽章显示为非标准的'SUL-1.0'许可证，许可证治理存在不确定性，可能影响使用者的权利边界；同时开放issue数高达983，暗示积压问题较多。综合活跃度较高但治理与许可证存在缺口，评为14分。
文档质量 13/20: 文档体系分层清晰，包含安装指南、功能参考、配置文档、Team Mode指南等多个独立页面，并提供多语言版本，覆盖面广。但通篇营销语气浓厚，具体工具参数、限制条件、错误处理和成本信息披露较薄，例如未给出内置MCP的调用参数表或速率/成本上限说明，故障排查内容也未在提供材料中体现。评为13分。
安装易用性 9/20: 安装路径存在（bunx/npx一键命令），并提供TUI引导，但实际步骤复杂：需在Ultimate/Light版本间选择、完成订阅检测、跨11个agent进行模型匹配、多个provider鉴权、编辑全局配置文件，且官方明确建议'交由LLM代理来安装'以避免人工出错，这本身反映了人工操作路径的脆弱性。缺乏CI或测试证据佐证安装可重复性，按静态评审规则应低于15分上限，结合流程复杂度评为9分。

静态评测 · 未实际运行收录于 2026-08-06

查看 FMRS 评分方法 →

选型与风险

能访问什么读取本地文件写入 / 删除本地文件执行命令或代码访问网络

适合谁

已经在使用 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 包同名，包管理器可能解析到错误的包

安装接入

准备工作

运行环境：Node.js · Bun

其他可选配置项（4 个）

OMO_DISABLE_POSTHOG 可选设为 1 可关闭主插件的匿名遥测上报（默认开启），无需获取任何密钥。

OMO_SEND_ANONYMOUS_TELEMETRY 可选设为 0 可禁用主插件的每日匿名安装统计事件。

OMO_CODEX_DISABLE_POSTHOG 可选设为 1 可关闭 Codex CLI Light 版的匿名遥测上报。

OMO_CODEX_SEND_ANONYMOUS_TELEMETRY 可选设为 0 可禁用 Codex CLI Light 版的每日匿名遥测事件。

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 包同名，可能解析错误。

MCP 配置 · JSON

{"plugin": ["oh-my-openagent"]}

适用于使用 mcpServers 字段的客户端。VS Code 等使用其他字段的客户端，可用下方配置生成器转换。

.vscode/mcp.json

{
  "plugin": [
    "oh-my-openagent"
  ]
}

写入项目的 .vscode/mcp.json（VS Code 使用 servers 字段）。

生成并校验客户端配置

验证是否装好

安装后在 OpenCode 中输入 ultrawork（或 ulw），确认 lsp_diagnostics、team_status 等工具出现在可用工具列表中；也可运行 bunx oh-my-opencode doctor 检查插件注册状态。

常见排障

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

试试这样问

连接成功后，可以直接对 AI 助手这样说：

用 lsp_rename 把函数 handleAuth 重命名为 authenticate，然后运行 lsp_diagnostics 检查有没有报错。
用 lsp_goto_definition 找到 ConfigService 类的定义，再用 lsp_find_references 列出所有引用位置。
启用 Team Mode 后，用 team_create 建一个团队，用 team_task_create 给成员分配重构任务，并用 team_status 查看进度。
用 team_send_message 通知团队成员优先修复 lsp_diagnostics 报出的错误。

工具能力 8

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 只读

查询团队成员及其任务的当前状态。

使用场景

在 OpenCode 中用多智能体（Sisyphus、Hephaestus、Prometheus 等）自主完成复杂编码任务

输入 ultrawork/ulw 让系统自动规划、委派并持续推进任务直到完成

启用 Team Mode 进行 hyperplan（多个对抗性评审智能体挑战方案）或并行安全研究

在 Codex CLI 中使用轻量可移植组件（规则注入、LSP、ast-grep、注释检查）而无需完整的智能体编排

支持客户端

OpenCode

Codex

依据项目文档列出，未经本站实测。

详细介绍

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 工具，帮助智能体在真实代码库上自主完成任务直至收尾。