信息卡

一句话定位

omp 自称 "A coding agent with the IDE wired in"：Pi（badlogic/pi-mono）的激进 fork，命令行外壳里塞进了 LSP、真调试器、AST 编辑与持久化代码执行内核，号称 "the most capable agent surface that ships"。

趋势解读：为什么火

当各家 Agent 还在"bash + 文件读写"的工具面上内卷时，oh-my-pi 直接把 IDE 的三大件——语言服务（14 LSP ops）、调试器（28 DAP ops，lldb/dlv/debugpy）、重构（经 `workspace/willRenameFiles` 同步 barrel files）——内置为 agent 工具，让模型第一次能"看见"类型错误与符号引用而非盲改文本。60+ provider、31 个内置工具与约 80k 行 Rust 原生层的堆料配置击中了重度用户；"complete out of the box, open all the way down" 的全开源承诺又接住了被闭源订阅劝退的群体，单月近 8000 星证明"给 Agent 装 IDE"是真实爽点。

核心功能拆解

• 持久化 Python/Bun worker 内核跑代码，可通过 loopback bridge 反向调用 agent 工具。
• Time-traveling stream rules：regex 命中即中止流式输出、注入 system reminder 并重试。
• Subagents `task` 在隔离 git worktree 中 fan-out，返回 schema-validated 对象；`Alt+A` 打开 Agent Hub。
• Advisor 模型：第二个模型旁听每一轮并内联注入 notes。
• Hashline 编辑：content-hash 锚点减少空白冲突，实测 Grok 4 Fast 输出省 61% tokens。
• `/collab` 生成链接/QR 让他人浏览器旁观或 `omp join` 协作，中继看不到 API key。
• 58 个 CLI 工具内置于嵌入式 bash "brush"，零 fork/exec 开销；ripgrep/glob 原生进程内实现。

架构与技术栈浅析

TS 主体 + 约 80k 行 Rust native layer（六个 crates：pi-shell、pi-natives 等），跑在 Bun 上。IDE 集成走 ACP（Agent Client Protocol）over JSON-RPC 可驻留 Zed 等编辑器；写操作统一经 `session/request_permission` 权限门控。monorepo 含 pi-agent-core、pi-tui、hashline 等 17 个包。

安装与环境要求

macOS/Linux/Windows，Bun ≥ 1.3.14：

curl -fsSL https://omp.sh/install | sh        # macOS/Linux
brew install can1357/tap/omp                   # Homebrew
irm https://omp.sh/install.ps1 | iex           # Windows

Nix 用户可 `nix run github:can1357/oh-my-pi`。

快速上手示例

omp            # TUI 交互
omp -p "..."   # one-shot

RPC 模式发送 NDJSON：`{"id":"r1","type":"prompt","message":"list .ts files"}`。SDK 中用 `createAgentSession({ sessionManager, authStorage, modelRegistry })` 后调 `session.prompt()` 即嵌入自有应用。

进阶使用要点

• 十个 model roles（default/smol/slow/plan/advisor/commit/tiny 等）按任务路由不同模型，配 fallbackChains 和多凭证轮转。
• `--tools read,edit,bash` 白名单裁剪工具面；discoverable tools 走 `xd://` 按需发现。
• prose 里写魔法词 `ultrathink`/`orchestrate` 直接触发深度思考或编排模式。
• 兼容继承 Cursor/Cline/Codex 等 8 种既有规则文件格式，迁移成本极低。
• 记忆后端可选 local/Hindsight/Mnemopi 三种实现。

典型应用场景

• 大型 TS 项目安全改名：agent 用 LSP rename 全库同步 re-export，普通 diff 编辑做不到。
• 崩溃调试：debugpy/DAP 断点现场交给 agent 分析，而非贴日志猜。
• 多方案并试：worktree 隔离 subagent 各写一版，Human 主审合并。
• 结对直播/教学：collab 链接共享会话现场。

同类生态位对比

对比 Claude Code / Codex CLI：provider 锁定少、工具面更宽（LSP+DAP），但社区规模尚小；对比 Cursor/Gemini CLI 等闭源 GUI 方案：omp MIT 全开源、"open all the way down"。在"terminal agent 军备竞赛"中它选择做加法之王。

资源导航

安装脚本 omp.sh、上游项目 badlogic/pi-mono、THIRD-PARTY-NOTICES.txt 列出 vendored 组件许可。