Pi Agent 是一个强调精简内核、模型供应商适配和扩展机制的可自扩展编码代理 CLI。
简介
Pi Agent 是 Pi agent harness 项目中的交互式编码代理 CLI。项目同时提供统一多模型 API、Agent runtime、终端 UI 和扩展机制，允许用户围绕模型接入、工具、命令和界面进行组合。
核心能力
- 通过统一模型层接入多家模型供应商，并允许用户维护自定义 provider 配置。
- 内置文件读取、命令执行、编辑、写入和会话管理能力。
- 通过 package 和扩展机制增加计划、子代理、浏览器、MCP 适配器、历史回退等能力。
- 代码与 npm 包采用 MIT License，官方包为
@earendil-works/pi-coding-agent。
适用边界
- 官方说明明确指出 Pi 默认不提供限制文件系统、进程、网络或凭证访问的内置权限系统，处理不可信仓库或扩展时应使用容器或沙箱。
- 社区扩展数量多、权限范围广，不能把下载量或推荐清单等同于安全审计；安装前应核对源码、依赖和维护状态。
- 自定义模型参数、上下文窗口和最大输出值必须以供应商真实能力为准，不能直接照搬社区示例。
相关概念
当前结论
Pi Agent 适合验证“精简核心 + 可组合扩展”的编码代理路线，但正式使用前应先建立供应商配置、扩展权限和故障恢复的隔离测试清单。