Pi 的主要用户产品，整合 pi-agent-core、pi-tui 和完整的扩展体系，提供交互式终端编程 Agent。
安装
npm install -g --ignore-scripts @earendil-works/pi-coding-agent
# 或
curl -fsSL https://pi.dev/install.sh | sh交互界面布局
┌─────────────────────────────┐
│ Startup header │ 快捷键、AGENTS.md、extensions、skills
├─────────────────────────────┤
│ Messages │ 用户消息、助手回复、工具调用/结果
├─────────────────────────────┤
│ Editor │ 输入区，边框颜色表示 thinking level
├─────────────────────────────┤
│ Footer │ 工作目录、会话名、token/成本/context 用量
└─────────────────────────────┘
内置工具
read、write、edit、bash、grep、find、ls
编辑器功能
| 特性 | 操作 |
|---|---|
| 文件引用 | @ 模糊搜索项目文件 |
| 路径补全 | Tab |
| 多行 | Shift+Enter |
| 外部编辑器 | Ctrl+G |
| 粘贴图片 | Ctrl+V |
| Bash 命令 | !command（发给 LLM）/ !!command（不发送） |
常用快捷键
| 键 | 功能 |
|---|---|
| Ctrl+C | 清空编辑器 |
| Ctrl+C × 2 | 退出 |
| Escape | 取消/中止 |
| Escape × 2 | 打开 /tree |
| Ctrl+L | 模型选择器 |
| Ctrl+P | 循环切换预设模型 |
| Shift+Tab | 切换 thinking level |
| Ctrl+O | 折叠/展开工具输出 |
| Ctrl+T | 折叠/展开 thinking blocks |
常用命令
| 命令 | 说明 |
|---|---|
/login, /logout | OAuth 认证 |
/model | 切换模型 |
/settings | 设置（thinking level、主题等） |
/resume | 选择历史会话 |
/tree | 会话树导航 |
/fork | 从历史消息创建新会话 |
/compact [prompt] | 手动压缩 context |
/share | 上传为私有 GitHub gist |
/hotkeys | 显示所有快捷键 |
/skill:name | 调用 Skill |
运行模式
| 模式 | 命令 |
|---|---|
| 交互式（默认） | pi |
| 打印模式 | pi -p "prompt" |
| JSON 事件流 | pi --mode json |
| RPC 模式 | pi --mode rpc |
Context 文件
Pi 在启动时从以下位置加载 AGENTS.md（或 CLAUDE.md）：
~/.pi/agent/AGENTS.md（全局）- 从 cwd 向上遍历各父目录
- 当前目录
用 .pi/SYSTEM.md 替换默认 system prompt，或用 APPEND_SYSTEM.md 追加。
项目信任机制
Pi 在交互启动时对包含项目级配置的目录询问信任决策（/trust 保存、--approve/--no-approve 一次性覆盖）。defaultProjectTrust 可设为 ask、always、never。
相关页面：architecture | extensions | sessions | cli-reference