产品定位
Pi 是 earendil-works 团队开源的极简可扩展 AI Agent 工具集，TypeScript 编写，MIT 协议，官网 pi.dev，仓库在 github.com/earendil-works/pi，GitHub 约 11.2 万 stars。官方把它定位为一个 agent harness（智能体骨架），强调让用户按自己的工作流改造它，而不是反过来迁就工具。

核心功能
扩展机制是核心，包含 extensions、skills、prompt templates、themes 四类定制方式，可打包成 Pi packages 通过 npm 或 git 分发共享。配置写在用户主目录的 ~/.pi/agent/settings.json 里，packages 字段列出要加载的包。官方刻意保持精简，默认不内置子智能体和 plan mode。内置的 @earendil-works/pi-ai 提供统一的多供应商 LLM API，可对接 OpenAI、Anthropic、Google 等，并支持切换 provider。

技术特点
安装方式多样：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 进入交互界面，用 pi update 升级。除交互模式外还支持 print 模式、JSON 模式、RPC 控制和 TypeScript SDK。Pi 不内置文件系统、进程、网络与凭据的权限系统，官方建议用容器化等方式自行隔离。

适用场景
适合希望深度定制 AI Agent 工作流的开发者、终端重度用户和多模型评测人员。借助统一 LLM API 与可切换 provider，可横向比较 OpenAI、Anthropic、Google 等模型表现，并在 settings.json 中设置 defaultProvider、defaultModel、defaultThinkingLevel。也适合把 Agent 嵌入自动化流程或构建应用，官方给出的真实集成案例是 OpenClaw。