Pi：用可扩展终端框架构建自己的编程智能体工作流
一分钟看懂
Pi 是一套 AI Agent 工具包，包含统一多模型 API、带工具调用和状态管理的 Agent 运行时、终端界面以及交互式编程助手。它强调保持核心精简，再通过 TypeScript 扩展、技能、提示模板和主题适配个人工作流。
你可以用它做什么
- 在终端中使用能够读写文件、编辑代码和运行命令的编程 Agent。
- 通过统一接口接入多家模型供应商或兼容 API。
- 使用交互、一次性输出、JSON、RPC 或 SDK 模式嵌入其他流程。
- 编写扩展、技能和 Pi Packages，为助手增加工具与界面能力。
主要能力
- 提供模型 API、Agent Core、编程助手 CLI 和终端 UI 等独立包。
- 支持会话分支、压缩、模型切换和自定义上下文文件。
- 可使用订阅登录或 API Key，并支持多家模型供应商。
- 提供容器化说明与依赖锁定、发布校验等供应链措施。
适合哪些人
适合偏好终端工作流的开发者、需要定制编程 Agent 的高级用户，以及希望把模型调用和 Agent 循环嵌入自有工具的工程团队。
怎么开始使用
可运行 npm install -g --ignore-scripts @earendil-works/pi-coding-agent 安装命令行工具，然后通过 /login 使用受支持的订阅，或设置相应模型供应商 API Key。启动 pi 后先在测试仓库体验默认的读取、写入、编辑和 Bash 工具，再按需添加技能与扩展。
使用前需要知道
Pi 默认没有限制文件系统、进程、网络或凭据访问的内置权限系统，会继承启动它的用户权限；处理不可信代码时应按官方说明放入容器、微型虚拟机或策略沙箱。模型服务可能收费并处理发送给它的代码和上下文。第三方扩展拥有相应执行能力，安装前应审查来源。项目采用 MIT 许可证。