oh-my-openagent

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

环境要求

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

安装与启动步骤

1. 1选择安装版本

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

2. 2安装 Senpi 独立版

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

   bun install -g omo-ai@beta

   复制

3. 3接入 OpenCode

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

4. 4接入 Codex CLI

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

5. 5调整配置

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

6. 6验证是否生效

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

   opencode --version

   复制

关键配置

如何确认成功

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

常见问题

注意事项

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