Pi Coding Agent

pi.dev 是 Pi Coding Agent（简称 Pi） 的官方网站，定位为极简、可自我扩展的终端原生 AI 编程 Agent 框架，主打“轻量内核+高度可定制”，面向开发者、技术团队与自动化工作流，核心是用最小内核提供最大自由度，适配个人与企业级编码自动化场景。

快速入口

• 官网：https://pi.dev/（产品介绍、文档、安装指引）
• 开源仓库：https://github.com/badlogic/pi（Monorepo，含 packages/coding-agent 等）
• NPM 包：@earendil-works/pi-coding-agent（全局安装）
• 作者：Mario Zechner（知名开源开发者，libGDX 作者）
• 发行时间：2025–2026 年快速迭代，当前稳定版 v0.7+

核心功能与能力详解

（一）四种运行模式（覆盖全场景）

Pi 支持多模式适配本地交互、脚本自动化、进程通信与嵌入开发：

1. Interactive TUI（终端交互模式）：类 IDE 的终端聊天界面，自然语言对话、快捷键操作、上下文感知，日常编码主力模式；
2. Print/JSON（输出模式）：纯文本或 JSON 结构化输出，适合脚本调用、CI/CD 集成、日志解析；
3. RPC（远程过程调用模式）：进程间通信，支持与其他服务/Agent 互操作（如 WeSight 嵌入）；
4. SDK（嵌入模式）：提供 TypeScript SDK，可将 Pi 嵌入自有产品（如 OpenClaw 已集成）。

（二）多模型供应商与会话内切换

• 支持 15+ 主流模型：Anthropic Claude、OpenAI GPT-4o/3.5、Google Gemini、Azure、Bedrock、Mistral、Groq、Ollama（本地模型）、OpenRouter、Kimi、MiniMax 等；
• 会话内无缝切换：用 /model 命令或 Ctrl+L 即时切换模型，Ctrl+P 循环常用模型，无需重启会话；
• 认证灵活：API Key 或 OAuth，支持自定义模型供应商（通过 models.json 配置）。

（三）会话管理与上下文增强（

• 会话树（Session Trees）：支持分支、回退、并行探索，可随时回到任意消息分叉新会话；
• 自动压缩摘要（Auto-Compaction）：长会话自动生成摘要，控制上下文窗口不超限，保持响应速度；
• 动态上下文注入：自动读取项目文件、Git 历史、AGENTS.md 配置，动态构建精准上下文；
• RAG/长期记忆：内置检索增强与记忆原语，支持跨会话复用知识，适配大型代码库。

（四）高度可扩展架构

• 扩展（Extensions）：TypeScript 模块，自定义命令、工具、快捷键、行为逻辑；
• 技能（Skills）：可复用功能包（如 Git 操作、Docker 部署、API 调用），npm/Git 一键安装；
• 提示模板（Prompt Templates）：自定义系统提示、角色设定、输出格式，适配不同模型与场景；
• 主题（Themes）：终端 UI 配色、布局自定义；
• Pi Packages：打包扩展/技能/模板为可分享包，通过 npm 或 Git 分发，社区共享。

（五）CLI 与工程化能力

• 包管理：pi install/update/list/configure，版本锁定、依赖管理；
• 测试模式：仓库级测试生成、运行、结果分析；
• 会话导出/分享：HTML、GitHub Gist 导出，可复现 Agent 工作流，开源协作友好；
• 安全执行：权限门控、SSH/沙箱执行、自定义编辑器集成。

安装与快速上手

1. 安装（极简命令）

# 一键安装（推荐）
curl -fsSL https://pi.dev/install.sh | sh

# NPM 全局安装
npm install -g --ignore-scripts @earendil-works/pi-coding-agent

2. 启动使用

# 任意项目目录启动
pi

# 查看帮助
pi --help

# 会话内命令示例
/model gpt-4o   # 切换模型
/reload         # 热重载扩展
/export         # 导出会话

典型应用场景

1. 个人开发者：终端内快速编码、重构、调试，替代手动敲命令，提升效率；
2. 技术团队：统一终端 AI 助手，自定义团队技能（如内部规范、部署流程），标准化工作流；
3. 自动化脚本：用 Print/JSON 模式集成到 CI/CD、监控、报告生成等自动化流程；
4. 产品嵌入：通过 SDK 将 Pi 集成到自有工具（如 WeSight、OpeClaw），增强 AI 能力；
5. 开源协作：分享会话复现问题、生成文档、辅助 PR 审查，降低协作成本。

总结

pi.dev（Pi Coding Agent）是终端原生、极简内核、高度可定制的 AI 编程 Agent 框架，核心价值是**“最小内核+最大自由”**，让开发者用自然语言定制专属编码工作流，无缝融入终端/脚本/自动化场景。

它不与 IDE 插件竞争，而是互补——适合偏爱终端、追求极致自定义、需要嵌入集成或自动化编码流程的开发者与团队。免费开源、本地优先、多模型支持，是当前终端 AI 编程领域最具潜力的工具之一。