oh-my-pi 是什么:接上 LSP 和调试器的编程 Agent

oh-my-pi(命令叫 omp)是一个终端编程 Agent,从开源的 Pi 分叉而来,把 LSP、调试器、子 Agent、代码审查都接进了 Agent 的工具箱。MIT 许可,能接 60 多家模型服务商,也能连本机的 Ollama、llama.cpp。11 月 13 日我们对照仓库 README、设置文档和 v18.20.0 发布说明整理了用法和需要注意的默认设置。
它是什么
和 Claude Code、Codex CLI 同一类,是在终端里读代码、改代码、跑命令的 Agent。区别在于它不绑定某一家模型,而且把很多 IDE 才有的能力做成了 Agent 能直接调用的工具。核心约 8 万行 Rust,ripgrep、glob 这类搜索直接编进进程,不再每次另起子进程。
| 仓库 | github.com/can1357/oh-my-pi |
|---|---|
| 作者 | Can Bölük / Stencil Labs;上游为 Mario Zechner 的 Pi |
| 许可证 | MIT(随附第三方代码各自保留原许可) |
| 热度 | GitHub 38,875 星(GitHub API,2026-11-13 14:05 北京时间);npm 上 @oh-my-pi/pi-coding-agent 一周下载 252,492 次(2026-11-05 至 11-11) |
| 运行要求 | macOS、Linux、Windows;用 Bun 安装需 bun ≥ 1.4.4 |
| 最新版本 | v18.20.0(发布于 2026-11-13 07:40,北京时间) |
解决什么问题
编程 Agent 常见的几个毛病:改文件时字符串匹配不上,反复重试;重命名一个模块,别处的导入没跟着改;程序崩了只会到处加 print。omp 给这些场景换了工具:
- hashline 编辑:模型用行内容的哈希做锚点,不用把整行原样再写一遍。文件已经变了,锚点对不上,补丁会被直接拒绝。
- LSP 和调试器:重命名走语言服务器,re-export 和别名导入一起更新;C 程序段错误时挂 lldb,Go 服务卡住时挂 dlv 看 goroutine。
- 子 Agent 和审查:
task把工作拆给多个子 Agent,可以各自在隔离的 worktree 里跑;/review派审查子 Agent 看分支或提交,问题按 P0 到 P3 分级。 - 沿用已有规则文件:直接读 Cursor 的 MDC、Cline 的 .clinerules、Codex 的 AGENTS.md 等 8 种格式,不用转换。
怎么用
macOS 和 Linux 用官方脚本安装,脚本会下载预编译二进制并校验 SHA-256;也可以用 Homebrew 或 Bun:
curl -fsSL https://omp.sh/install | sh
brew install can1357/tap/omp
bun install -g @oh-my-pi/pi-coding-agent
Windows 在 PowerShell 里运行 irm https://omp.sh/install.ps1 | iex。装好后运行 omp setup 选默认模型,然后在项目目录里输入 omp 进入交互界面;只问一句就退出用 omp -p。
想先把审批收紧,在 ~/.omp/agent/config.yml 里写:
tools:
approvalMode: write
approval:
bash: prompt
read: allow
用本机模型的话,在 ~/.omp/agent/models.yml 里声明一个 OpenAI 兼容的服务地址,再用 omp models <名字> 检查能否识别到模型。
核验记录
- 审批默认值:设置文档的参数表里
tools.approvalMode默认是yolo;可选值还有always-ask(只自动放行只读操作)、always-ask-cached、write(放行读和工作区内写入)。单次运行也能用--approval-mode覆盖。文档还提醒,bash 的命令白名单只管审批,不是沙箱,eval里起的 shell 要另设tools.approval.eval。 - 默认关闭的工具:
github、security_scan、生图、语音和记忆类工具都要在设置里手动打开。 - 遥测:OpenTelemetry 导出只有配置了 endpoint 才启动;设置里关掉
telemetry.otlpExportEnabled,或设OTEL_SDK_DISABLED=true,都能彻底不初始化。 - v18.20.0 的变化:新增 Gemini 的
xhigh思考档位,修了~/.aws是文件而不是目录时启动失败的问题。
omp 的工具很全,但默认审批全放行。装完先改审批模式,再让它碰正式仓库。
适合谁,不适合谁
适合:同时用好几家模型、不想被一个厂商的 CLI 绑定的开发者;写 C、Go、Rust 这类经常要上调试器的项目;已经有 Cursor 或 Codex 规则文件、想换个 Agent 试试的人。
不适合:想要开箱即用、配置项越少越好的新手,omp 的设置文档很长;团队要求所有命令先审批的环境,记得一定改掉默认的 yolo。权限这块可以参考站内的 Claude Code 权限自查教程,里面的检查思路也能用在 omp 上。
最后
装好后先跑 omp setup,把审批模式改成 write,再在一个小仓库里让它做一次 /review,看看 P0 到 P3 的分级和你自己的判断差多少。