最近看到一个Agent框架项目,它是openClaw背后的英雄,还在 Terminal-Bench 基准测试中击败了一众功能丰富的竞品。作者Zechner Mario Zechner 厌倦了 Claude Code 变成"80% 功能都用不上的宇宙飞船",决定自己写个 AI 编程助手。他的想法很简单:如果我不需要这个功能,就不会构建它。
结果就是 pi-mono,一个极简到只剩四个工具的编程助手。
从复制粘贴到极简主义
Zechner 的开发历程很典型。过去三年里,他从复制粘贴代码到 ChatGPT,到 Copilot 自动补全(他说从来没用好过),再到 Cursor,最后是 2025 年成为日常工具的编程助手们:Claude Code、Codex、Amp、Droid、opencode。
他最初偏爱 Claude Code,因为早期版本很基础,符合他"喜欢简单可预测工具"的性格。但几个月来,Claude Code 变得越来越复杂,系统提示词和工具定义每次更新都会变,破坏他的工作流程。更要命的是,界面还会闪烁。
作为构建过 Sitegeist 等多个 agent 项目的开发者,Zechner 深知上下文工程的重要性。精确控制模型上下文能产生更好的输出,特别是写代码时。但现有工具都会在背后注入一些你看不到的内容,让这变得极其困难。
四个工具的哲学
pi-mono 只保留四个工具:
read # 读取文件内容,支持文本和图片,可指定行范围write# 创建新文件或完全重写,自动创建目录edit # 精确替换文本,oldText 必须完全匹配bash # 执行命令,返回 stdout 和 stderr,可设置超时
Zechner 的逻辑很直接:编程的本质就是读代码、写代码、改代码、跑代码。这四个工具组合起来能覆盖大部分编程场景。
想分析项目架构?AI 会 read 几个核心文件。要修复 bug?它会定位问题,用 edit 改特定行,然后 bash 跑测试验证。需要重构?它会理解现有逻辑,write 新的实现,保证功能不变。
四层技术架构
他从头构建了完整的技术栈:
┌─────────────────────────────────────┐│pi-coding-agent│← CLI 工具层│(会话管理、主题、上下文文件)│├─────────────────────────────────────┤│ pi-tui│← 终端 UI 层│ (差分渲染、组件系统) │├─────────────────────────────────────┤│pi-agent-core│← Agent 逻辑层│(工具执行、事件流、验证) │├─────────────────────────────────────┤│ pi-ai │← LLM 抽象层│(多提供商 API、上下文切换、成本跟踪) │└─────────────────────────────────────┘
pi-ai 是统一的 LLM API,支持 Anthropic、OpenAI、Google、xAI、Groq、Cerebras、OpenRouter 等十几家提供商。处理不同提供商的 API 差异是个大工程:
// 提供商差异示例const providerQuirks = {cerebras: { disallowedFields: ['store'] },mistral: { tokenField: 'max_tokens',// 而不是 max_completion_tokensdisallowedFields: ['store', 'developer'] },grok: { disallowedFields: ['reasoning_effort'] }};
跨提供商上下文切换是从一开始就设计的功能。当你从 Anthropic 切换到 OpenAI 时,Anthropic 的思考轨迹会被转换为助手消息中的内容块。
pi-tui 是最小化的终端 UI 框架,使用差分渲染技术。Zechner 在 DOS 时代长大,对终端界面很有感情,但他不想用 React 方式写 TUI。
为防止闪烁,pi-tui 用同步输出转义序列包装所有渲染,在 Ghostty 或 iTerm2 这样的终端里完全不闪烁,比 Claude Code 体验好很多。
会话管理的巧思
对话以 JSONL 格式存储,每个消息有 id 和 parentId,形成树状结构:
{"id": "1", "parentId": null, "role": "user", "content": "帮我写个函数"}{"id": "2", "parentId": "1", "role": "assistant", "content": "好的,我来帮你写..."}{"id": "3", "parentId": "2", "role": "user", "co…