想让 AI 在终端里帮我做研究、改代码、跑任务,但又不想到处接 API、配环境?earendil-works 开源的 Pi 就是冲着这个来的:一条 npm 命令装上,终端里就多了一套可自扩展的 AI 智能体工具箱。

是什么
Pi 是 MIT 协议、TypeScript 写的 AI 智能体工具箱,核心是一个可自扩展的编码智能体 CLI(pi-coding-agent),外面再包了统一的 OpenAI / Anthropic / Google 多厂商 LLM 接口(pi-ai)和带工具调用与状态管理的 Agent 运行时(pi-agent-core)。仓库当前 10.9 万个 Star、1.4 万个 Fork,最新版本 v0.87.1 发布于 2026 年 9 月,几乎每天都有提交。它把「统一 LLM 接口 + Agent 运行时 + 编码智能体」拆成一整套 npm 包,你既能直接用开箱即用的 CLI,也能拿底层包自己往上搭。
和那些"一个命令行工具打天下"的 AI 助手不同,Pi 的打法是"工具箱":底层有 pi-ai 管模型、pi-agent-core 管 Agent 循环、pi-tui 管终端界面、pi-durable 管持久化的对话和任务,最上面才是 pi-coding-agent 这个你能直接敲的编码助手。换句话说,它既想让你开箱就用,也想让你能改造成自己的 Agent 框架。

Pi 的仓库首页。TypeScript 主仓、MIT 协议,最近一次提交就在今天
它到底好用在哪儿
第一是 LLM 接口归一。pi-ai 把 OpenAI、Anthropic、Google 等家的接口统一成一套,你换模型基本不用改业务代码。对"今天用 Claude、明天换 Gemini"这类来回横跳的需求,这是实打实的省心。
第二是"可自扩展"的编码智能体。pi-coding-agent 是可交互的编码 CLI,能读文件、跑命令、改工程;而且它强调自扩展——能在运行时把自己写成的新能力挂上去,越用越懂你的项目。这点比"固定一套工具"的智能体更有想象空间。
第三是终端体验和可持久化。pi-tui 做的是差分渲染的终端界面,pi-durable 管持久对话、任务和文档,长会话不丢上下文。你要挂着它跑一个跨好几天的任务,它比那些一关窗口就忘干净的助手靠谱。
第四是供应链硬化做到位。直接依赖精确锁版本、.npmrc 开 save-exact、lockfile 预提交卡点、发布前生成 shrinkwrap 做审计——对一个 npm 项目来说,这套安全习惯相当扎实,不是嘴上说说。

v0.87.1 的发布记录。版本迭代很密,几个月就爬到 0.87
怎么用
装 CLI 最省事就是一行:npm install -g @earendil-works/pi-coding-agent,或者直接 npx @earendil-works/pi-coding-agent。Node 18 以上就能跑,没有别的硬依赖。想从源码跑,仓库里有 ./pi-test.sh 可以从任意目录拉起。小细节:它对"新贡献者的 issue 和 PR"默认自动关闭,由维护者每天统一审,所以外人提东西会先被收进待审队列。
想自己搭 Agent 的,直接用 pi-agent-core 和 pi-ai 两个包就行——这俩才是 Pi 真正想对外暴露的"积木"。
不足也得说清楚
它没有内置权限系统。Pi 默认以"启动它的那个用户"的权限运行,文件系统、进程、网络、凭据都不加任何边界。要强隔离得自己上容器——README 里给了 Gondolin micro-VM、Docker、OpenShell 三种模式。换句话说,开箱即用是方便,但拿它跑不可信的任务是有风险的,这点别忽略。
社区参与门槛偏高。新人的 issue/PR 默认被自动关,虽然维护者每天审,但对想贡献的人来说第一脚不太顺。另外它还在 0.x,227 个开放 Issue 里难免有边角功能仍在变动,踩到未稳定的地方别意外。
跟同类怎么比
最直接的对照是 Claude Code、Codex CLI、Gemini CLI。三者都是终端形态、都接模型干编码活,但 Pi 的差异是"工具箱而非单点"——它把 LLM 接口、Agent 运行时、TUI、持久层全拆成可复用 npm 包,你想自己拼一个 Agent 框架,它最合适;而 Claude Code 强在工程深度、和 Claude 绑死,Codex 绑 OpenAI,Gemini CLI 绑 Google。
我的判断:如果你想要的是"一套能自己长本事的终端 AI 工作台",而且不想被某家模型厂商绑死,Pi 这套可扩展工具箱值得一试。10.9 万 Star、版本爬到 v0.87.1、天天在动,方向是认真的,不是凑热度的玩具。
GitHub:https://github.com/earendil-works/pi
官方网站:https://pi.dev
标签:#Pi #AI智能体 #终端工具 #编码助手 #TypeScript #开源工具 #多模型
你更想要一个"即装即用的单点 AI 助手",还是一套能自己往上搭能力的工具箱?