# Pi Coding Agent

页面：https://maomu.com/p/pi-dev

极简、可自我扩展的终端原生 AI 编程 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. 安装（极简命令）
```bash
# 一键安装（推荐）
curl -fsSL https://pi.dev/install.sh | sh

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

### 2. 启动使用
```bash
# 任意项目目录启动
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 编程领域最具潜力的工具之一。


## 官网入口

https://pi.dev/
