CHEATSHEET
Pi 速查表
斜杠命令、CLI 参数、编辑器技巧、默认快捷键，一页全收录。内容依据 Pi 官方文档（usage / keybindings）整理，适合收藏后随用随查。
SLASH COMMANDS
斜杠命令
在编辑器里输入 / 会弹出命令补全。扩展可以注册自定义命令，技能以 /skill:名称 调用，提示词模板以 /模板名 展开。
会话管理
/new开一个新会话
/resume从历史会话里选一个继续
/name <名称>给当前会话起显示名，方便日后查找
/session查看会话文件、ID、消息数、Token 用量和花费
/tree打开会话树视图，跳到任意历史节点继续从中间节点继续会产生新分支，原分支保留
/fork从某条更早的用户消息分叉出一个新会话
/clone把当前活跃分支复制成一个新会话
/compact [提示]手动压缩上下文，可附带指令告诉它保留什么重点
模型与凭证
/login, /logout管理 OAuth 或 API Key 凭证
/model打开模型切换器
/scoped-models设置哪些模型参与 Ctrl+P 循环切换
/settings思考强度、主题、消息送达方式、TUI 模式等设置
/llama下载、加载、卸载 llama.cpp 本地模型
导出与分享
/copy复制最后一条助手消息到剪贴板
/export [文件]把会话导出为 HTML 或 JSONL
/import <文件>从 JSONL 文件导入并恢复会话
/share上传为私有 GitHub Gist，生成可分享的 HTML 链接
系统与其他
/reload重载快捷键、扩展、技能、提示词模板、主题和上下文文件改完配置不用重启会话
/trust保存当前项目的信任决策（写入 trust.json）
/hotkeys显示所有快捷键
/changelog查看版本更新历史
/quit退出 Pi
BUILT-IN TOOLS
内置工具
Pi 默认只给模型四个工具，其余按需用 --tools 开启——这正是第 4 章「工具系统」讲的极简工具集设计。
read读文件（默认启用）
write创建 / 覆盖文件（默认启用）
edit局部补丁修改（默认启用）
bash执行 shell 命令（默认启用）
grep / find / ls搜索与列目录（需用 --tools 显式开启）
CLI REFERENCE
CLI 参数
pi [选项] [@文件...] [消息...]——四种运行模式覆盖日常编码、脚本自动化、RPC 集成和 SDK 嵌入。
运行模式
pi交互式模式（默认），完整终端 UI
-p, --print打印回复后退出，一次性执行可接管道：cat README.md | pi -p "总结这段文字"
--mode json以 JSON 行输出全部事件流，适合脚本集成
--mode rpcstdin/stdout JSONL 协议的 RPC 模式，供非 Node 程序集成
--export <输入> [输出]把会话文件导出为 HTML
会话选项
-c, --continue继续最近一次会话
-r, --resume浏览并选择一个历史会话
--session <路径|ID>打开指定会话文件或会话 ID（支持部分 UUID）
--fork <路径|ID>把某个会话分叉成一个新会话文件
--no-session临时会话，不保存
-n, --name <名称>启动时设置会话显示名
--session-dir <目录>自定义会话存储目录
模型选项
--provider <名称>指定供应商，如 anthropic、openai、google
--model <模式>模型 ID 或模式，支持 provider/id 前缀和 :<思考等级> 后缀例：pi --model openai/gpt-4o、pi --model sonnet:high
--api-key <key>直接传 API Key，覆盖环境变量
--thinking <等级>off / minimal / low / medium / high / xhigh / max
--models <模式列表>逗号分隔，限定 Ctrl+P 循环的模型范围
--list-models [关键词]列出可用模型
工具开关
-t, --tools <列表>白名单：只允许列出的工具只读审查：pi --tools read,grep,find,ls -p "审查代码"
-xt, --exclude-tools <列表>禁用指定工具，其余保留
-nbt, --no-builtin-tools关闭所有内置工具，只保留扩展提供的工具
-nt, --no-tools完全禁用工具，纯对话
资源加载
-e, --extension <来源>加载扩展（路径 / npm / git），可重复
--skill <路径>加载技能，可重复
--prompt-template <路径>加载提示词模板，可重复
--theme <路径>加载主题，可重复
--no-extensions / --no-skills / --no-themes关闭对应的自动发现机制
-nc, --no-context-files不加载 AGENTS.md / CLAUDE.md 上下文文件
其他常用
--system-prompt <文本>替换默认系统提示词（上下文文件和技能仍会追加）
--append-system-prompt <文本>在默认系统提示词后追加内容
-a, --approve本次运行信任项目级文件（跳过信任询问）
-na, --no-approve本次运行忽略项目级文件
@文件把文件内容带进消息：pi @code.ts "审查这个文件"
-v, --version / -h, --help查看版本 / 帮助
包管理（pi packages）
pi install <来源> [-l]安装扩展/技能/主题包，-l 装到项目级来源可以是 npm:包名 或 git:仓库地址
pi remove <来源> [-l]移除包（uninstall 是别名）
pi update --all更新 pi 本体和全部包
pi update --self只更新 pi 本体
pi update --models只刷新模型目录
pi list列出已安装的包
pi config启用/禁用包内资源
EDITOR
编辑器技巧
几个容易被忽略但很提效的内置能力。
@模糊搜索并引用项目文件，随消息一起发给模型
Tab路径补全
Shift+Enter多行输入（Windows Terminal 用 Ctrl+Enter）
Ctrl+X复制最后一条助手消息；在 /tree 里复制选中的消息
Ctrl+V粘贴图片或文本（Windows 用 Alt+V），也可以直接把图拖进终端
!命令执行 shell 命令，并把输出发给模型如 !git status，让模型看到当前仓库状态
!!命令执行 shell 命令但不发给模型（隐藏执行）
Ctrl+G在外部编辑器里写长 prompt（$VISUAL / $EDITOR）
KEYBINDINGS
默认快捷键
所有快捷键都可以在 ~/.pi/agent/keybindings.json 里自定义，改完用 /reload 生效，不用重启会话。
全局
Esc中断当前执行，并把排队消息退回编辑器
Ctrl+C第一次清空编辑器，第二次退出
Ctrl+D编辑器为空时退出
Ctrl+Z挂起到后台（Windows 无此绑定），fg 恢复
模型与思考
Ctrl+L打开模型选择器
Ctrl+P循环切换到下一个模型
Shift+Ctrl+P循环切换到上一个模型
Shift+Tab循环切换思考等级（编辑器边框颜色会跟着变）
Ctrl+T折叠 / 展开思考块
消息队列（agent 还在干活时）
Enter排队 steering 消息：当前这轮工具调用结束后立即插入
Alt+Enter排队 follow-up 消息：等 agent 全部做完再发
Alt+Up把排队的消息取回编辑器
显示与复制
Ctrl+O折叠 / 展开工具输出
Ctrl+X复制最后一条助手消息
Ctrl+P（/tree 内）切换路径显示；Ctrl+S 切换排序；Ctrl+N 只看命名会话
行编辑（Emacs 风）
Ctrl+A / Ctrl+E光标到行首 / 行尾
Ctrl+W向前删除一个词（Alt+Backspace 同效）
Ctrl+U / Ctrl+K删到行首 / 删到行尾
Ctrl+Y粘贴最近一次删除的文本；Alt+Y 循环更早的删除
Ctrl+-撤销上一次编辑
Alt+B / Alt+F按词左移 / 右移光标