摘要: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?

20260727112539893.jpg

Pi的官网域名是shittycodingagent.ai——翻译过来就是“垃圾编程Agent”。这个自嘲式的命名,恰好道出了它的核心立场:不装。

Pi的作者是奥地利开发者Mario Zechner,libGDX游戏框架的创造者,在GitHub上拥有2万标星。他做Pi的动机很直接:受够了Claude Code。“Claude Code会在你的上下文里偷偷塞进很多东西,而且不会在UI上展示给你。这些东西会以最微妙的方式破坏你的工作流。”

于是他自己造了一个——核心不到1000 token,工具只有4个。

20260727112621619.png

二、四个工具,覆盖完整的编程闭环

Pi给LLM的默认工具集极其精简-:

  1. read — 读取文件
  2. write — 写入文件
  3. edit — 编辑现有文件
  4. bash — 执行Shell命令

没有grep、没有find、没有glob——这些在需要时由扩展提供。

四个工具构成了一个完整的编程闭环:读 → 改 → 跑 → 再读。Mario的设计哲学是:这4个工具覆盖了开发的主路径,其他一切都可以通过扩展系统添加。

对比一下竞品:Claude Code内置12+工具、数万token的系统提示词-。Pi的判断是:多出来的工具是噪声。

20260727112950815.png

三、“我们不做什么”清单,比功能列表更值钱

Pi的官网上有一个专门的章节叫“What we didn't build”——我们没有构建的部分。

这是一份反转过来的宣言:

  • 不做MCP:用CLI工具加README文档(“Skills”),或者写一个扩展
  • 不做sub-agent:想并行?用tmux起多个Pi实例
  • 不做权限弹窗:该跑沙箱跑沙箱,别让Agent停下来等人点“允许”
  • 不做plan mode:把计划写到文件里就行
  • 不做内置todo:用TODO.md

Pi的边界极其清晰:核心只管Agent循环和工具执行,其他一切交给扩展

这种“有意识做减法”的设计,在一个奔向“全部包含”的行业里显得格外另类。而正是这份缺失清单,定义了Pi的价值。

20260727113402221.png

四、扩展系统才是主角

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编程工具之一。