Pi

Pi 是 libGDX 作者 Mario Zechner 写的开源终端编程 Agent。它的出发点很明确：前沿模型已经知道“编程 Agent”该怎么工作，外壳不需要塞几千 token 的系统提示和十几个工具。于是 Pi 的默认工具只有读、写、编辑和 bash，系统提示也很短。

为什么是首选

• 上下文透明。 系统提示极简，没有隐藏的上下文注入，模型看到的东西基本就是你给它的东西。出了问题容易排查。
• 原语而不是功能。 子 Agent、计划模式、权限确认、沙箱这些别的工具内置的功能，在 Pi 里都可以用扩展实现，或者直接安装别人写好的包（pi install npm:... / pi install git:...）。你也可以让 Pi 自己写扩展，/reload 后立即生效。
• 会话是一棵树。 可以回到任意一条历史消息重新分支，再把整段会话分享出去。
• 不绑定模型。 支持多家模型提供商，切换模型不用换工具。
• 读 AGENTS.md 和 Skills。 项目说明和按需加载的技能包在不同工具之间通用。

需要知道的取舍

Pi 刻意不内置计划模式、待办列表和后台 bash：计划写进文件，待办用 TODO.md，长时间运行的进程交给 tmux。它也不会弹窗征求你的同意，安全边界需要你自己划——放进容器运行，或者装一个权限确认的扩展。如果你想要“装好就能用”的完整体验，IDE 会更合适。

上手

npm install -g @mariozechner/pi-coding-agent
cd your-project
pi

第一次运行前，先在项目根目录放一份 AGENTS.md（见下方纪念品），告诉它怎么安装、怎么测试、哪些地方不能碰。

# AGENTS.md

## 项目
- 一句话说明这个项目做什么、给谁用。
- 技术栈：<框架 / 语言 / 包管理器>

## 常用命令
- 安装依赖：`pnpm install`
- 本地开发：`pnpm dev`
- 全部检查：`pnpm check`（提交前必须通过）

## 工作方式
- 先读相关文件和测试，再动手；改动保持在任务范围内。
- 每完成一步就运行相关测试，失败时先定位原因，不要删测试或放宽断言。
- 计划写进 `PLAN.md`，待办写进 `TODO.md`，完成后更新。
- 长时间运行的进程（开发服务器、监听测试）放在 tmux 里，不要阻塞当前会话。

## 边界
- 不要提交、推送或改写 Git 历史，除非我明确要求。
- 不要读取或输出 `.env*` 中的密钥。
- 不要在 `src/generated/` 下手动修改文件。