oh-my-openagent

让 Codex 和 OpenCode 在大型代码库中省 token 又听话

oh-my-openagent（简称 omo/lazycodex）是一个面向复杂代码库的编码智能体编排框架，专为追求极致 token 效率的开发者设计。它解决了在大型项目中直接使用 Codex、OpenCode 等 AI 编码工具时上下文管理混乱、token 消耗高、多工具协同困难的问题。核心能力包括：统一接入 OpenAI、Anthropic、Gemini 等主流模型，提供 TUI 交互界面，支持 Claude Skills 扩展，并能与 Cursor 等 IDE 深度集成。通过智能上下文压缩和任务编排，它让 AI 代理在复杂代码库中更精准地定位和修改代码，显著降低 token 成本。项目采用 TypeScript 开发，社区活跃，星标超 6.7 万，是当前 AI 编码代理领域的热门基础设施。

开源 unknown 智能体

访问官网 ↗ GitHub ↗ 文档 ↗

GitHub 星标 ★ 69289

维护状态活跃

是否开源是

定价模式 unknown

项目数据

分类智能体

开发团队code-yeongyu

所属国家

官网地址https://omo.dev

GitHubhttps://github.com/code-yeongyu/oh-my-openagent

定价模式unknown

价格说明定价信息待确认

访问状态

是否开源是

开源协议NOASSERTION

主要语言TypeScript

技术栈/模型ai,ai-agents,anthropic,chatgpt,claude,claude-skills,codex,cursor,gemini,ide,openai,opencode,orchestration,tui,typescript

GitHub 星标★ 69289

30天Star增速

HF 下载量

上线时间2025-12-03 00:00:00

最近更新2026-09-22 00:00:00

维护状态活跃

中文支持

访问方式

移动端支持

综合评分

收录时间2026-08-09

浏览次数8

使用教程

难度：进阶约 10 分钟部署方式：命令行工具 6 步

⚠ 该项目 README 未提供完整安装说明，以下步骤为通用流程，请以官方文档为准。

环境要求

已安装 OpenCode（Ultimate 版作为插件加载的宿主）
已安装 Codex CLI（Light 版作为插件加载的宿主）
已安装 Bun，用于 Senpi 版的全局安装
已安装 Node.js/npx，Codex 版通过 npx 调用工具包
存在可编辑的 OpenCode 配置文件 ~/.config/opencode/opencode.json

安装与启动步骤

1选择安装版本

omo 分三个版本：Ultimate 版装进 OpenCode 全功能，Light 版装进 Codex CLI，Senpi 版是独立原生 omo 命令，按需选一个或多个。
2安装 Senpi 独立版

Senpi 版（beta）从 omo-ai@beta 安装，自带 OMO 扩展，提供记忆系统、CodeMode 与 Anthropic 订阅支持。
```
bun install -g omo-ai@beta
```
3接入 OpenCode

Ultimate 版以插件形式加载：编辑 ~/.config/opencode/opencode.json（或 jsonc），在 plugin 数组中写入插件名；README 未给出安装命令，仅从卸载说明可确认该配置项。
4接入 Codex CLI

Light 版会把 Codex agent TOML 安装到 ~/.codex/agents/，并提供规则、comment-checker、git-bash、lsp、ultrawork 等组件；README 只给出卸载命令，未给出安装命令。
5调整配置

运行时配置位于用户级 ~/.omo/omo.jsonc，项目级 .omo/omo.jsonc 会向 $HOME 逐级查找、就近生效；支持 JSONC 注释与尾逗号，旧 oh-my-* 文件会迁移一次。
6验证是否生效

确认插件已被宿主加载：OpenCode 中应能看到 omo 的 agent 与 slash 命令，命令行执行 opencode --version 应正常输出而无插件报错。
```
opencode --version
```

关键配置

配置项	必填	说明	示例
`plugin`	是	OpenCode 配置中声明要加载的插件，加入本插件即完成 Ultimate 版接入	`"oh-my-openagent"`
`配置位置`	否	用户级配置路径，项目级配置会向上查找到 $HOME，就近优先	`~/.omo/omo.jsonc`
`hashline_edit`	否	Ultimate 版的哈希行编辑功能，默认关闭，需显式开启	`true`
`disabled_hooks`	否	禁用指定的生命周期钩子，钩子共 54+（含 Team Mode 为 61 个）	`[]`

如何确认成功

执行 opencode --version 正常输出版本且无插件加载报错；宿主中出现 omo 的 agent、slash 命令与内置 MCP 即为成功。

常见问题

Q：三个版本该怎么选？

A：要全功能选 Ultimate（OpenCode，11 个 agent、54+ hooks、4 个内置 MCP）；已用 Codex CLI 选 Light；想用原生 omo 命令选 Senpi（beta）。

Q：内置 MCP 为什么在 opencode mcp list 里看不到？

A：内置的 websearch、context7、grep_app、lsp 由运行时注入，不会出现在 opencode mcp list 的输出中，属于正常现象。

Q：怎么卸载？

A：OpenCode 版从 opencode.json 的 plugin 数组移除插件项，再删除 ~/.omo/omo.jsonc 等配置；Codex 版执行 npx lazycodex-ai uninstall。

Q：能改模型和并发吗？

A：可以。配置中可为任意 agent 覆盖模型、温度、提示词与权限，也可按 provider/model 设置后台任务并发上限。

注意事项

README 未给出 Ultimate 版和 Light 版的安装命令，本文对应步骤仅依据卸载与配置说明推断，执行前请以官方文档为准。
Senpi 版标注为 beta，功能可能变动，建议先在小项目中试用。
配置支持 JSONC 注释与尾逗号；升级后旧 oh-my-openagent/oh-my-opencode 配置会被迁移一次。

核心亮点

智能上下文压缩，复杂代码库下 token 消耗显著降低
统一编排多模型（OpenAI/Anthropic/Gemini），切换零成本
TUI 界面流畅，支持 Claude Skills 扩展，IDE 集成度高

不足之处

配置复杂度较高，新手需要时间熟悉编排逻辑
文档/社区待观察

适用场景

大型 monorepo 代码库的 AI 辅助重构与 bug 修复
多模型对比测试，寻找 token 性价比最优的编码方案
在终端中高效驱动 AI 代理完成多步骤开发任务

替代项目

OpenCode、Aider、Continue

项目介绍

oh-my-openagent 是编程开发领域的开源项目，由 code-yeongyu 开发，2025 年首次发布。

在全站 13,014 个收录项目中，它的 GitHub 星标数（69,289）位列前 1%，在编程开发分类的 490 个项目里位列前 1%。

近 44 天，它的 GitHub 星标从 67,557 增加到 69,289，净增 1,732。

项目目前处于活跃维护状态，最近一次代码更新于 2026-09-22。从国内网络环境看，可直接访问。

它主要面向的使用场景是：大型monorepo代码库的AI辅助重构与bug修复。同类可对比的替代方案包括 OpenCode、Aider、Continue。

上一篇：caveman

下一篇：muapi-cli