oh-my-openagent 是什么?

oh-my-openagent(OMO)是一套多模型编码 Agent 编排层。当前官方提供 OpenCode Ultimate 插件、Codex Light 插件和 OmO Native beta 三种版本,把专职 Agent、生命周期 hooks、MCP、Team Mode 与 ultrawork 工作流接到不同宿主上。

⭐ 50,621 Stars 🍴 4,050 Forks TypeScript — 作者: code-yeongyu
来源:github.com/code-yeongyu/oh-my-openagent;https://github.com/code-yeong… 查看 GitHub 仓库 → 📘 使用教程 →

为什么值得关注

数值只用于判断持续需求。官方项目正在从单一 OpenCode 插件扩展为三种版本,并频繁发布 v5 beta,安装入口、包名和命令都在变化,因此准确的版本化教程有现实价值。

来源:github.com/code-yeongyu/oh-my-openagent;https://github.com/code-yeong…

核心功能

三种运行版本

Ultimate 加载到 OpenCode,Light 加载到 Codex CLI,OmO Native beta 则把 OMO 扩展与固定的 senpi 引擎一起交付。

来源:github.com/code-yeongyu/oh-my-openagent/blob/dev/docs/guide/installat…
多 Agent 编排

Ultimate 官方清单包含 11 个 Agent、54 个以上生命周期 hooks、4 个内置 MCP、Team Mode、/goal 和 ultrawork;Light 只携带适合 Codex 插件系统的可移植组件。

来源:github.com/code-yeongyu/oh-my-openagent
可检查的安装与诊断路径

Ultimate 使用交互式安装器;Light 有单独的 npx 安装器和 doctor;Native 的 omo setup 会先只读检测其他 Agent 凭据,再经用户同意导入兼容的 API key。

来源:github.com/code-yeongyu/oh-my-openagent/blob/dev/docs/guide/installat…

技术架构

主仓库用 TypeScript/Bun 维护,并拆出 rules、delegate、MCP、LSP、model、prompts、team、memory、isolation、telemetry、Codex 与 senpi 等工作区包。Ultimate 和 Light 由宿主加载插件;Native 把固定引擎与扩展合并成一个 omo 命令。运行配置统一迁到 ~/.omo/omo.jsonc,并支持项目目录中的 .omo/omo.jsonc;Native 状态放在 ~/.omo/agent。

来源:github.com/code-yeongyu/oh-my-openagent/blob/dev/package.json;https:/…

项目知识图谱

知识图谱:项目核心节点(中心)+ 核心功能(内环六边形)+ 关键技术依赖(外环 chip) Bun(Ultimate 与 Native 推荐)Bun(Ultimate… Node.js/npm(Codex Light 安装器)Node.js/npm(C… OpenCode 或 Codex CLI(插件版本的宿主)OpenCode 或 Co… MCP、LSP、tmux Team ModeMCP、LSP、tmux… 三种运行版本 多 Agent 编排 可检查的安装与诊断路径 oh-my-openagent 项目本体 核心功能 关键依赖

技术栈

语言TypeScript框架Agent harness 插件与独立 senpi 版本
Bun(Ultimate 与 Native 推荐)Node.js/npm(Codex Light 安装器)OpenCode 或 Codex CLI(插件版本的宿主)MCP、LSP、tmux Team Mode
本地 CLI 与配置目录;模型和订阅凭据由所选 provider 与宿主管理
来源:github.com/code-yeongyu/oh-my-openagent;https://github.com/code-yeong…

快速上手

先选版本。OpenCode Ultimate 运行 bunx oh-my-openagent install;Codex Light 运行 npx lazycodex-ai install;独立 Native beta 运行 bun add -g omo-ai@beta,随后执行 omo setup。不要使用 npx omo 或 bunx omo:官方说明 npm 上的 omo 是另一位作者的无关包。安装器会改动宿主配置,运行前应先阅读变更并备份 ~/.config/opencode、~/.codex 或 ~/.omo。
来源:github.com/code-yeongyu/oh-my-openagent/blob/dev/docs/guide/installat…

使用场景

适合需要把规划、检索、实现和复核分给不同 Agent,或希望在 OpenCode、Codex 与独立命令之间复用一套工作流的人。只做一次短任务,或不愿让安装器写入宿主配置时,直接使用宿主自带 Agent 更简单。

来源:github.com/code-yeongyu/oh-my-openagent;https://github.com/anomalyco/…

优势与局限

优势

  • 按宿主拆分 Ultimate、Light 和 Native,选择路径清楚
  • Ultimate 把专职 Agent、hooks、MCP、Team Mode 和 ultrawork 放在同一编排层
  • 官方安装文档详细列出写入位置、卸载、诊断和退化模式

局限

  • v5 当前仍是高频更新的 beta,安装命令和配置迁移可能继续变化
  • Ultimate 和 Light 会写入 OpenCode 或 Codex 配置,自动权限选项需要逐项审查
  • 默认启用匿名遥测但可以关闭
  • 主体代码使用 Sustainable Use License,商业分发前必须核对许可限制
来源:github.com/code-yeongyu/oh-my-openagent/blob/dev/docs/guide/installat…

最新版本

2026-09-23 核对时,GitHub Releases 将 v5.0.0-beta.82(2026-09-22)标为 Latest。该版本在 OpenCode 安装结束时提示 Native 版本入口,并加入 isolation-core 的写时复制任务隔离层。它仍是 beta;安装前应重新查看 release 与完整安装指南。

来源:github.com/code-yeongyu/oh-my-openagent/releases/tag/v5.0.0-beta.82

实测与证据

status: docs_only_official_sources_checked_not_installed  |  checked_at: 2026-09-23  |  environment: 只阅读 code-yeongyu/oh-my-openagent 官方 README、安装指南、package.json、LICENSE 和 GitHub Releases;未执行 bunx、npx 或安装脚本  |  limitations: 没有让安装器改写 OpenCode/Codex 配置,没有登录模型 provider,也没有运行 ultrawork、Team Mode 或 doctor;页面不把项目方功能清单写成本机实测。  |  observed_output: 官方安装指南当前列出 Ultimate、Light、Native 三条独立路径;GitHub Releases 把 v5.0.0-beta.82 标为 Latest,package.json 同样为 5.0.0-beta.82。

来源:github.com/code-yeongyu/oh-my-openagent/blob/dev/docs/guide/installat…

同类项目对比

相比直接使用 OpenCode,OMO 是额外的编排和工作流层。OpenCode 官方默认提供 build、plan 和 general agent;OMO Ultimate 在这个宿主上增加 11 个 Agent、更多 hooks、内置 MCP、Team Mode 与 ultrawork。想要较少配置时先用 OpenCode 自带能力;需要角色分工和多阶段编排时再考虑 OMO。

来源:github.com/anomalyco/opencode/blob/dev/README.md;https://github.com/c…

总结评价

OMO 适合愿意管理宿主、provider、配置迁移和高频 beta 更新的重度 Agent 用户。先选清 Ultimate、Light 或 Native,再审查安装器将写入的目录、权限和遥测设置;如果宿主自带的少量 Agent 已够用,没有必要为了功能数量增加一层编排。

来源:github.com/code-yeongyu/oh-my-openagent/blob/dev/docs/guide/installat…

常见问题

Ultimate、Light 和 OmO Native 应该怎么选?

已经使用 OpenCode,选 Ultimate;主要使用 Codex CLI,选 Light;不想先安装宿主且愿意接受 beta,才选 OmO Native。

可以用 npm install -g oh-my-openagent 安装吗?

官方不支持这样安装插件版。Ultimate 使用 bunx oh-my-openagent install,Light 使用 npx lazycodex-ai install;Native 才是 bun add -g omo-ai@beta。

为什么不能运行 npx omo 或 bunx omo?

官方明确说明 npm 上名为 omo 的包属于另一位作者,与本项目无关;本项目的独立版本包名是 omo-ai,而且当前必须带 @beta。

oh-my-openagent 的匿名遥测能关闭吗?

可以。主插件可在配置中设置 telemetry: false,或使用 OMO_DISABLE_POSTHOG=1、OMO_SEND_ANONYMOUS_TELEMETRY=0;Codex Light 还有对应的 OMO_CODEX_* 变量。

资料与核验范围
本文依据项目公开资料整理。版本、安装命令和功能边界可能随上游更新,请以所列来源和项目当前版本为准。 资料核对时间: 2026-09-23 13:55.

参考材料:README、GitHub API、依赖文件