Pi Agent
概述
Pi Agent 是由 Mario-Zechner 创建的极简 AI 编程代理工具包（TypeScript Monorepo），以 4 个工具 + < 1000 token 系统提示实现了与重型 Agent 可比的编程能力。核心理念：投资于 Harness 的简洁性和可控性，而非堆砌功能。
关键内容
1. 四层架构
Pi 由四个严格单向分层的包组成：
| 层 | 包名 | 职责 |
|---|---|---|
| L0 | pi-ai |
统一 LLM 通信层，支持 300+ 模型（零内部依赖） |
| L1 | pi-agent-core |
Agent 循环：工具调用、执行、事件流（只依赖 pi-ai） |
| L2 | pi-coding-agent |
完整编程代理：会话管理、工具、扩展系统 |
| L2 | pi-tui |
终端 UI 框架：差分渲染消除闪烁 |
每层只依赖下层，由构建系统强制执行。任何层可独立使用、替换或测试。
2. 四大设计哲学
- 「不需要就不构建」——子代理、计划模式、权限弹窗等均通过扩展系统实现而非内置
- 严格单向分层——构建系统强制，L0 零依赖向上到 L2
- Context-Engineering 第一公民——每个进入 LLM 的 token 均可见可控，系统提示 < 1000 token，无"秘密注入"
- 会话 JSONL 第一公民——JSONL 格式持久化，可序列化、可后处理、可跨 Provider 迁移
3. 与竞品的关键差异
| 维度 | Claude Code | Pi |
|---|---|---|
| 系统提示 | 数千 token | < 1000 token |
| 内置工具 | 20+ | 4 |
| 多 Provider | 否 | 300+ 模型 |
| 会话格式 | 私有 | 开放 JSONL格式</td>
</tr>
<tr>
<td>可自托管</td>
<td>否</td>
<td>是</td>
</tr>
</tbody>
</table>
<h3 id="3-pi-agent-coreagent">3. pi-agent-core：Agent 循环的最简实现</h3>
<p><code>pi-agent-core</code>（L1 层）是 Pi 工具包的核心传动系统，将一次性 LLM 调用组装成能持续运转的 [[Agent循环：
4. Terminal-Bench 验证Pi 在 Terminal-Bench 排行榜上击败了许多工具集更丰富的 Agent，验证了核心命题：Agent 性能瓶颈在于 Harness 设计质量和上下文精确性，而非工具数量。 来源
相关
|