oh-my-pi 的定位很直接,把编码 Agent 接进 IDE。它自称 a coding agent with the IDE wired in,跟普通 harness 的区别就一句话:LSP 写进每一次编辑,调试器是真的在驱动。别的 Agent 还在靠撒 print 排障。这两条就把它和一众"会写代码的 Agent"拉开了。
我先给判断,再讲我怎么装的。这套东西值不值得装,看你要不要给 Agent 接 LSP 和真调试器。要,就值得折腾。只想读读文件、改改代码,Cline、Codex 已经够用。别为这个折腾环境。
我这次是两条安装路都试了,一条卡、一条起不来,最后再回头读它的机制。下面按这个顺序写。
两条安装路,一条卡、一条缺 bun
两条路我都试了,命令长这样。
# 官方二进制安装器(默认从 build.stencil.so 拉预编译二进制)
curl -fsSL omp.sh/install | sh
# npm 装 SDK(锁版本,避开追新)
npm install @oh-my-pi/pi-coding-agent@18.22.2
第一条路是官方二进制安装器,curl -fsSL omp.sh/install | sh。这个脚本默认从 build.stencil.so 拉预编译二进制,校验 sha256 后装到 ~/.local/bin。我跑了 5 分 45 秒,没吐一个字,卡在下载那一步。本机到 build.stencil.so 这条链路不通。
第二条路是 npm 装 SDK。包名 @oh-my-pi/pi-coding-agent,我锁到 18.22.2,装了 64 个依赖、3 分钟装完。装完 node_modules/.bin/omp 是有的。可我一跑 omp --version,它回了一行 env: bun: No such file or directory。我先愣了一下,然后打开 bin 脚本查原因。
我把 bin 脚本打开核了 1 遍。这个 npm 包里的 omp 不是 Node 可执行文件,是 Bun 编译产物,shebang 写的是 #!/usr/bin/env bun。版本号 18.22.2 和 bun >= 1.4.4 就嵌在压缩代码里。README 其实写清楚了,bun 至少 1.4.4 是硬要求,我第一遍没当回事。
这个教训要记住。oh-my-pi 表面是 TypeScript 加 Rust,运行时却绑死 Bun。你机器上没有 bun,npm 装完也起不来。得先装 bun,或者走 brew、nix 那条路。
LSP 写进每次编辑
装不上归装不上,值不值得用还得看机制。我把 README 打开读了一遍,核心就三样。
第一样是 LSP 接进每次写。你让它 rename,它真走 rename,调用会过 workspace/willRenameFiles,所以 re-export、barrel 文件、alias import 在文件移动之前就一起更新了。IDE 知道什么,Agent 就知道什么。这是它跟别的 Agent 最本质的差距,不是加个 MCP 桥能补的。
我特意把这条跟别的编码 Agent 比了一下。大多数 Agent 的 rename 是"删旧行、加新行"的文本替换,碰到 barrel 重导出就漏。oh-my-pi 走的是 LSP 的语义重命名。这一步它比同行强。这不是我猜的,是我打开 README 核了 1 遍,它明写 willRenameFiles 这个调用的意图。
驱动真调试器,而不是撒 print
第二样是驱动真调试器。C 程序段错误,它 attach lldb 单步到坏指针、读栈帧。Go 服务卡住,它 attach dlv 走一遍 goroutine。Python 进程卡死,上 debugpy 暂停、检查、求值。别的 Agent 还在往代码里塞 print。这一条最实,因为它接的是 DAP。我把它的 DAP 支持打开核了 1 遍,14 个 lsp 操作、28 个 dap 操作是官方标的数。
我把这条单独拎出来讲,因为它最难糊弄。真调试器要能下断点、读变量、看调用栈,这不是改改提示词能补的。你让 Agent 自己去 attach lldb,它得知道断点下在哪、怎么读寄存器。oh-my-pi 把这条做成了内置能力。
in-process 的 ripgrep 和 bash
第三样是性能。别的 harness 靠 shell 出去调 rg、grep、find,每次调用都是一次 fork-exec。它把这些编译进进程,ripgrep、glob、find 全 in-process,bash 是它自己的 5.3 引擎,还塞了 58 个 coreutils,ls、sed、sort、jq 都在里面。README 标的 core 有约 8 万行 Rust,我把它的 crate 清单抓出来数了 1 遍,六个 crate 里 omp-shell 一个就 3.8 万行。
有几个独特点我想单独说。一个是 time-traveling stream rules,规则平时休眠,模型一旦跑偏,正则命中就中断流、注入规则再重试,不用每轮都付上下文税。另一个是 hashline edit,模型指向内容哈希当锚点,不再整行重打,官方标 Grok 4 Fast 输出 token 少花 61%。这两个数字我照官方标的写,没亲自压测。别当成我的结论。
它还有 16 个内部 scheme,pr://、agent://、skill:// 这种。read 一条路径既能读文件也能读 PR,子 Agent 的输出按路径取字段。60 多个 provider,31 个内置工具,前端接口、coding plan、本地 vLLM、Ollama 都能接。
最小配置
最小配置长这样。自定义一个 OpenAI 兼容的 provider,写进 ~/.omp/agent/config.yml,配 modelRoles.default 指过去,再跑 omp setup 选默认模型就行。
modelRoles:
default: spark/minimax-m3
上面这段配置就是 README 给的形态,我照着自写了一遍。自定义 provider 还要在 models.yml 里声明,baseUrl 指到你的本地推理服务,api 选 openai-completions,本地起的 vLLM 或者 Ollama 都这么接。
providers:
spark:
baseUrl: http://127.0.0.1:8000/v1
api: openai-completions
apiKey: dummy
models:
- id: minimax-m3
contextWindow: 100000
maxTokens: 32000
我自己这台机器最后没跑起完整 agent,因为缺 bun 加缺模型 key。但机制和配置我都核过了,缺什么我也说清楚了,没编"我跑通了"。谁也别全信,装不装你按自己的机器判断。
值不值得装,我给个判断。你要给 Agent 接 LSP、接真调试器,或者实在烦每次 fork-exec 的开销,它值得折腾。代价是 bun 这个硬依赖,还有那条会卡的二进制下载。只是想找个能写码的 Agent,先用现成的。
回头把这次实测捋一遍。我跑了 1 遍官方安装器,卡了 5 分 45 秒;装了 1 遍 npm 包,64 个依赖、3 分钟;跑了 1 遍 omp --version,报的就是那句 env: bun;打开了 1 遍 bin 脚本,看到嵌在里面的 bun>=1.4.4;照 README 自写了 1 份 config。五步里真正卡住的是二进制下载和缺 bun 这两处,其余都能核实。这些是我这台机器的真实记录,你机器上有 bun 也许就一路顺。
一句话。oh-my-pi 卖的不是"能写代码",是"IDE 里那套能力 Agent 也有了"。卖点成立,门槛在安装。