earendil-works / pi

∴ 是什么

Pi 是一个极简、可扩展的 agent 工具包，包含多个 npm 包：统一多提供商 LLM API、agent 运行时、编码 agent CLI、终端 UI 库、持久化运行时、遥测等。它通过扩展、技能、提示模板和主题进行自定义，并支持打包成 Pi 包通过 npm 或 git 分享。

∴ 解决什么问题

• ›需要将 AI agent 适配到自己的工作流而不是相反
• ›需要统一访问多个 LLM 提供商（OpenAI、Anthropic、Google 等）
• ›需要以交互式、自动化（print/JSON 模式）或通过 RPC 控制 agent
• ›需要为 agent 应用构建可组合的运行时和 UI

∴ 怎么上手

1. 01安装 CLI：curl -fsSL https://pi.dev/install.sh | sh
2. 02Windows 安装：powershell -c "irm https://pi.dev/install.ps1 | iex"
3. 03或用 npm 安装：npm install -g --ignore-scripts @earendil-works/pi-coding-agent
4. 04进入工作目录启动 Pi：cd /path/to/project 然后运行 pi
5. 05在 Pi 内运行 /login 连接内置 AI 提供商的订阅或 API key，然后给出任务

∴ 适合谁

适合希望定制 agent 工作流、构建编码 agent 或集成 AI 能力的开发者，以及需要轻量级 agent 工具包的 TypeScript 用户。

∴ 要点

• ›默认跳过子 agent 和计划模式等特性，可按需通过包添加
• ›支持交互式使用、print/JSON 模式、RPC 控制和 TypeScript SDK
• ›没有内置权限系统，默认与启动它的用户权限一致，需自行容器化或沙箱化
• ›Nix 支持：nix run github:earendil-works/pi/stable，支持 Linux 和 macOS 的 ARM64 和 x86-64
• ›供应链加固：直接依赖固定精确版本，.npmrc 设置 save-exact=true 和 min-release-age=2
• ›使用 MIT 许可证

∴ 在榜记录

GitHub Trending 今日榜的每日存档，日期按北京时间。2026-09-15 首次上榜，累计在榜 5 天，最高第 10 名。