oh-my-pi：集成IDE的终端AI Coding Agent

2026-05-20 约 3139 字预计阅读 8 分钟

项目概览

oh-my-pi（简称 omp）是终端AI Coding Agent领域的强力竞争者，将IDE完整能力直接接入Agent。与其他Agent不同，它不是简单包装bash，而是内嵌了真实的编程工具链：LSP代码补全、真实调试器（DAP）、多语言执行内核。

核心数据：

GitHub Stars：5,187（今日增长显著，开源仅4个月）
语言：TypeScript + Rust（~27k行Rust核心）
运行时：Bun（推荐）、Node.js
平台：macOS · Linux · Windows
开源协议：MIT
官网：https://omp.sh

为什么值得写：

Hashline编辑让AI修改第一次就成功，减少token消耗（Grok 4 Fast节省61%输出token）
内置真实调试器（DAP），支持lldb/dlv/debugpy
子Agent系统支持任务并行和类型化结果返回
继承Cursor MDC、Cline rules、Copilot AGENTS.md等8种格式，零迁移成本

核心特性详解

01 · Hashline编辑：第一次就做对

传统的diff编辑依赖行号/行内容作为锚点，模型容易找错位置导致编辑失败。omp使用内容哈希锚点定位编辑位置，模型只描述"改哪里"而不重复"写什么"，token消耗大幅降低。

# 模型输出
edit "formatBytes" in src/utils.ts
# omp内部转换为hashline patch，精确匹配内容位置

效果： Grok 4 Fast相同工作节省61%输出token；编辑一次通过率大幅提升。

02 · LSP完整集成：IDE知道什么，Agent就知道什么

通过 workspace/willRenameFiles，重命名操作自动更新所有引用（重导出 barrel 文件、别名导入）。Agent调用的是IDE的LSP服务，不是自己的模拟。

# LSP rename示例
LSP rename formatBytes → formatFileSize
# 自动更新 format.ts、report.ts、cli.ts 中的所有引用

03 · 真实调试器支持

omp通过DAP（Debug Adapter Protocol）驱动真实的调试器：

lldb：C/C++/Rust原生二进制调试
dlv：Go服务goroutine栈追踪
debugpy：暂停Python进程、inspect变量、evaluate表达式

大多数Agent还在用print调试，omp已经可以直接attach到进程。

04 · 时间旅行式流规则（TTSR）

规则文件平时静默，模型偏离预期时触发：正则匹配中止输出、注入规则到system reminder、从同一点重试。注入在context压缩后依然存活，修复持久有效。

# 模型即将写 Box::leak
→ 规则触发："Don't reach for Box::leak in production"
→ 模型改用 Arc<str>，询问用户确认

05 · 子Agent并行任务

task 将工作分配给隔离的worker，每个worker拥有独立工具表面，最终yield是schema校验的对象，父Agent直接读取字段，无需解析prose。

task {
  agents: ["ComponentsExports", "RoutesExports"],
  constraints: "IRC DM between peers"
}
→ 子Agent并发执行
→ 结果: { exports: [...], coordination_note: "..." }

06 · 浏览器与Electron应用控制

Stealth模式默认开启，页面看到正常用户而非headless bot。同一个API驱动任意Electron应用（Slack、Notion、Figma）。

07 · 跨格式继承

omp直接读取8种已存在的Agent规则格式，无需转换：

Cursor MDC
Cline .clinerules
Codex AGENTS.md
Copilot applyTo
等

08 · 原子提交与冲突解决

omp commit 通过 git-overview、git-file-diff、git-hunk 读取工作树，将无关变更拆分为原子提交，循环依赖在写入前拒绝。合并冲突每个对应一个URL，写 @theirs / @ours / @base 到 conflict://N 即可解决。

快速开始

安装（macOS / Linux）

curl -fsSL https://omp.sh/install | sh

Bun（推荐）

bun install -g @oh-my-pi/pi-coding-agent

Windows

irm https://omp.sh/install.ps1 | iex

mise 版本管理

mise use -g github:can1357/oh-my-pi

内置工具一览（32个）

文件与搜索：

工具	说明
`read`	文件、目录、归档、SQLite、PDF、笔记本、URL、内部scheme
`write`	创建/覆盖文件、归档条目、SQLite行
`edit`	hashline补丁，含内容哈希锚点和陈旧锚点恢复
`ast_edit`	结构重写，预览后应用（via ast-grep）
`ast_grep`	50+ tree-sitter语法的结构代码查询
`search`	文件/glob/内部URL的正则搜索
`find`	glob路径查找

运行时：

工具	说明
`bash`	workspace shell，支持可选PTY和后台任务调度
`eval`	持久Python和JavaScript单元格，共享prelude和工具重入

内部scheme（透明解析）：

scheme	说明
`pr://`	读取PR信息
`issue://`	读取Issue
`agent://`	子Agent结果
`skill://`	技能文档
`rule://`	规则文件
`conflict://N`	合并冲突解决

模型性能对比

omp的编辑格式针对不同模型做了优化调整：

模型	效果
Grok Code Fast 1	编辑通过率从6.7%→68.3%（格式优化）
Gemini 3 Flash	超过str_replace格式，超越Google自己的最佳尝试
Grok 4 Fast	输出token减少61%（hashline去除了retry循环）
MiniMax	通过率提升2.1倍（同权重、同prompt）

ACP：编辑器驱动的Agent

在Zed编辑器中运行omp，获得与终端相同的Agent体验：读取你实际查看的buffer，通过编辑器save路径写入，在编辑器terminal中spawn shell。危险工具暂停等待确认，一次回答即可。无桥接层、无插件、无需要同步的第二大脑。

适用场景

需要高精度编辑（hashline确保第一次成功）
跨平台开发（macOS/Linux/Windows同一二进制）
需要真实调试能力（lldb/dlv/debugpy）
已有Cursor/Cline/Codex规则，想平滑迁移
子Agent并行处理复杂任务

总结

oh-my-pi将终端AI Coding Agent提升到新高度：不是简单调用bash，而是将IDE完整集成，让Agent真正理解代码结构。Rust核心（约27k行）保证了性能，TypeScript生态保证了可扩展性。

核心价值：

Hashline编辑让AI第一次就做对，节省token提高效率
LSP + DAP完整集成，真实调试能力而非print大法
子Agent并行 + 类型化结果，复杂任务分解简单
8种格式继承，零迁移成本

参考链接：

GitHub：https://github.com/can1357/oh-my-pi
官网：https://omp.sh
安装脚本：https://omp.sh/install

更新于 2026-05-23

AI Coding, Terminal, LSP, Debugger, TypeScript, Rust

返回 | 主页

下一步

如果这篇内容对你有帮助，继续往更完整的路径里走。

你可以从专题页继续系统阅读，也可以通过联系页反馈想跟进的主题、工具和合作方向。

AI Agent 专题 Coding Agent 专题开源 AI 工具联系

目录