Pi

如果你习惯在终端里工作——用 Vim 写代码、用 tmux 管理会话、用 bash 执行命令——但又希望引入 AI 辅助，那么 Pi 可能是你需要的工具。

Pi 是一个轻量级、无图形界面的 CLI 编程智能体，专为纯终端环境设计。它不依赖浏览器，不弹出权限窗口，不内置待办事项或计划模式，而是专注于一件事：在命令行中与你协作完成编程任务。

核心特性

✦ 多模型支持，会话中可切换

• 支持 Anthropic、OpenAI、Google、Mistral、Groq、Cerebras、xAI、OpenRouter、ZAI 等主流提供商。
• 可在同一会话中动态切换模型（通过 /model 命令），无需重启。
• 支持自定义模型（如 Ollama、vLLM）通过 models.json 配置。

✦ 真正的终端优先体验

• 所有交互在终端完成，支持：
  • 文件模糊搜索（输入 @ 触发）
  • 路径 Tab 补全
  • 拖放文件到终端
  • 多行粘贴自动折叠但完整发送
  • 内联图片显示（支持 Kitty、iTerm2）

✦ 智能上下文管理

• 树状会话结构：每次回复可分支，形成对话树。
• /branch：从历史消息创建新分支；
• /tree：可视化导航会话历史；
• /compact：手动压缩上下文，避免 token 耗尽。

✦ 安全可控的执行环境

• 支持在消息前加 ! 执行 bash 命令（如 !ls -l），输出作为上下文；
• 不自动执行代码，所有命令需显式触发；
• 不内置“后台执行”或“计划任务”，鼓励用户用 tmux 或容器管理长期任务。

✦ 丰富的快捷操作

通过斜杠命令快速控制：

• /settings：打开设置菜单
• /export：导出为 HTML
• /share：上传为 GitHub 秘密代码片段（需 gh CLI）
• /copy：复制最新代理回复
• /login / /logout：支持 OAuth 登录 Anthropic Pro、GitHub Copilot、Gemini 等

安装与配置

安装方式（三选一）

# 1. npm（推荐）
npm install -  g @mariozechner/pi-coding-agent

# 2. 二进制文件
从 GitHub Releases 下载解压即用（macOS 需运行 `xattr -c ./pi`）

# 3. 从源码构建（需 Bun 1.0+）
git clone https://github.com/badlogic/pi-mono.git
cd pi-mono && npm install
cd packages/coding-agent && npm run build:binary

Windows 支持

• 需要 bash 环境（如 Git for Windows、WSL、MSYS2）；
• 默认优先使用 Git Bash，也可在 settings.json 中指定自定义 shell 路径。

认证方式

• 推荐：将 API 密钥写入 ~/.pi/agent/auth.json
• 备用：通过环境变量（如 ANTHROPIC_API_KEY）
• OAuth：运行 /login 通过浏览器认证，凭证自动保存

会话与上下文管理

• 会话以 JSONL 文件存储，支持版本回溯；
• 启动时自动加载项目中的 AGENTS.md 或 SYSTEM.md 作为上下文；
• 可通过 --resume 选择历史会话，--continue 恢复最近一次，--no-session 启动临时会话。

扩展与自定义

• 提示模板：在 ~/.pi/agent/prompts/ 中定义可复用命令；
• 主题：内置深色/浅色，支持自定义；
• 扩展（Extensions）：用 TypeScript 编写模块，可添加工具、拦截事件、集成外部服务；
• 技能（Skills）：遵循 Agent Skills 标准，按需加载能力包；
• SDK 与 RPC：支持在 Node.js 应用中嵌入，或通过 --mode rpc 以 JSON 通信。

设计哲学：克制与专注

Pi 明确不做以下事情：

• ❌ 不内置 MCP（Model Context Protocol）
• ❌ 不支持子代理或代理链
• ❌ 不弹出权限请求窗口
• ❌ 不提供内置待办事项或计划模式
• ❌ 不自动后台执行 bash

开发者认为：这些功能应由操作系统原语（如容器、tmux、cron）或用户自定义扩展实现，而非塞进代理本身。

适用人群

• 终端重度用户：Vim/Neovim、tmux、zsh 用户
• 远程开发：SSH 到服务器后仍需 AI 辅助
• 轻量级工作流：拒绝臃肿 IDE，追求命令行效率
• 多模型实验者：需要在 Anthropic、Gemini、Ollama 间快速切换