用途：pi-agent 是围绕 Pi（Pi Agent Harness）的智能体工程技能，用于在 Pi 运行时之上构建或使用智能体。Pi 被描述为可自我扩展的交互式编码智能体 CLI，定位为“最小可改造的编码智能体骨架”，刻意不内置 RAG 或权限系统，循环之外的一切均以扩展形式提供。
主要能力：包含 @earendil-works/pi-coding-agent（交互式编码智能体 CLI）、pi-agent-core（可复用智能体运行时，支持工具调用与状态管理）、pi-ai（统一多提供商 LLM API，如 OpenAI、Anthropic、Google 等）、pi-tui（带差分渲染的终端 UI 库）；支持扩展、主题与自定义工具，智能体可扩展自身；支持带分支状态的会话树；同系列项目 pi-chat 面向 Slack/聊天自动化。
使用方式：安装命令为 npm install -g @earendil-works/pi-coding-agent，随后运行 pi 进入交互式编码智能体。库用法可分别从 @earendil-works/pi-ai（统一 LLM API）与 @earendil-works/pi-agent-core（智能体运行时）导入。资料建议先确认 TypeScript 环境并按安装说明使用对应包管理器，启动前安全配置模型提供商与 API 密钥，执行 AI 生成代码时采用沙箱或权限隔离。
适用场景：需要阅读和修改智能体骨架、以最小循环加扩展方式搭建自定义编码智能体，或复用其运行时与多模型 API 的项目。
限制：资料未提供具体收费、价格、平台支持范围与效果数据；其架构刻意不含内置 RAG 与权限系统，相关能力需自行以扩展实现。