可以随意改造的小内核
Pi 对自己的定义是“一个你可以据为己有的极简、可扩展 Agent 框架”。子 Agent、计划模式和权限弹窗都是有意不做的，所以你运行的就是你自己选择加入的东西。
扩展、Skills、提示模板和主题可以打包成 Pi 包，通过 npm 或 git 分享。
Pi 对比 HagiCode: 功能与差异
HagiCode 是一款提案驱动的 AI 编码工作台，可将需求转化为可审阅的提案，通过 Claude Code、Codex、GitHub Copilot 等 Agent CLI 执行，并把结果沉淀为团队知识。
Pi 是极简的 MIT 许可终端编码 Agent，靠扩展、Skills 和包按需定制。HagiCode 是把 Pi 当作执行器来运行的工作台，在它外面补上会话、提案和提交工具。
简短结论
Pi 是一个在终端里运行的极简、可扩展的编码 Agent 框架。它有意不内置子 Agent、计划模式和权限弹窗，需要什么就通过扩展、Skills 和包自己加。HagiCode 是桌面与 Web 工作台，负责启动 Pi 这类 Agent CLI，并提供围绕它们的工作流：并行会话、规格提案、提交和历史记录。它不会替代 Pi。
如果你喜欢小巧、可改造的 Agent，愿意在它之上搭自己的工作流，只用 Pi 就好。如果你更想用现成的工作台来管理会话、提案和审查，让 Pi 继续负责 Agent 的活，就加上 HagiCode。
Pi 与 HagiCode 一览对比
对比项PiHagiCode
定位
极简的终端 Agent 框架，通过扩展、Skills、提示模板和主题来定制
AI 编程工作台，把各类 Agent CLI（包括 Pi）当作执行器来运行
界面与平台
交互式终端界面、打印/JSON 模式、RPC、TypeScript SDK；提供 macOS、Linux、Windows 安装方式
桌面应用（Windows、macOS、Linux）、Docker Compose 容器版、Microsoft Store 版
价格与许可
MIT 许可，免费；只为接入的模型付费
桌面版和容器版免费；Store 版基础免费，可选一次性购买 TurboEngine
模型与供应商
15+ 家供应商，可用 API Key 或 OAuth 登录；可通过 models.json 或扩展添加自定义供应商
不托管模型；使用 Pi 自己的登录，或配置后走 OmniRoute 路由
并行工作
没有内置子 Agent，需要用扩展或包添加
多个会话并排运行，作为命名 Agent 统一管理
规格与规划流程
默认没有计划模式，可通过扩展补上
OpenSpec 提案：提出、校验、实施、归档
Git 与提交
提交由你或扩展处理；会话可导出为 HTML 或 gist
AI 生成提交信息并锁定仓库；界面内管理 Git
向你提问
扩展可以通过 RPC 打开对话框
在对话中显示 Pi 的提问，回答后继续同一次运行
上手成本
一条安装脚本或 npm 安装，然后 /login
先装好 Pi，再装 HagiCode，然后选择 Pi 作为 Agent CLI
最适合
想要一个小而可改造的 Agent 内核、按自己习惯定制工作流的开发者
在多个仓库里并行跑 Pi 任务，并希望规格、审查和历史集中管理的人
Pi 的强项
以树形保存的会话
一个会话是存放在单个文件里的树。用 /tree 可以回到更早的节点，从那里分叉，另一条分支不会丢。
接近上下文上限时会自动总结较早的消息，压缩逻辑也能通过扩展定制。/export 把会话导出为 HTML，/share 发布为 GitHub gist。
四种驱动方式
可以用交互式终端界面、面向脚本和事件流的打印/JSON 模式、基于 stdin/stdout 的 RPC 协议，或把 Pi 嵌入自己应用的 TypeScript SDK。
这让 Pi 很容易被封装，HagiCode 运行它的方式正是如此。
供应商广泛，用你自己的账号
Pi 列出 15 家以上的供应商，包括 Anthropic、OpenAI、Google、Azure、Bedrock 和 Ollama。用 /login 通过订阅或 API Key 登录，并可通过 models.json 添加自定义供应商。
Pi 没有内置权限系统，以启动它的用户权限运行，所以文档建议需要更强隔离时放进容器。
什么时候选 Pi，什么时候选 HagiCode
这些情况继续用 Pi
- 只用 Pi：你想要一个小的 Agent 内核，并乐于写扩展或 Skills 来适配自己的工作流。
- 只用 Pi：你在终端里工作，任务一次做一个。
- 只用 Pi：你通过 RPC 协议或 SDK，把 Agent 嵌入自己的工具。
- 只用 Pi：你已经有自己的规格、审查和提交习惯，不想再多一套系统。
这些情况选 HagiCode
- 选 HagiCode：你想要并行会话，又不想自己写或安装子 Agent 扩展。
- 选 HagiCode：你希望每次改动都有 Pi 默认没有的提案和归档环节。
- 选 HagiCode：一个 Pi 任务跨多个仓库，你不想每次会话都重新解释，而是一次声明。
- 选 HagiCode：相比终端输出，你更喜欢用图形界面查看会话和工具调用。
- 选 HagiCode：你会在不同 Agent 间切换，想用同一个界面管理 Pi、Claude Code、Codex 等。
把 Pi 和 HagiCode 一起用
HagiCode 不会打包或替换 Pi。它会在你的机器上查找 pi 可执行文件、检测版本，并在每次运行时启动它，所以你的安装、登录和 models.json 都保持原样。
HagiCode 可以通过设置传入 Pi 的供应商、思考等级、会话目录、无会话模式和工具限制。
- 安装 Pi（例如 curl -fsSL https://pi.dev/install.sh | sh，或 npm install -g --ignore-scripts @earendil-works/pi-coding-agent），然后运行 /login。
- 安装适用于 Windows、macOS 或 Linux 的 HagiCode Desktop。
- 在 HagiCode 里把 Pi 选为 Agent CLI，并选择供应商和模型。
- 打开一个仓库，开始会话或提案。
- Pi 的输出会以流式显示在对话中，工具调用显示在统一的工具调用视图里。
- 想回到原来的方式，直接在终端里照常运行 pi 即可。你的 Pi 包和会话不会被 HagiCode 锁定。
HagiCode 在 Agent 之上增加了什么
并行会话与 Agents 管理
Pi 把子 Agent 留给扩展去做。在 HagiCode 里每次 Pi 运行都是独立会话，一个在重构，另一个在写测试，Agents 管理会显示每个会话的状态。
OpenSpec 提案
Pi 默认没有计划模式，HagiCode 的提出、校验、实施、归档流程为每个 Pi 任务补上书面计划和记录。免费版同时最多 3 个提案。
AI 提交与 Code Server
HagiCode 根据差异生成提交信息，并在提交期间锁定仓库。内置 Code Server 可在浏览器编辑器里打开 Pi 改过的文件。
Monospecs 与 Vault
Monospecs 在一个文件里列出你的仓库，让 Pi 开始提案时就了解完整的改动范围。Vault 保存参考项目和笔记，新提案可拿来当上下文。
OmniRoute、工具调用视图与 TokenMonitor
配置 OmniRoute 后，Pi 的模型请求可以经它路由。Pi 的工具调用与其他 Agent 使用同一种格式。状态栏里的 TokenMonitor 项显示今日 token 与费用，默认关闭。
交互式提问
Pi 提出结构化问题时，HagiCode 会在对话中显示，会话等待回复，你回答后同一次运行继续。如果运行已经结束，回答会作为普通消息发到同一会话。
- 同时提出的多个问题可以一次提交回答；
- 超过 30 分钟未回答的问题会过期，仍可通过后续消息回答；
- 由各 CLI 的交互控制设置决定是否启用。
结论
- Pi 是免费、MIT 许可、刻意保持极简的 Agent；HagiCode 是运行它的工作台，并不替代它。
- 想自己塑造 Agent，或在脚本和自有工具里使用，只用 Pi 就够了。
- 想要并行会话、提案和提交辅助，又不想自己做成 Pi 扩展时，再加上 HagiCode。
- 你的 Pi 安装和登录都不受影响，试用 HagiCode 不需要做任何承诺。
常见问题
Pi 免费吗？
Pi 采用 MIT 许可，可免费安装。你只为接入的模型付费，方式是 API Key，或用 /login 登录的供应商订阅。最新信息请看 pi.dev。
怎么安装 Pi？
macOS 或 Linux 运行 curl -fsSL https://pi.dev/install.sh | sh；Windows 运行 powershell -c "irm https://pi.dev/install.ps1 | iex"。也可以运行 npm install -g --ignore-scripts @earendil-works/pi-coding-agent，需要 Node.js 22.19 或更新版本。
Pi 有子 Agent 或计划模式吗？
默认没有。Pi 有意不内置它们，由你通过扩展、Skills 或包添加。
Pi 能和 HagiCode 一起用吗？
可以。HagiCode 支持把 Pi 作为 Agent CLI。先安装 Pi 并运行 /login，再在 HagiCode 里选择它；HagiCode 会替你启动 Pi，并保持你的 Pi 配置不变。
HagiCode 会取代 Pi 吗？
不会。HagiCode 是围绕 Pi 的工作台，提供会话、提案、提交和历史记录。运行时需要先安装并登录 Pi。
Pi 和 HagiCode 该选哪个？
想要一个自己扩展的极简 Agent，只用 Pi。想要现成的并行会话、提案和历史，就在 Pi 之上加 HagiCode。