摘要:Pi Coding Agent是一个只给LLM四个工具(read/write/edit/bash)的终端编程助手,核心不到1000 token,却在GitHub收获超7万星。作者Mario Zechner(libGDX之父)用“不做MCP、不做sub-agent”的减法哲学,在Terminal-Bench 2.0上与Codex、Cursor同台竞技。扩展系统才是主角——你可以把Pi改造成任何你想要的样子。
一个只给AI四个工具的终端编程助手,却在GitHub上斩获了超过7万颗星。它不是靠功能多取胜,而是靠“什么都没有”杀出重围。
这就是Pi Coding Agent。
一、一个自嘲“垃圾”的项目,凭什么火遍GitHub?

Pi的官网域名是shittycodingagent.ai——翻译过来就是“垃圾编程Agent”。这个自嘲式的命名,恰好道出了它的核心立场:不装。
Pi的作者是奥地利开发者Mario Zechner,libGDX游戏框架的创造者,在GitHub上拥有2万标星。他做Pi的动机很直接:受够了Claude Code。“Claude Code会在你的上下文里偷偷塞进很多东西,而且不会在UI上展示给你。这些东西会以最微妙的方式破坏你的工作流。”
于是他自己造了一个——核心不到1000 token,工具只有4个。

二、四个工具,覆盖完整的编程闭环
Pi给LLM的默认工具集极其精简-:
- read — 读取文件
- write — 写入文件
- edit — 编辑现有文件
- bash — 执行Shell命令
没有grep、没有find、没有glob——这些在需要时由扩展提供。
四个工具构成了一个完整的编程闭环:读 → 改 → 跑 → 再读。Mario的设计哲学是:这4个工具覆盖了开发的主路径,其他一切都可以通过扩展系统添加。
对比一下竞品:Claude Code内置12+工具、数万token的系统提示词-。Pi的判断是:多出来的工具是噪声。

三、“我们不做什么”清单,比功能列表更值钱
Pi的官网上有一个专门的章节叫“What we didn't build”——我们没有构建的部分。
这是一份反转过来的宣言:
- 不做MCP:用CLI工具加README文档(“Skills”),或者写一个扩展
- 不做sub-agent:想并行?用tmux起多个Pi实例
- 不做权限弹窗:该跑沙箱跑沙箱,别让Agent停下来等人点“允许”
- 不做plan mode:把计划写到文件里就行
- 不做内置todo:用TODO.md
Pi的边界极其清晰:核心只管Agent循环和工具执行,其他一切交给扩展。
这种“有意识做减法”的设计,在一个奔向“全部包含”的行业里显得格外另类。而正是这份缺失清单,定义了Pi的价值。

四、扩展系统才是主角
Pi的真正威力不在四个工具上,而在扩展系统上。
Pi的扩展可以注册自定义工具、命令、键盘快捷键、事件钩子、UI组件,甚至替换内置工具。扩展可以打包成Pi Package,通过npm或git分发:
pi install npm:@foo/pi-tools pi install git:github.com/user/repo
团队定制一套工具链,一条命令全员分发——这个模型像VS Code扩展生态,但场景更底层。
扩展系统支撑着Pi的核心理念:不要把每个功能都做成固定按钮,而是让你可以把它接进自己的终端习惯里。
五、300行的Agent循环,在Terminal-Bench 2.0上杀进前五
Pi的Agent核心只有大约300行TypeScript代码。但就是这300行,在Terminal-Bench 2.0上与Codex、Cursor、Windsurf一同排进了前五。
使用Claude Opus 4.5模型时,Pi以极简架构击败了众多重量级对手,准确率达到49.8%。
维度 | Pi | Claude Code | Codex CLI | Aider |
开源协议 | MIT ✅ | 闭源 | Apache 2.0 ✅ | Apache 2.0 ✅ |
系统提示词 | <1000 Token | ~10000+ Token | 中等 | 中等 |
模型支持 | 15+ 任意切换 | 仅 Claude | 仅 OpenAI | 100+ via LiteLLM |
核心工具数 | 7 个 | 20+ 个 | 15+ 个 | 编辑+执行 |
子 Agent | ❌(扩展实现) | ✅ 内置 | ✅ 内置 | ❌ |
权限控制 | YOLO 模式 | 多级权限 | 可配置 | Git 提交兜底 |
扩展系统 | TypeScript 四层 | Hooks/Plugins | MCP | 配置文件 |
GitHub Stars | ~70K | 121K(文档) | 101K | 45K |
价格 | 免费(BYOK) | $20-200/月 | 捆绑 ChatGPT | 免费(BYOK) |
最适合 | 定制工作流 | 全自动执行 | OpenAI 用户 | Git 原生开发 |
Pi还有几个独特的设计:
树形会话结构:会话以树形结构存储,可以随时回到之前的节点继续分支。调试Agent时,可以开启“侧枝”任务,完成后再合并回主分支。
跨模型兼容:支持Anthropic、OpenAI、Google、Azure、Mistral、Groq等主流LLM提供商。可以在会话中随时切换模型。
四种运行模式:交互式TUI、打印/JSON模式、RPC模式、SDK嵌入模式。
六、力量在于他们没有构建的部分
Pi在GitHub上已经积累了超过7万颗星。这个数字说明了一件事:在一众“开箱即用”的AI编程工具里,有很多开发者恰恰想要一个“自己说了算”的底座。
Pi的官网上写着这样一句话:“There are many agent harnesses, but this one is yours”。
维度 | 评分 | 一句话解读 |
功能完整性 | ⭐⭐⭐☆☆ | 核心够用但高级功能全靠扩展自己搭 |
易用性 | ⭐⭐⭐☆☆ | 终端老手如鱼得水,新手学习曲线陡峭 |
性价比 | ⭐⭐⭐⭐⭐ | 免费 MIT 协议,只付模型 API 费用 |
创新性 | ⭐⭐⭐⭐⭐ | 极简+可扩展的架构在赛道里独树一帜 |
稳定性 | ⭐⭐⭐⭐☆ | 社区活跃更新频繁,v0.80+ 已趋于稳定 |
推荐度 | ⭐⭐⭐⭐☆ | 资深终端用户强烈推荐,新手建议先试 Claude Code |
综合评分:7.8 / 10
这句话概括了Pi的全部哲学:存在很多智能体,但这一个是你的。
它不是功能最多的那个。它是不替你做决定、把选择权留给你的那个。而正是这种“少”,让它成了GitHub上最受关注的AI编程工具之一。
