产品与定位
Oh My Pi(命令名 omp)最初是 Mario Zechner 的 Pi 的一个 fork,但如今已经远超「分支扩展」的范畴:核心是约 8 万行 Rust 的原生实现,由 Stencil Labs, Inc. 公司化运营,拥有独立官网 omp.sh。它 self-describe 为 “A coding agent with the IDE wired in” —— 目标是把 IDE 才有的能力(LSP、调试器、AST 改写)直接变成 Agent 的工具。
如果你的痛点是「Agent 改代码总是改不干净、重命名漏掉 barrel 文件、调试只能靠加 print」,Oh My Pi 针对的正是这些问题。
功能速览
| 功能 | 说明 |
|---|---|
| 9 个模型角色 | default/smol/slow/plan/commit/vision/task/advisor/tiny,按意图路由到不同模型 |
| 60+ 供应商 | 覆盖前沿 API、编码订阅套餐(Cursor、Copilot、Kimi Code、GLM 等)与本地推理 |
| LSP 深度集成 | 14 个 LSP 操作;写入走 workspace/willRenameFiles,重命名会同步 re-export 与别名导入 |
| DAP 真实调试 | 接入 lldb / dlv / debugpy,支持断点、单步、调用栈、变量查看 |
子代理 task | 并行 fan-out 到隔离 worktree,返回 schema 校验的结构化结果;Alt+A 打开 Agent Hub |
| 顾问模型 | 可给 advisor 角色配第二个模型,逐轮审阅主 Agent 的输出并注入提醒或阻断 |
| Hashline 编辑 | 按内容哈希锚点编辑,避免「字符串未找到」与空白字符反复;Grok 4 Fast 输出 token 减少约 61% |
| AST 工具 | ast_edit 结构化改写(先预览再应用)、ast_grep 覆盖 50+ tree-sitter 语法 |
| 记忆系统 | retain/recall/learn,后端可选 local / Hindsight / Mnemopi,默认按项目隔离 |
| MCP 与 ACP | 内置 MCP 客户端;支持 ACP 协议,可在 Zed 中被编辑器驱动 |
| 会话协作 | /collab 生成可分享链接与二维码,支持只读或读写加入 |
| 原生实现 | ripgrep、glob、find、bash(brush)与 58+ 命令行工具全部进程内运行,无 fork/exec;Windows 无需 WSL |
常用命令
| 命令 | 作用 |
|---|---|
omp | 启动交互式 TUI |
omp -p "任务" | 单次执行并退出 |
omp --mode rpc | 以 stdio NDJSON 协议被其他程序驱动 |
omp acp | 以 Agent Client Protocol 接入编辑器 |
omp models <provider> | 验证自定义供应商的模型发现 |
omp commit | 拆分原子提交并生成校验过的提交信息 |
调用与兼容性
# macOS / Linux 安装脚本
curl -fsSL https://omp.sh/install | sh
# Homebrew
brew install can1357/tap/omp
# Bun(官方推荐,需要 bun ≥ 1.3.14)
bun install -g @oh-my-pi/pi-coding-agent
# Windows PowerShell
irm https://omp.sh/install.ps1 | iex
# Nix
nix profile install github:can1357/oh-my-pi
自定义供应商写在 ~/.omp/agent/models.yml,模型角色默认值写在 ~/.omp/agent/config.yml。还支持 fallback 链、路径作用域模型与 API Key 轮询。
版本与更新注意
- 当前版本 v18.2.8(2026-09-21 发布),MIT 许可,仓库约 32,722 stars(截至 2026-09-22)。
- 版本号跨度大(已到 v18),迭代非常快,升级前建议看
packages/coding-agent/CHANGELOG.md。 - 会自动继承磁盘上已有的配置:启动时读取
.claude、.cursor、.windsurf、.gemini、.codex、.cline、.github/copilot、.vscode中的规则、skills 与 MCP 服务器,无需迁移脚本。多人共用机器时注意这一点。 - 默认关闭的能力需显式开启:
github、security_scan、generate_image、tts、checkpoint、rewind及记忆工具(受memory.backend控制)。 - 上游 Pi 的正确地址是
earendil-works/pi(原badlogic/pi-mono),不是pt-act/pi-mono等第三方镜像。 - PR 政策处于试验期:此前需要 vouch 才能提交 PR,目前临时对所有人开放,可能恢复。
选型建议
- 需要「Agent 像 IDE 一样理解代码」→ LSP + DAP 的组合目前同类中少有对手。
- 需要在多模型之间按角色精细分工、控制成本 → 九个模型角色 + fallback 链足够细。
- 需要并行子代理且要求结果结构化 →
task返回 schema 校验对象,省去解析自然语言的麻烦。 - 想要 Pi 的极简哲学但又不想自己造轮子 → 直接用 Oh My Pi,它已经把常用能力补齐。
- 只需要基础编码 Agent、不想要庞大功能面 → Claude Code 或 OpenCode 更轻。