pi [options] [@files...] [messages...]
包管理命令
pi install <source> [-l] # 安装包，-l 为项目级安装
pi remove <source> [-l] # 删除包
pi uninstall <source> [-l] # remove 的别名
pi update [source] # 更新 pi 本身
pi update --all # 更新 pi 和所有包
pi update --extensions # 只更新包
pi update --self # 只更新 pi
pi update --self --force # 强制重装 pi
pi update npm:@foo/pi-tools # 更新单个包
pi list # 列出已安装包
pi config # 启用/禁用包资源
运行模式
| 参数 | 说明 |
|---|
| (默认) | 交互式 TUI 模式 |
-p, --print | 打印响应后退出 |
--mode json | 输出所有事件为 JSON lines |
--mode rpc | RPC 模式，进程间集成 |
--export <in> [out] | 导出会话为 HTML |
模型选项
| 参数 | 说明 |
|---|
--provider <name> | 指定 Provider |
--model <pattern> | 模型 pattern 或 ID（支持 provider/id 和 :<thinking>） |
--api-key <key> | API Key（覆盖环境变量） |
--thinking <level> | off/minimal/low/medium/high/xhigh |
--models <patterns> | 逗号分隔，供 Ctrl+P 循环的模型列表 |
--list-models [search] | 列出可用模型 |
会话选项
| 参数 | 说明 |
|---|
-c, --continue | 继续最近的会话 |
-r, --resume | 浏览并选择会话 |
--session <path|id> | 使用指定会话文件或 UUID 前缀 |
--fork <path|id> | Fork 指定会话为新会话 |
--session-dir <dir> | 自定义会话存储目录 |
--no-session | 临时模式（不保存） |
-n, --name <name> | 启动时设置会话显示名 |
工具选项
| 参数 | 说明 |
|---|
--tools <list>, -t | 白名单：只允许指定工具 |
--exclude-tools <list>, -xt | 禁用指定工具 |
--no-builtin-tools, -nbt | 禁用内置工具（保留扩展工具） |
--no-tools, -nt | 禁用所有工具 |
内置工具：read、bash、edit、write、grep、find、ls
资源选项
| 参数 | 说明 |
|---|
-e, --extension <source> | 加载扩展（路径/npm/git，可重复） |
--no-extensions | 禁用扩展发现 |
--skill <path> | 加载 Skill（可重复） |
--no-skills | 禁用 Skill 发现 |
--prompt-template <path> | 加载 Prompt 模板（可重复） |
--no-prompt-templates | 禁用 Prompt 模板发现 |
--theme <path> | 加载主题（可重复） |
--no-themes | 禁用主题发现 |
--no-context-files, -nc | 禁用 AGENTS.md/CLAUDE.md 发现 |
组合示例（只加载指定资源，忽略 settings.json 中的配置）：
pi --no-extensions -e ./my-ext.ts
其他选项
| 参数 | 说明 |
|---|
--approve, -a | 信任项目级设置（一次性） |
--no-approve, -na | 忽略项目级设置（一次性） |
--offline | 禁用所有启动网络操作 |
--version | 显示版本 |
--help | 显示帮助 |
相关页面：quick-start | settings | sessions