Oh My Pi(@oh-my-pi/pi-coding-agent)

Stencil Labs(can1357)基于 Pi 分叉的高配发行版(omp):内置 ~8 万行 Rust 核心、31 个工具、14 个 LSP 操作与 28 个 DAP 调试操作。

安装命令
bun install -g @oh-my-pi/pi-coding-agent
临时试用 / 替代安装命令
curl -fsSL https://omp.sh/install | sh
挂接事件钩子与注册入口
内置 Rust 原生核心(约 8 万行代码,支撑极速工具与编译执行)内建 31 个工具、14 种 LSP 操作与 28 种 DAP 调试器操作保留扩展加载兼容层(可作为 OMP plugin 安装部分标准 Pi 扩展,如 @plannotator/pi-extension)
CLI 入口 ompomp plugin install / upgrade / uninstall内置三种互斥记忆后端:off / local / hindsight

1. 是什么

Oh My Pi(简称 OMP,npm 包名 @oh-my-pi/pi-coding-agent)是从 Pi 分叉演进出的“开箱即用重装发行版”,命令行入口为 omp。

说明:npm 上另有同名社区包 oh-my-pi(acidsugarx/oh-my-pi,v0.2.0),后者是一个轻量多代理扩展;而社区常说的“内置 IDE 能力的 OMP 发行版”对应 @oh-my-pi/pi-coding-agent。

2. 解决什么问题

原版 Pi 刻意坚持极简核心(仅 4 个核心工具),把搜索、LSP、调试、MCP、记忆全部留给用户自己选扩展拼装。

很多重度终端开发者希望直接拿到开箱自带全套 IDE 能力、且仍保留高度底层可控性的编码终端,省去维护十几个第三方插件之间兼容性与配置的精力。

3. 作用原理(事件钩子与工具注册层)

在源码层对 Pi 进行深度二次开发,以 Bun + TypeScript + Rust 混合架构把 IDE 工具面、记忆后端与多模型角色直接编进运行时主循环。

  • 底层由约 8 万行 Rust 核心与 TypeScript 运行时配合 Bun 驱动,直接接入 60+ 模型供应商并把 LSP 诊断、DAP 断点调试(lldb / dlv / debugpy)和持久化 Python/Bun 内核写进内建工具集。
  • 内置嵌入式 Shell 可视化(默认 Python 风格的 Pseudo 视图或切换 Raw 原命令视图)以及带时间轴回放的命令检查器。
  • 记忆系统通过 memory.backend 直接切换关闭、本地摘要管线(写入 memory_summary.md)或 Hindsight 服务(支持 retain / recall / reflect),且支持运行中热切换即时替换工具与提示注入。

4. 怎么装与基本配置

  • 官方推荐通过一键脚本(macOS/Linux)、Homebrew(brew install can1357/tap/omp)、Bun 全局安装(bun install -g @oh-my-pi/pi-coding-agent)或 Nix flake 安装,也可安装 Windows PowerShell 版本。
  • 安装后直接运行 omp 启动;配置文件位于 ~/.omp/config.yml。

5. 和同类怎么选

选原版 Pi + 自选扩展,还是直接切到 Oh My Pi(omp),主要取决于看重“按需组装的轻便度”还是“开箱即用的集成度”。

与同类方案的选型对照

聚焦机制差异与适用边界,结合自身运行环境判断是否引入或保留同类替代包。

对比对象 机制差异 怎么选
@earendil-works/pi-coding-agent(原版 Pi) 极简 4 工具内核,功能全靠按需加载扩展拼装,升级和兼容性最透明轻便。 喜欢最小提示词、自己精细决定每一个工具和扩展的人留守原版 Pi;想要原生 Rust 加速 + LSP/DAP 全套开箱即用的人选 Oh My Pi。
gentle-pi gentle-pi 不分叉 Pi 二进制,以组合型 Pi 扩展包的形式捆绑子代理、TDD 与代码审查流程。 不想离开原版 Pi 主体,只想一键装一套有主见的工程工作流套件时选 gentle-pi。

同方向对比包与顺序阅读

@agimon-ai/po-core

AgiFlow Po 多包体系的共享运行时与服务契约层,支撑从终端工具到 Po Web 驾驶舱的模块化扩展套件。

阅读该包机制详评

openclaw

本地常驻的多通道 AI 网关,把 Discord、Slack、Telegram、WhatsApp 等 20+ 聊天平台接到 Pi 等可插拔 Agent 底座上。

阅读该包机制详评

10 二开形态

回到该演进方向总论,查看完整痛点拆解、通用安装注意事项与全部收录清单。

返回方向总论页

看完「Oh My Pi(@oh-my-pi/pi-coding-agent)」后的下一步

可先读已公开的入门实操文章,或点击下方制作中项目表达关注度(不收集邮箱或隐私)

从 Claude Code / Codex 切到 Pi:最小可用配置单与实机演示视频

已上线入门参考: 《Pi 入门笔记》 (比 Codex 更自由,但也更折腾)

出口 1(配置单与实机演示制作中)

Coding Agent 实战交付课:如何可控地把想法做成线上产品

由 kuhung 策划主讲。面向希望把 Coding Agent 用到真实工程与产品交付的开发者,讲清需求拆解、上下文控制、安全边界与上线验证。

出口 2(实战交付课筹备中)