Pi Agent系列第一章：什么是Pi Agent，它精妙在哪里

一、 Pi是什么？

Pi是一款极简的、可扩展的终端coding agent harness，由typescript编写。

如何理解：

• coding agent：意味着pi可以读懂你的代码库，写代码、改代码、跑命令。
• 终端：意味着pi没有可视化用户界面，没有ide插件，而是把输出写入终端回滚缓冲区。
• 极简：意味着pi只有四个内置工具（read/write/edit/bash），约90词的静态system prompt，运行时拼接tools/skills/contextFiles后通常200-400词，简洁的TUI终端用户界面代码。它没有MCP、子agent、plan mode、权限弹窗、后台bash（bash执行在前台，同步占用agent执行流程，而非丢到后台独立运行）。
• 可扩展：意味着除了已有的核心功能，用户可以通过TypeScript扩展技能。

二、 核心架构

这四层里，pi-tui与agent体系完全解耦，这个是cli用户界面的代码。coding-agent在顶层（产品+SDK），agent-core在中间（引擎），pi-ai在底层（模型抽象），pi-tui是平行的UI层。

 三、 如何使用Pi

模型自由：在会话中途切换模型时，比如用/model切换，使用claude做复杂推理，切换minimax做简单文本处理。pi-ai在底层处理了跨供应商的上下文交接（思考轨迹转换、签名blob回放等），虽然也是有损的，但是强于“切换等于重新开始”。

树状会话：走错路就分叉。Pi会把会话存成DAG，而不是线形日志。/tree可以跳到任意历史消息，从那里分叉出新分支继续探索，我们可以在同一个起点尝试三种不同的修复方案。

YOLO模式与安全哲学：Pi默认agent不经弹窗直接执行操作。

四、复用Pi构建agent

Pi的扩展系统具备热重载能力，当agent修改了一个扩展文件时，改动立即生效，无需重启会话。这使得agent可以修改和增强自己的能力。

扩展可以实现：

• 自定义工具：定义新的tool，带参数校验
• UI组件：在终端里嵌入自定义界面
• 斜杠命令：注册新的/命令
• 事件监听：在工具调用结束等时机插入逻辑
• 主题：定制TUI外观
• 提示词模板：可复用的prompt模板