编码代理与终端 · 详细指南 · 验证于 2026-08-31

oh-my-pi：详细版

接入 IDE 的编码 agent（CLI + VS Code 扩展；Claude Code/Codex 类工作流）

← 快速上手（简单版） 所属问题域：编码代理与终端

相关问题：Agent 工具链全家桶能一起装吗？（17 工具 57 对实测兼容清单） ｜ 安装成功但 omp --version 报 SyntaxError（旧版 bun） ｜ 命令混淆：omp install 与 omp plugin install ｜ Windows/ARM release 二进制加载外部扩展失败 ｜ 名称混淆：oh-my-pi（omp）vs pi-mono（pi）

oh-my-pi 详细指南

版本 18.0.7~18.0.7 ｜ 分类 session ｜ 安全（已审查） ｜ 素材：项目官方文档（英文 README）+ 本市场实测（2026-08-28）
配套：站内文档（manifest + guide + 证据）｜ 快速版：站内文档

1. 场景：什么时候会用它

Oh-My-Pi（can1357 出品，MIT，约 2.8 万星）是接入 IDE 的编码 agent：CLI + VS Code 扩展双形态。它的思路和 Claude Code/Codex 类似——在你熟悉的编辑器里直接跑 agent，但多了多模型路由（快/慢/规划模型分工）、子代理并行、浏览器/计算机工具等进阶能力。

一句话：一个可以驻在 IDE 里的、模型可插拔的编码 agent。

这个工具解决什么问题：一个 IDE 原生的编码 Agent（CLI + VS Code 扩展），工作流对标 Claude Code / Codex：在终端或编辑器里给它任务，它读代码、改代码、跑命令、给你结果。

什么时候用：

  • 你要在 IDE/终端里跑一个编码 Agent（非插件形态，独立 CLI）；
  • 你要多项目/多供应商隔离（--profile + --alias）；
  • 你要解包它的内置子代理（agents unpack）扩展能力。

什么时候别用：你已经固定在某个 Agent 插件上、不需要再引一个二进制时；或没有可用 API key（完整编码会话需要）。

注意事项：重档条目——单二进制 183MB；运行即写 ~/.omp/logs/；完整编码会话需 API key（ANTHROPIC_API_KEY 等，本环境未实测）。

2. 能力清单
能力作用
多模型路由--smol（快）/ --slow（慢）/ --plan（规划）/ --prewalk
子代理并行task 工具
IDE 联动VS Code 扩展（官方形态）
Profile 隔离omp --profile <name> --alias <alias>
编码 agent CLI见 Agent 执行版 guide
浏览器/计算机工具见 Agent 执行版 guide

3. 快速安装
note: release 二进制（本环境实测，gh-proxy 加速）；国内 GitHub 直连慢必须加速
# 来源: Trove 详细指南 · 验证于 2026-08-31
curl -sL -o omp https://gh-proxy.com/https://github.com/can1357/oh-my-pi/releases/download/v18.0.7/omp-linux-x64
chmod +x omp
./omp --version

预期输出: omp/18.0.7

第 1 步：确认命令与帮助面

讲解：omp --version 输出 omp/18.0.7、omp --help 能看到完整 flags 与工具清单，说明二进制完整、可执行。

# 来源: Trove 详细指南 · 验证于 2026-08-31
./omp --version
./omp --help

预期输出: omp/18.0.7；完整 flags 与工具清单

卡住怎么办：

  • 版本对不上 → 重新下载（注意 183MB 单文件完整性）；
  • 命令找不到 → 确认路径与 chmod +x。

第 2 步：确认调用链路（需 API key，本环境未实测）

讲解：--print 能拿到模型回复，说明二进制 + provider 链路都通；报缺 key 则是环境变量没配。

# 来源: Trove 详细指南 · 验证于 2026-08-31
omp --print "explain this repo in one sentence" --model gpt-5.2

预期输出: 模型回复（文本模式；本环境无 API key 未实测）

卡住怎么办：

  • 报缺 key → 设置 ANTHROPIC_API_KEY 等环境变量，或 --provider 指定供应商；
  • 想隔离多项目 → 用 --profile work --alias omp-work 创建隔离别名（auth/sessions/settings/caches 分开）。

安装变体
路径命令实测
主路径（实测）curl -sL -o omp https://gh-proxy.com/https://github.com/can1357/oh-my-pi/release…✅ 本市场实测
镜像/代理见快速版与 semi_auto_note；国内安装按 oh-my-pi 指引实测
半自动说明：实测命令 = release 二进制下载（2026-08-28 本环境验证，v18.0.7，gh-proxy 加速；GitHub 直连慢）；单二进制 183MB；运行即写 ~/.omp/logs/（日志 + audit.json，实测）；会话存储 ~/.omp/agent（PI_CODING_AGENT_DIR 可重定位）；完整编码会话需 API key（ANTHROPIC/OPENAI 等，未实测——无 key）；IDE 形态 = VS Code 扩展（官方，未实测）
  • 非 Linux x86_64：官方提供对应平台二进制（本机未实测，命令面一致）；单二进制无运行时依赖。
  • 想全局用：放入 PATH（如 /usr/local/bin，注意 183MB 单文件）。
  • 写面：运行即写 ~/.omp/（logs/agents）；项目形态写项目内 .omp/——专属目录，与常用工具不重叠。
  • 运行时：完整编码会话需要 API key；--print 文本模式适合脚本/管道。

4. 为什么会这样（机制与共享面）

它怎么工作：单二进制 omp（Linux x86_64，gh-proxy 下载）。CLI 面：--model/--provider/--profile/--mode/--print 等 flags + 环境变量面（OMP_PROFILE / PI_CODING_AGENT_DIR）+ 工具清单（read/bash/edit/write/task/browser 等）。非交互单轮用 --print；子代理用 agents unpack 导出；profile 隔离 auth/sessions/settings/caches。

关键概念：

  • --print：非交互单轮输出（文本模式）；
  • agents unpack：导出内置子代理到 ~/.omp/agent/agents；
  • --profile + --alias：多项目/多供应商隔离（如 omp-work 别名）。

装完它动哪里：~/.omp/（logs/agent 等；运行即写）；项目内 .omp/（子代理项目形态）。

实测命令 = release 二进制下载（2026-08-28 本环境验证，v18.0.7，gh-proxy 加速；GitHub 直连慢）；单二进制 183MB；运行即写 ~/.omp/logs/（日志 + audit.json，实测）；会话存储 ~/.omp/agent（PI_CODING_AGENT_DIR 可重定位）；完整编码会话需 API key（ANTHROPIC/OPENAI 等，未实测——无 key）；IDE 形态 = VS Code 扩展（官方，未实测）

5. 常用操作

第 1 步：装二进制（为什么 gh-proxy：国内 GitHub 直连慢）

讲解：单二进制 183MB，下载走 gh-proxy 前缀（国内直连慢）。chmod +x 即用，无运行时依赖。装完 --version 验证。

# 来源: Trove 详细指南 · 验证于 2026-08-31
curl -sL -o omp https://gh-proxy.com/https://github.com/can1357/oh-my-pi/releases/download/v18.0.7/omp-linux-x64
chmod +x omp
./omp --version

预期输出: omp/18.0.7

装好确认：

  • --version 输出 omp/18.0.7；
  • omp --help 能看到完整 flags 与工具清单。

卡住怎么办：

  • 下载慢/失败 → 确认网络到 gh-proxy；换网络重试；
  • 想全局用 → 放入 PATH（如 /usr/local/bin，注意 183MB 单文件）。

第 2 步：非交互单轮（--print，需 API key；本环境未实测——无 key）

讲解：--print 是文本模式单轮调用，适合脚本/管道。需要 API key（--model 指定模型）。

# 来源: Trove 详细指南 · 验证于 2026-08-31
omp --print "explain this repo in one sentence" --model gpt-5.2

预期输出: 模型回复（文本模式）

装好确认：

  • 输出模型回复，无 key 报错。

卡住怎么办：

  • 报缺 key → 设置 ANTHROPIC_API_KEY 等环境变量，或 --provider 指定供应商。

第 3 步：解包子代理 + profile 隔离（按需）

讲解：agents unpack 导出内置子代理（命令来自 --help，未实测）；--profile work --alias omp-work 创建隔离别名（auth/sessions/settings/caches 分开），适合多项目/多供应商。

# 来源: Trove 详细指南 · 验证于 2026-08-31
omp agents unpack

预期输出: 导出内置子代理到 ~/.omp/agent/agents（项目形态用 --project → ./.omp/agents）

# 来源: Trove 详细指南 · 验证于 2026-08-31
omp --profile work --alias omp-work

预期输出: 创建 shell 别名 omp-work（隔离 auth/sessions/settings/caches）

卡住怎么办：

  • agents unpack 报错 → 命令来自 --help（本环境未实测），以官方文档为准；
  • 别名没生效 → 确认 shell 配置文件已加载（新开终端或 source）。

启动与入口

CLI 直接调用；入口 omp --help。

常用操作

操作一：查看命令面（本环境实测）

# 来源: Trove 详细指南 · 验证于 2026-08-31
omp --help

预期输出: USAGE + FLAGS（--model/--provider/--profile/--mode/--print 等）+ 环境变量面（OMP_PROFILE/PI_CODING_AGENT_DIR）+ 工具清单（read/bash/edit/write/task/browser 等）

操作二：非交互单轮（--print，需 API key；本环境未实测——无 key）

# 来源: Trove 详细指南 · 验证于 2026-08-31
omp --print "explain this repo in one sentence" --model gpt-5.2

预期输出: 模型回复（文本模式）

操作三：解包子代理（本环境未实测——命令来自 --help）

# 来源: Trove 详细指南 · 验证于 2026-08-31
omp agents unpack

预期输出: 导出内置子代理到 ~/.omp/agent/agents（项目形态用 --project → ./.omp/agents）

操作四：Profile 隔离（多项目/多供应商切换）

# 来源: Trove 详细指南 · 验证于 2026-08-31
omp --profile work --alias omp-work

预期输出: 创建 shell 别名 omp-work（隔离 auth/sessions/settings/caches）

数据与目录

  • 日志/子代理：~/.omp/（logs/agent/agents；运行即写）；
  • 项目形态：./.omp/agents（--project 时）。

6. 冲突逐条（摘要）

与工具页矩阵同源，共 19 对（1 实测兼容 / 18 推断可能兼容 / 0 推断可能冲突）；完整对子、状态与证据见 冲突对子（共装矩阵）。

7. 排障速查
  • 暂无独立排障手册；安装/卸载问题先看 Agent 执行版 guide 注意事项

8. 卸载与残留检查

 
# 来源: Trove 详细指南 · 验证于 2026-08-31
rm -f /usr/local/bin/omp ~/.local/bin/omp; rm -rf ~/.omp
note: 单二进制删除；~/.omp 专属目录自动删；项目内 .omp/ 按需手动清理
# 来源: Trove 详细指南 · 验证于 2026-08-31
rm -f /usr/local/bin/omp ~/.local/bin/omp
rm -rf ~/.omp
command -v omp >/dev/null 2>&1 && echo '残留: omp 仍存在' || echo 'oh-my-pi removed: OK'

预期输出: oh-my-pi removed: OK

9. FAQ
  • 运行环境预检（Linux x86_64；无运行时依赖）
  • 官方 release 二进制（本环境实测，gh-proxy 加速）；国内 GitHub 直连慢必须加速
  • 每条操作 = 一个命令块 + 预期输出；编码会话需 API key（ANTHROPIC_API_KEY 等）
  • 单二进制删除；~/.omp 专属目录自动删；项目内 .omp/ 按需手动清理
  • 重档条目：183MB 二进制；运行即写 ~/.omp/logs/
  • 问：二进制太大（183MB）？答：单二进制自包含（无运行时依赖）；下载走 gh-proxy 前缀。
  • 问：--print 报缺 key？答：设置 ANTHROPIC_API_KEY 等环境变量，或 --provider 指定供应商。
  • 问：多项目怎么隔离？答：--profile + --alias（如 --profile work --alias omp-work），auth/sessions/settings/caches 分开。
  • 问：使用问题向谁反馈？答：本市场安装/卸载问题走条目反馈入口；项目自身问题请向作者仓库反馈。
  • 版本：[18.0.7, 18.0.7] 锁定（收录实测版本）。
  • 环境：Linux x86_64；无运行时依赖；单二进制 183MB。
  • 网络：GitHub 直连慢，必须 gh-proxy 前缀（实测路径）。
  • 写面：~/.omp/（logs/agents；运行即写）；项目内 .omp/。
  • 运行时：完整编码会话需 API key（ANTHROPIC_API_KEY 等）。
  • 共装：冲突矩阵对子见矩阵页（~/.omp 专属写面，与常用工具不重叠）。

10. 出处
  • 条目签名：can1357/oh-my-pi（MIT，原样收录 v18.0.7 二进制）
  • 实测：实测记录（本地留存）（2026-08-28，release 二进制下载 + version/help 冒烟）。
  • 未实测：完整编码会话（无 API key）；agents unpack 与 profile 别名（命令来自 --help）。

外部教学（来源未实测）

第三方教学未逐条实测，仅供学习；有出入以本页与官方文档为准。

  • 官方 README（codeload tarball v18.0.11，2026-08-31 结构实测）：oh-my-pi 完整用法 [官方文档 · oh-my-pi 官方 · 2026-08-31（tag v18.0.11）]
    官方用法全解——安装（免安装直接跑 / 装进当前 profile / shell 补全 zsh/bash/fish）、核心能力（代码执行与工具调用、LSP 写入、调试器驱动、流式规则、子代理、双模型监督、代码审查带优先级与结论、Hashline 内容哈希编辑）、Windows 原生支持

收录来源（已合并）

本页内容由多篇来源文章按哈希去重、实测验证、AI 重写后合并而来——来源不散落，全部挂在这一个页面上。

暂无已合并来源：本页为本地实测与多来源重写的沉淀；来源与验证细节见站内对应方案页。

← 返回 oh-my-pi 方案页 ｜ 编码代理与终端 问题域