Pi 智能体工具包

Pi 是什么

Pi 是一个极简、可扩展的 AI 智能体工具包（agent harness），核心理念是「让 Pi 适配你的工作流，而不是反过来」。它由多个 npm 包组成，既可以直接作为编码智能体 CLI 使用，也可以拆开把能力嵌入自己的项目。

主要组成

• pi-ai：统一的多厂商 LLM API，覆盖 OpenAI、Anthropic、Google 等
• pi-agent-core：带工具调用与状态管理的智能体运行时
• pi-coding-agent：交互式编码智能体 CLI
• pi-tui：带差分渲染的终端 UI 库
• pi-durable：持久化会话、任务与文档运行时
• chord / pi-telemetry：插件宿主运行时与厂商中立的遥测契约

使用方式

安装 CLI 后，在目标项目目录中启动即可：

cd /path/to/project
pi

在 Pi 内运行 /login 连接内置 AI 提供商的订阅或 API Key，然后直接下达任务。除交互模式外，还支持打印/JSON 模式、RPC 控制，以及通过 TypeScript SDK 构建应用。

定制与扩展

Pi 自带实用默认值，但有意省略了子智能体、计划模式等特性。你可以通过以下方式按需补齐：

• 扩展（extensions）：挂接自定义工具与行为
• 技能（skills）：封装可复用的任务能力
• 提示模板（prompt templates）：固化常用指令
• 主题（themes）：调整终端外观

这些内容可以打包为 Pi 包，通过 npm 或 git 分享。

安全与隔离

Pi 默认不内置文件系统、进程、网络或凭据的权限限制，会以启动用户的权限运行。若需要更强边界，可采用容器化方案，例如将工具调用路由到本地 Linux 微虚拟机、用 Docker 整体隔离，或在策略控制的沙箱中运行。

适合谁

适合希望深度定制 AI 编码助手、或把智能体循环与多模型调用集成进自有产品的开发者。项目使用 TypeScript 编写，采用 MIT 协议。