Pi（Pi Agent Harness）是 earendil-works 推出的开源 AI Agent 工具包，目前 99.4k 星。它不是一个单一工具，而是一整套模块：统一多厂商 LLM API（@earendil-works/pi-ai）、带工具调用与状态管理的 Agent 运行时（pi-agent-core）、交互式编码 Agent CLI（pi-coding-agent）、终端 UI 库（pi-tui）以及遥测契约（pi-telemetry）。核心卖点是「一套 SDK 跑通所有大模型 + 自研 Agent 循环 + 开箱即用的编码代理」。GitHub 趋势上它正与 OpenCode、Codex 竞争开源编码 Agent 生态位。
| 维度 | 评分 | 说明 |
|---|---|---|
| 架构设计 | 9.0 | monorepo 分模块，AI/Agent/CLI/TUI 解耦清晰，可独立复用 |
| 模型兼容 | 9.0 | 统一 LLM API 覆盖 OpenAI/Anthropic/Google 等多厂商，一处接入处处用 |
| 编码能力 | 8.5 | 自研编码 Agent CLI，工具调用 + 状态管理 + 差分渲染 TUI |
| 扩展性 | 8.5 | 开源可 fork，作者公开分享真实 OSS 会话数据反哺训练 |
| 安全性 | 7.5 | 默认无内置权限系统，需自行容器化/Gondolin 微VM/OpenShell 沙箱 |
| 供应链 | 9.0 | 依赖精确锁定、lockfile 门禁、npm audit 定时检查，供应链硬化出色 |
| 生态成熟度 | 8.0 | 99k 星增长迅猛，但较 OpenCode/Claude Code 仍年轻，社区早期 |
| 上手难度 | 8.0 | 编码 Agent CLI 即装即用，深度定制需理解 monorepo 各包 |
综合评分：8.4/10 — 模块化程度最高的开源编码 Agent 工具包，开发者友好的下一代选择。
| 项目 | Pi | OpenCode | Claude Code |
|---|---|---|---|
| 定位 | Agent 工具包（统一API+运行时+CLI） | 开源编码 Agent | Anthropic 官方编码 Agent |
| Stars | 99.4k | 202.6k | — |
| 模型支持 | 多厂商统一 API（OpenAI/Anthropic/Google） | 多厂商 | Claude 为主 |
| 模块复用 | AI/Agent/CLI/TUI 分包可独立用 | 整体 | 整体 |
| 终端 UI | 自研差分渲染 TUI | TUI | TUI |
| 权限沙箱 | 需自行容器化/Gondolin/OpenShell | 内置权限 | 内置权限 |
| 许可 | MIT | MIT | 商业+开源组件 |
1. 模块化架构是最大差异化：把「统一 LLM API」「Agent 运行时」「编码 CLI」「TUI」拆成独立 npm 包。你想自己写 Agent，只引 @earendil-works/pi-ai 就能拿到多厂商统一接口；想白嫖现成编码代理，直接 @earendil-works/pi-coding-agent。这种「可组合」设计在同类里独树一帜。
2. 多厂商模型自由：统一 API 屏蔽了 OpenAI/Anthropic/Google 的差异，切换模型只改配置不改代码。对需要在不同模型间横跳的开发者非常实用。
3. 供应链极其认真：依赖精确锁定、--ignore-scripts、lockfile 提交门禁、npm audit 定时扫描——在开源 AI 工具里很少见这种供应链硬化程度，安全性加分。
1. 无内置权限系统：Pi 默认以启动它的用户权限运行，不限制文件系统/进程/网络访问。要安全隔离得自己上 Docker、Gondolin 微VM 或 OpenShell 沙箱——对普通用户有门槛。
2. 生态仍年轻：99k 星虽猛，但对比 OpenCode 的 202k 星和 Claude Code 的成熟生态，社区插件、教程、第三方集成还在早期。
3. 深度定制曲线陡：想要完全发挥 monorepo 各包能力，需要理解分包设计与模型数据生成流程，新手直接用 CLI 没问题，但做二次开发成本不低。
| 工具 | 定位 | 优势 | 劣势 |
|---|---|---|---|
| Pi | Agent 工具包 | 模块化最强、多厂商统一API、供应链硬化 | 无内置沙箱、生态年轻 |
| OpenCode | 开源编码 Agent | 202k星、社区大、内置权限 | 整体式、定制不如Pi灵活 |
| Claude Code | 官方编码 Agent | Claude 生态成熟、Skills/MCP 支持 | 绑定 Anthropic、非纯开源 |
| Codex | OpenAI 终端代理 | ChatGPT 账号直连、官方维护 | 模块化/开源度不如 Pi |
# 安装编码 Agent CLI（npm）
npm install -g @earendil-works/pi-coding-agent
# 直接运行编码代理
pi
# 单独使用统一 LLM API（做自己的 Agent）
npm install @earendil-works/pi-ai
# 使用 Agent 运行时（工具调用+状态管理）
npm install @earendil-works/pi-agent-corePi 是 2026 年开源 AI Agent 领域的一匹黑马：99.4k 星、MIT 协议、模块化程度冠绝同类。如果你是开发者，想要「一套 SDK 接所有大模型 + 可组合的 Agent 运行时 + 现成的编码 CLI」，Pi 是目前最优雅的选择。如果你只想要开箱即用的编码代理且在意内置安全沙箱，OpenCode 或 Claude Code 更省心。Pi 的真正价值在于：它是给「想亲手构建 Agent 的人」准备的乐高积木——8.4/10，值得深入探索。