earendil-works/pi
开发工具一个可扩展的 AI 编程 Agent 框架,提供 CLI、统一 LLM API、Agent 运行时和终端 UI 库。
项目介绍
Pi 是一个面向 AI 编程 Agent 的 monorepo,包含编程 Agent CLI、带工具调用和状态管理的 Agent 运行时、统一的多家 LLM API、持久化会话/任务运行时、终端 UI 库,以及一个名为 Chord 的小型对象运行时。它面向希望在项目目录里运行 Agent 并按自己习惯改造它的开发者,而不是采用固定工作流。默认功能可用,但有意不内置子 Agent 和 plan mode;用户通过扩展、技能、提示词模板、主题,或 npm/git 包来补充这些能力 extensions skills packages。
Pi 可以交互运行,也支持 print/JSON 模式、RPC 和 TypeScript SDK,因此同一套框架既能供人在终端使用,也能嵌入其他应用 usage CLI RPC SDK。
快速使用
Pi 需要 Node.js 22.19 或更新版本;macOS、Linux 和 Windows 安装脚本可在需要时安装 Node.js。macOS/Linux 下通过 pi.dev 安装脚本装 CLI:
curl -fsSL https://pi.dev/install.sh | sh
Windows 下使用 PowerShell 安装脚本:
powershell -c "irm https://pi.dev/install.ps1 | iex"
安装脚本会锁定依赖,后续用 pi update 更新。也可以直接从 npm 安装,但这种方式不会锁定传递依赖:
npm install -g --ignore-scripts @earendil-works/pi-coding-agent
安装后进入要工作的项目目录,启动 Pi,并在交互界面里连接模型服务商:
cd /path/to/project
pi
在 Pi 内运行 /login,添加订阅或 API key,然后给它一个任务。完整安装和使用说明见 pi.dev/docs/latest,演示见 pi.dev。Nix 用户可运行 nix run github:earendil-works/pi/stable,也可固定 release tag,或在检出目录中用 nix build . / nix run . 构建运行 Nix 说明。
权限与隔离
Pi 没有内置权限系统来限制文件系统、进程、网络或凭据访问;默认以启动它的用户和进程权限运行。需要更强边界时,官方文档给出三种容器化方式:Gondolin 扩展把内置工具路由到本地 Linux micro-VM,同时把 Pi 和服务商认证留在宿主机;普通 Docker 把整个 pi 进程放进容器;OpenShell 在策略控制的沙箱中运行整个进程 容器化文档。
打包与供应链
pi.dev 安装脚本从生成的 install lock 安装,锁定传递依赖;npm 包本身不锁定传递依赖。直接外部依赖固定为精确版本,本地和 CI 安装尽可能使用 --ignore-scripts。发布二进制可从带 SHA256SUMS 的版本化源码归档重建,使用 scripts/build-binaries.sh 供应链说明 二进制构建。开发流程包括 npm install --ignore-scripts、npm run build、npm run check 和 ./test.sh 开发命令。项目采用 MIT 许可证。
HotRepo 点评
HotRepo 记录的每日快照显示,Pi 在数月内持续增长:2026-05-24 约 5.37 万 Star,2026-09-15 约 10.55 万,2026-11-19 达到 12.29 万,并在当天 TypeScript 日榜以新增 191 Star 位列第 17。这些是分散的日记录,不能拼成连续曲线,但长期方向一致。v1.0.0 发布讨论中,有用户称 Pi 是自己最喜欢的 harness,同时疑惑版本号为什么是 1.0.0 而不是 0.100.0 HN 讨论 评论。另一条关于 Linux 配置目录位置的批评讨论里,有用户表示对此感到沮丧,并因此去看其他编程 Agent 评论;回复中有人建议用「先检查现有目录」的简单方案 回复,也有人主张直接 fork 打补丁 回复。这种「极简、可 fork,但默认值不会让所有人满意」的两面性,是评估 Pi 时的实际框架。
本文由 AI 根据项目 README 生成,更新于 ,以项目官方文档为准。
Hacker News 讨论
相关推荐
- SaladDay/cc-switch-cli跨平台命令行与终端界面工具,统一管理七款 AI 编程助手的供应商、MCP、提示词、技能和会话。
- ZiChuanLan/pi-purge一个 pi 扩展,用你自己的提示词文件替换编程 agent 的系统提示词,方便做受控的提示词实验。
- google-gemini/gemini-api-cli让已有编码 Agent 或脚本通过命令行调用 Gemini 模型、生成媒体、分析文件并运行托管 Agent 的 Go CLI。
- nicobailon/pi-subagents让 Pi 会话把评审、侦察和实现分派给专注的子代理,支持并行与后台运行。
- Gentleman-Programming/engram让 AI 编程 agent 跨会话记住项目,免去反复交代背景;给使用支持 MCP 的 agent 的开发者。