coding-agent-internals

omp (Oh My Pi)

终端 AI Coding Agent — 把 IDE 能力塞进终端

基本信息

项	值
出品方	can1357 (fork 自 Mario Zechner 的 Pi)
GitHub	can1357/oh-my-pi
Stars	17.7K+
语言	Rust (~27K 行) + TypeScript (Bun runtime)
协议	MIT
首次发布	2026 年初
官网	omp.sh

架构（四层）

┌─────────────────────────────────────────────────────┐
│  入口层                                              │
│  TUI / Node SDK / RPC (stdio) / ACP (JSON-RPC)      │
├─────────────────────────────────────────────────────┤
│  Agent Core                                         │
│  会话管理 / 工具调用 / 状态                            │
├─────────────────────────────────────────────────────┤
│  Tool Surface（32 个内置工具）                         │
│  Files & Search | Runtime | Code Intel | Coordination│
├─────────────────────────────────────────────────────┤
│  Rust Native Engine（零 fork）                        │
│  shell / grep / AST / summarize / fs_cache / pty     │
└─────────────────────────────────────────────────────┘
         ↕                          ↕
    40+ Providers            Hindsight Memory

核心差异化

1. Rust 原生引擎（零 fork/exec）

把工具直接编译进进程，不 shell out：

模块	功能	Rust 代码量
shell	内嵌 bash（brush），持久会话	~3,700
grep	正则搜索，并行/顺序模式	~1,900
keys	Kitty keyboard protocol + PHF lookup	~1,490
text	ANSI-aware 宽度、截断、SGR 换行	~1,450
summarize	tree-sitter 结构化源码摘要	~1,040
ast	ast-grep 模式匹配 + 结构化重写	~1,000
fs_cache	mtime 缓存，read/grep/lsp 共享	~840
highlight	语法高亮，11 种语义类别	~470
pty	原生 PTY（sudo/ssh 交互）	~455

同一二进制运行在 macOS / Linux / Windows（无需 WSL）。

2. Hash 锚定编辑（Hashline）

• 用内容 hash 而非行号定位代码
• 文件变化时 hash 失效，拒绝 patch（防止 stale file 覆盖）
• 消除 whitespace 战争
• Grok 4 Fast 实测：节省 61% 输出 token

3. LSP 集成（13 种操作）

rename / diagnostics / navigation / symbols / code actions / raw requests。 通过 workspace/willRenameFiles 联动更新 re-exports、barrel files、aliased imports。

4. DAP 调试器（27 种操作）

支持 lldb / dlv / debugpy。断点、单步、线程、栈检查、变量求值。

• C segfault → attach lldb，step 到 bad pointer
• Go hang → attach dlv，walk goroutines
• Python wedged → debugpy，pause，inspect

5. Time-Traveling Stream Rules

• 规则在模型偏离时才触发
• 正则匹配 → 中断流 → 注入系统提醒 → 从同一点重试
• 注入存活于 compaction，整个会话有效

6. Hindsight Memory

• retain 写入事实，recall 检索
• 会话压缩为 mental model，下次会话首 turn 加载
• 项目级隔离（不同 repo 的记忆不串）

7. 代码审查（/review）

• 专用 reviewer 子代理并行扫描
• 问题按 P0-P3 排序 + 置信度评分
• 支持 branch / commit / uncommitted work

8. 配置继承

直接读取其他工具的配置，无需迁移：

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

32 个内置工具

类别	工具	说明
文件和搜索	read, write, edit, ast_edit, ast_grep, search, find	文件、目录、archive、SQLite、PDF、URL
运行时	bash, eval, recipe, ssh	Shell、Python/JS cells、task runners、远程命令
代码智能	lsp, debug	诊断、导航、rename、DAP 调试
协调	task, irc, todo_write, job, ask	子代理、代理间消息、会话状态
Web	browser, web_search, github, generate_image, inspect_image, render_mermaid	浏览器、GitHub、视觉、图表
记忆和状态	checkpoint, rewind, retain, recall, reflect	会话状态、上下文裁剪、持久记忆
其他	calc, resolve, search_tool_bm25	算术、预览操作、工具发现

40+ 模型提供商

Frontier APIs

Anthropic, OpenAI, Google Gemini, xAI, Mistral, Groq, Cerebras, Fireworks, Together, Hugging Face, NVIDIA, OpenRouter, Perplexity 等。

Coding Plans

Cursor, GitHub Copilot, GitLab Duo, Kimi Code, MiniMax, Alibaba, Qwen, Xiaomi 等（通过 /login 订阅路由）。

Self-Hosted

Ollama, LM Studio, llama.cpp, vLLM, LiteLLM（OpenAI 兼容端点）。

路由控制

机制	说明
自定义 provider	声明任何 OpenAI/Anthropic/Google 协议
Fallback 链	主 provider 429 时自动切到下一个
路径级角色	单个 repo pin 重模型，不影响全局
轮询凭证	每 provider 多个 API key，session affinity 轮转

模型角色

角色	用途	切换
default	常规对话	—
smol	便宜子代理	--smol
slow	深度推理	--slow
plan	规划模式	--plan
commit	changelog	—

入口方式

入口	说明
交互式 TUI	默认终端界面，工具卡片、编辑预览、结构化选项
Node SDK	@oh-my-pi/pi-coding-agent，嵌入 JS/TS 应用
RPC Mode	stdio NDJSON，非 Node 嵌入器
ACP Mode	JSON-RPC，编辑器集成（Zed 等）

安装

# macOS / Linux
curl -fsSL https://omp.sh/install | sh

# Bun（推荐）
bun install -g @oh-my-pi/pi-coding-agent

# Windows (PowerShell)
irm https://omp.sh/install

This site is open source. Improve this page.