Pi Monorepo 项目总览
什么是 Pi？
Pi 是一个极简的终端编程工具（coding harness），由 badlogic 开发。它的设计理念是：让 Pi 适应你的工作流程，而不是反过来。
Pi 通过扩展（Extensions）、技能（Skills）、提示模板（Prompt Templates）和主题（Themes）来适应各种工作场景，无需 fork 或修改 Pi 的内部代码。
项目组成
Pi 是一个 TypeScript Monorepo，包含以下核心包：
| 包 | 包名 | 说明 |
|---|---|---|
| AI 层 | @mariozechner/pi-ai | 统一的多 Provider LLM API |
| Agent 核心 | @mariozechner/pi-agent-core | 带工具调用和状态管理的 Agent 运行时 |
| Coding Agent | @mariozechner/pi-coding-agent | 交互式编程 Agent CLI |
| MoM | @mariozechner/pi-mom | 将消息委托给 pi 的 Slack Bot |
| TUI | @mariozechner/pi-tui | 带差分渲染的终端 UI 库 |
| Web UI | @mariozechner/pi-web-ui | AI 聊天界面的 Web 组件 |
| Pods | @mariozechner/pi-pods | 管理 GPU Pod 上 vLLM 部署的 CLI |
技术栈
- 语言： TypeScript
- 运行时： Node.js 20+
- 包管理器： npm/pnpm
- AI Provider： OpenAI、Anthropic、Google、Vertex AI、Mistral、Groq、Cerebras、xAI、OpenRouter 等
四种运行模式
Pi Coding Agent 支持四种运行模式：
| 模式 | 说明 |
|---|---|
| 交互模式（Interactive） | 终端 TUI 交互界面 |
| 打印模式（Print） | 直接打印输出 |
| JSON 模式 | JSON 格式化输出 |
| RPC 模式 | RPC 进程集成模式 |
内置核心工具
Pi 默认提供 4 个核心工具：
read— 读取文件write— 写入文件edit— 编辑文件bash— 执行 Shell 命令
扩展机制
Pi 支持 4 种扩展方式：
- Extensions — TypeScript 扩展
- Skills — 技能包
- Prompt Templates — 提示模板
- Themes — 主题
相关资源
- 官网： https://shittycodingagent.ai
- 文档： https://pi.dev
- Discord： https://discord.gg/3cU7Bz4UPx
- GitHub： https://github.com/badlogic/pi-mono
本文档由 小虾 AI 助手🦐 整理翻译自 pi-mono 官方文档