Pi Coding Agent 今日发布

Pi 是一个极简的终端编程 Agent 运行框架，由 libGDX 游戏框架作者 Mario Zechner（badlogic）开发。与 Claude Code、Codex 这类"精装房"式商业 Agent 不同，Pi 坚持"毛坯房"哲学：内核保持极简，功能由用户按需扩展，通过 TypeScript 扩展、Agent Skills、Prompt 模板和主题来定制工作流程。

核心架构：5 个独立 npm 包

Pi 采用 monorepo 设计，核心功能拆分为 5 个独立发布的 npm 包：

• @earendil-works/pi-ai — 统一多提供商 LLM API，同时支持 Anthropic、OpenAI、Google、Azure Bedrock、Mistral、Groq、Cerebras、xAI、Hugging Face、Kimi、DeepSeek、MiniMax、NVIDIA、OpenRouter、Ollama 等 15+ 提供商、30+ 模型，且可在同一会话中切换模型
• @earendil-works/pi-agent-core — Agent 运行时核心，包含工具调用循环和状态管理，可嵌入其他应用
• @earendil-works/pi-coding-agent — 面向用户的主入口，交互式 CLI（TUI 界面）
• @earendil-works/pi-tui — 差分渲染终端 UI 库
• @earendil-works/pi-telemetry — 厂商中立遥测合约和合规测试

会话树结构

Pi 将会话存储为树形结构：可回到任意历史节点分支探索，同一会话文件中保存所有分支；接近上下文上限时自动压缩旧内容继续工作，支持按消息类型过滤和书签标注。还可将会话导出为 HTML 或上传到 GitHub Gist 生成可分享链接。

开箱即用的 4 个工具

裸 Pi 仅提供 4 个基础工具：read（读文件）、bash（命令行）、edit（编辑）、write（写文件），不内置 Subagent、Plan Mode 或大批量 MCP 工具。这种克制设计让用户完全掌控上下文工程。

扩展与定制

Pi 支持多种扩展方式：TypeScript 扩展可自定义工具、命令、事件和 UI；Agent Skills 兼容 Claude Code 和 Codex 规范；Prompt 模板通过斜杠命令展开；Pi Packages 可将扩展打包通过 npm 或 git 分享。pi.dev/packages 收录了大量社区贡献的扩展。

安全模型

Pi 提供项目信任机制（409 握手），支持容器化部署（Gondolin 扩展、Docker、OpenShell 沙箱），默认以启动用户权限运行，无内置权限限制系统。

安装与使用

支持 npm 全局安装（npm install -g @earendil-works/pi-coding-agent）或一键脚本（Linux/macOS：curl -fsSL https://pi.dev/install.sh | sh），配置 API Key 或订阅账号后直接运行 pi 启动会话。另有 pi-gui 原生桌面客户端（Electron）和 pi-agent-desktop 等社区衍生项目提供 GUI 体验。

数据亮点

GitHub 93,000+ Stars，10,700+ Forks，MIT 许可证，TypeScript 实现，支持 Windows/macOS/Linux/Termux，以及 Docker 容器化部署。