Pi-mono 是 Pi 的 monorepo 名称，Pi 是由 Mario Zechner（badlogic，libGDX 作者）创建的极简 terminal coding agent。CLI binary 只是 pi。它只提供四个工具——read、write、edit 和 bash——并默认运行在完整 YOLO 模式下，把其他所有东西（subagents、plan mode、permission gate、MCP）都交给可安装的 extension。这个 repo 位于 github.com/badlogic/pi-mono（镜像为 earendil-works/pi），采用 MIT 许可。

pi-mono 和 Claude Code 或 Codex CLI 相比如何？

Pi 的核心观点是：现有 harness 像宇宙飞船，80% 的功能大多数用户根本用不到，而且 system prompt 和 tool surface 变化太频繁，会破坏个人 workflow。Pi 把核心 surface 保持得很小（四个工具），理由是像 GPT-5.5 这样的前沿模型已经在这些精确 schema 上训练过；而所有额外功能都放进 extensions、skills 和 prompt templates 里，由你自己组合、fork 或替换。代价是少了一些开箱即用功能，但换来的是一个你可以完全阅读和修改的 harness。

pi-mono 能和 Smart AIPI 配合使用吗？

可以。Pi 底层的 provider library，pi-ai，同时支持 OpenAI-compatible endpoint、Anthropic、Bedrock、Vertex、Mistral、Groq、Cerebras、xAI、DeepSeek、OpenRouter、Hugging Face 等许多 provider。把 OPENAI_BASE_URL 设为 https://api.smartaipi.com/v1，并把 OPENAI_API_KEY 设为你的 Smart AIPI key，就能直接接入 Pi。你无需改动任何代码，就能使用 GPT-5.5、GPT-5.4、GPT-5.4-mini 以及 Smart AIPI 目录中的其他 model。

我可以通过 Smart AIPI 在 pi-mono 上运行哪些 model？

凡是我们托管的都可以：GPT-5.5（在 Terminal-Bench 2.0 和 Expert-SWE 上处于 state-of-the-art）、更便宜的日常工作可用 GPT-5.4 和 GPT-5.4-mini、适合紧凑 code edit 的 GPT-5.3-codex，以及通过 Anthropic-compatible endpoint 提供的 Claude 系列 model 和通过 OpenAI-compatible path 提供的 Gemini。Pi 的杀手级功能是 session 中途切换 provider——pi-ai 会重写 context，因此你可以在任务进行到一半时从 GPT-5.5 切到 Claude 或 Gemini，而不会丢失 state。

什么是 grill-me skill，为什么要和 pi-mono 搭配？

Grill-me 是 Matt Pocock 的 skill（github.com/mattpocock/skills/blob/main/skills/productivity/grill-me/SKILL.md），它会让 model 不断追问你的计划——定向询问，直到每个决定、约束、文件和验收标准都被锁定。Pi-mono 故意不自带 plan mode，因此 grill-me 是最自然的补充：在 spec 阶段用 high reasoning 跑它，然后切到 low reasoning，让 Pi 的裸金属四工具循环在很多轮里低成本地执行计划。

superpowers skill 集合是什么？

Superpowers（github.com/obra/superpowers，作者 Jesse Vincent）是一整套以可组合 skills 形式提供的软件开发方法论——TDD 脚手架、code review playbook、debugging 流程、refactoring 模式。它是 harness-agnostic 的（可在 Claude Code、Cursor、Copilot CLI、Gemini、Codex 和 Pi 中使用），所以把它和 pi-mono 搭配后，你就能获得 Pi 核心里刻意不提供的方法论，同时又不被绑定到任何单一 harness。

什么是 caveman skill，它如何降低成本？

Caveman 是 Matt Pocock 的一个 skill，会把 agent 切换到超压缩沟通模式——移除正式英文、删除冠词和填充词、用电报式 bullet 回复。报告中的真实 token 降幅在 prose-heavy 轮次大约是 75%。由于在 GPT-5.5 上 output tokens 的计费是 cached input 的 6 倍（每 100 万 $7.50 对比 $1.25），把 output 压低 75% 会显著降低聊天型任务的每轮账单。把它与 Pi 的极简核心和 Smart AIPI 的 95–98% cache 命中率配合起来，就能在多个维度上叠加成本下降。

为什么 pi-mono 在 Smart AIPI 上比其他 agent 更便宜？

有三个复利式收益。(1) Pi 的四工具核心只带一个很小的 system prompt，而功能丰富的 harness 往往有数千 tokens 的 system prompt——每一轮为常驻 context 支付的费用更低。(2) Smart AIPI 的 gateway 会端到端保留 OpenAI prompt cache，因此 repo + agents.md + history 会在长 session 中持续命中 cache，按每 100 万 input $0.125 计费（比未缓存便宜 10 倍）。(3) Caveman 压缩 output，而 output 是 coding-agent 账单里最贵的一项。叠加之后，每轮费用会比在未缓存 endpoint 上运行功能丰富的 harness 低一个乘法级别的数量级。

pi-mono 原生支持 skills 吗？

支持。Pi 实现了 Agent Skills 标准——把 skill 文件夹放进你的配置，然后用 /skill:name 调用即可。它还有第一方 skill 集合，位于 github.com/badlogic/pi-skills（brave-search、browser-tools、vscode integration、youtube-transcript、gd/gc/gm CLI wrappers、transcribe），并且明确兼容 Claude Code、Codex CLI、Amp 和 Droid。像 mattpocock/skills 和 obra/superpowers 这样的第三方 skill repo 也以同样方式工作。

如何安装 pi-mono 并把它连接到 Smart AIPI？

一个安装命令，两个 env var。安装：curl -fsSL https://pi.dev/install.sh | sh（或者 npm install -g @earendil-works/pi-coding-agent）。配置：export OPENAI_BASE_URL=https://api.smartaipi.com/v1 和 export OPENAI_API_KEY=sk-your-smartaipi-key。运行：pi。再通过 /skill 加入 grill-me、superpowers 和 caveman，你就拥有了如今最便宜的严肃 agentic coding 方案。

Pi-Mono 在 Smart AIPI 上：运行轻量 Coding Agent 的最便宜方式——搭配 Grill-Me、Superpowers 和 Caveman

TL;DR: Pi-Mono 是 Mario Zechner 的极简 coding agent——四个工具（read、write、edit、bash）、MIT 许可、刻意保持非常小的核心。它兼容 OpenAI-compatible，所以把它指向 https://api.smartaipi.com/v1，用 low reasoning 运行 GPT-5.5，再配上三个弥补 Pi 刻意留白的技能：grill-me 负责任务创建，superpowers 负责工程方法论，caveman 技能把 output tokens 约减少 75%。叠加 Smart AIPI 的按量付费定价和 95–98% 的 cache 命中率，每轮费用会以复利方式下降，你可以在自己的 usage page 上直接验证。

轻量 agent 运动终于有了旗舰。Pi-Mono 是 pi 背后的 monorepo，这是一个来自 Mario Zechner（libGDX 作者）的 terminal coding harness，它把 coding agent 还原到最核心的部分，把其他一切都交给 extension。正如 Zechner 在他的 Mastra 演讲 "I Hated Every Coding Agent, So I Built My Own" 中所说：现有 harness 像宇宙飞船，80% 的功能大多数 developer 从来不会碰，而且它们的 system prompt 每次发布都会变化——这会破坏你在其上精心构建的个人 workflow。

Pi 的回应是激进的极简主义：四个工具、完整 YOLO 模式、没有附送任何“电池”。可黑客性优先于完整性。在 Smart AIPI 的按量付费 OpenAI-compatible endpoint 上，这种极简主义会直接转化为如今最低成本的严肃 agentic coding 方案。

Pi-Mono 到底是什么

pi-mono 是 monorepo（github.com/badlogic/pi-mono，镜像在 earendil-works/pi）；CLI binary 只是 pi。这个 repo 被拆成了几个聚焦的 package：

pi-agent-core —— runtime：tool calling、state、真正的 agent loop。
pi-ai —— 一个统一的 provider library，可对接 Anthropic、OpenAI-compatible、Bedrock、Vertex、Mistral、Groq、Cerebras、xAI、DeepSeek、OpenRouter、Hugging Face、Ollama，以及大约十多个其他 provider。关键是，它可以重写 context，从而在 session 中途切换 provider 而不丢失 state。
pi-tui —— 一个差分渲染的 terminal UI。
pi-coding-agent —— 面向用户的 CLI，把这些部分串起来。

默认的 tool surface 只有四个工具，仅此而已：

Tool	它做什么	为什么这就够了
`read`	从磁盘读取文件	前沿模型已经在这种精确 schema 上训练过
`write`	写入或创建文件	机械 I/O——不需要推理
`edit`	对文件应用原地 patch	search/replace + diff 是通用的编辑原语
`bash`	运行任意 shell command	其他一切（grep、tests、git、package managers）都可以是 shell command

再多的东西——subagents、plan mode、permission gate、MCP servers、sandboxing——都放在 pi-skills 或第三方 extension 中，按需启用。Pi 默认运行在 完整 YOLO 模式：没有 permission prompt，不限制 filesystem 和 shell。这是刻意的选择。如果你想要安全护栏，就自己安装。

为什么 Pi-Mono 和 Smart AIPI 是绝配

Pi 的 pi-ai library 把每个 provider 都当成位于统一接口后面的 OpenAI-shaped 或 Anthropic-shaped endpoint。Smart AIPI 的 gateway 通过单一 base URL 和单一 API key 暴露整个 OpenAI surface——chat、responses、embeddings、images、audio、anthropic-shaped messages。两种设计可以无缝拼接：

一个 key，所有 model。 同一个 Smart AIPI API key 可以拿到 GPT-5.5、GPT-5.4、GPT-5.4-mini、GPT-5.3-codex、GPT-Image-2，以及 Anthropic-compatible 的 Claude routing——而 Pi 可以在 session 中途在它们之间切换。
按量付费定价。 没有 subscription、没有 quota、没有 throttle。你只为实际计算的 tokens 付费。Pi 的小 system prompt 意味着每一轮为常驻 context 支付的费用都比功能堆满的 harness 更低。
端到端 prompt cache。 Smart AIPI 会透传 OpenAI 的 prompt-cache key，因此你的 repo + agents.md + history 在长 session 中会持续命中 cache。真实场景的 cache 命中率是 95–98%，把 cached input 降到每 100 万 tokens $0.125——比未缓存便宜 10 倍。
WebSocket session 保持。 长时间的 pi-mono session 会一直停留在一个温热的 cache 上，而不是每一轮都支付完整 input 价格。

让 Pi-Mono 完整起来的三个技能

Pi 刻意不提供 task planning、不内置有观点的 engineering methodology，也不做 output 压缩层。这不是 bug——这就是重点。社区已经用可组合的 skill 补上了这三个空缺，并通过 /skill:name 调用模式将其接入 Pi。最值得在第一天安装的三个技能：

1. Grill-Me —— 高推理的任务创建

位置： github.com/mattpocock/skills，作者 Matt Pocock。

Grill-me 正如名字所示：模型会不断追问你的任务，直到每个约束都完全明确。涉及哪些文件、成功标准、边界情况、“完成”到底意味着什么。通常只需三到五轮短对话。你回答；技能会返回一个紧凑、可执行的 spec。

经济上的做法是在 spec 阶段只用 high reasoning 跑 grill-me——通常三到五轮短对话——然后在执行阶段切到 low reasoning（30 到 100 轮便宜、机械的工作）。高推理用在真正需要它的地方；低推理承担剩下的部分。Pi-mono 的四工具循环非常适合这种模式，因为它不会碍事：一旦 spec 锁定，model 就能沿着 read/write/edit/bash 的清晰路径把事情做完。

2. Superpowers —— 作为 Skills 的工程方法论

位置： github.com/obra/superpowers，作者 Jesse Vincent。

Superpowers 是“为你的 coding agent 准备的一整套软件开发方法论，建立在一组可组合 skills 之上”。TDD 脚手架、code review playbook、debugging 流程、refactoring 模式、branch management 纪律。它是 Pi 刻意没有写进核心的显式工程流程。

它还是 harness-agnostic 的——同一套 skill pack 可以在 Claude Code、Cursor、Copilot CLI、Gemini、Codex 和 Pi 中工作。安装一次，就可以在不同 harness 之间带着走。Pi 的即插即用 skill loader 意味着你可以把整套方法论叠加到这个极简核心上，而不用碰 pi 的 source。

3. Caveman —— 输出 tokens 杀手

位置： Matt Pocock 的 skills repo（productivity 部分）。

Caveman 会把 agent 切换到 超压缩沟通模式。去掉冠词、去掉填充词、用电报式 bullet 回复。不要正式英文，不要道歉，不要前言。对 prose-heavy 的轮次，报告中的真实 token 降幅大约是 75%。

它为什么能显著压低账单：在 GPT-5.5 上，output tokens 的价格是 每 100 万 $7.50，而 cached input 只有 每 100 万 $0.125——相差 60 倍。压缩 output 是你能对 coding-agent 账单做的、杠杆最高的一件事。Grill-me + low reasoning 已经减少了 output；Caveman 把剩下的再压缩。再配上 Smart AIPI 的 cache，这样额外一轮的边际成本会逼近 model 计算预算的下限。

复合成本的故事

Smart AIPI 上 GPT-5.5 的定价：

GPT-5.5（每 100 万 tokens）	Smart AIPI	Pi-Mono 效果
Input（未缓存）	$1.25	小 system prompt 意味着首轮成本更低
Input（cached prefix）	$0.125	长 session 中可达到 95–98% 命中率
Output	$7.50	Caveman 约减少 75%；low reasoning 进一步叠加

在 GPT-5.5 low reasoning 下，一个 pi-mono turn 的形态是这样的，前提是 grill-me spec 已经完成并且 caveman 已启用：

Cached input prefix（repo + agents.md + history）——通常是每轮最大的 token 桶——每次 cache 命中时都按 cached rate 计费，而不是未缓存费率。
新的未缓存 input（tool 结果、最新的 user message）——通常只占 input 的很小一部分，按全价计费。
Output——由 caveman 压缩，且因为 effort 很低，所以 reasoning tokens 也很少。这是最值得压缩的一项，因为它按最高的 per-token rate 计费。

按量付费意味着你只为计算的内容付费，而这三个杠杆会形成复利。你自己的 dashboard 会显示针对你的 repo 和 prompt 形态的实际 per-turn 数字——没有 cap，没有 throttle，没有月最低消费。

中途切换 provider：Pi 的隐藏亮点

Pi-ai 会保留一个可移植的 context 表示，并能把它重写成当前所连接的 provider 所需要的格式。翻译成实际用法：当 GPT-5.5 遇到难以判断的地方时，你可以在任务进行到一半时输入 /model claude-sonnet-4.6，临时切到另一个 model 讨个第二意见，而不会丢失 conversation。两个 endpoint 都位于你的单一 Smart AIPI key 后面——Anthropic-compatible 的 Claude responses 通过 /v1/messages，OpenAI-compatible 流程通过 /v1/responses（或者 /v1/chat/completions），而 Pi 会透明地完成转换。

对于长时间、高风险的 refactor，这个模式真的很有用：先用 GPT-5.5 high 跑 grill-me 做 spec，再用 GPT-5.5 low 执行，接着用 Claude Sonnet 4.6 做一次架构审查，最后回到 GPT-5.5 low 收尾。一个 harness、一个 API key、一张账单。

60 秒内完成设置

# 1. 安装 pi
curl -fsSL https://pi.dev/install.sh | sh
# 或者：npm install -g @earendil-works/pi-coding-agent

# 2. 指向 smart aipi
export OPENAI_BASE_URL=https://api.smartaipi.com/v1
export OPENAI_API_KEY=sk-your-smartaipi-key

# 3. 在你的 repo 中运行 pi
cd ~/code/your-project
pi

# 4. 在 pi 内安装 skills
/skill:install matt-pocock/skills/grill-me
/skill:install obra/superpowers
/skill:install matt-pocock/skills/caveman

# 5. 为你的任务做 spec
/skill grill-me

# 6. 切到 low reasoning 并执行
/model gpt-5.5 --reasoning-effort low
/skill caveman

精确的 skill-install 语法取决于你使用的 skill loader——请查看每个 skill repo 的 README 获取当前调用方式。形式是一样的：把 skill 文件夹放进你的配置，然后调用它。

为什么轻量 Agent + 轻量 API 会形成复利

功能丰富的 harness 会在每一轮加载一个很大的 system prompt，额外跑一遍 deliberation，并输出用户并未要求的冗长解释。这些每一项都是税。Pi-mono 削减了 harness 侧的税负（小 system prompt、四工具循环、没有过度设计的 planning layer）；caveman + low reasoning 削减了 model 侧的税负（压缩输出、更少 reasoning tokens）；Smart AIPI 削减了 provider 侧的税负（10 倍 cached input、没有 subscription floor）。单独看，这些都不一定是 10 倍收益，但叠在一起后，它们会实质性改变一个长期 agentic 项目的运行成本。

Pi 的世界观——“让 agent 适应你的 workflow，而不是反过来”——与 Smart AIPI 的世界观——“只为你实际计算的内容付费”——高度一致。如果你一直在撞 subscription cap，或者在为从未使用的 harness 功能付费，那么这个组合值得你花一个下午试一试。注册、生成 key、设置 OPENAI_BASE_URL、安装 pi、安装这三个 skills、交付点什么。

开始使用——注册即送 $5

每个新账户都会获得 $5 免费 API credits——无需 credit card。

$5 足够你安装 pi、接入这三个 skills、用 grill-me 完整跑完一个真实任务，并进行一次延长的 pi-mono session，然后再决定是否充值。

注册：smartaipi.com/signup（免费 $5，无需 credit card）
在 dashboard 中创建 API key
安装 pi：curl -fsSL https://pi.dev/install.sh | sh
设置 OPENAI_BASE_URL=https://api.smartaipi.com/v1 和 OPENAI_API_KEY 为你的新 key
安装 grill-me + caveman 和 superpowers
运行 pi，用 grill-me 对下一个任务做 high reasoning 的 spec，再切到 low + caveman，交付它

你原本会在 subscription 上运行的同一个极简 harness——现在换成了一个会随你实际计算量扩展的定价模型，而且 cache 命中率会让长时间 agentic session 几乎免费。