Pi Agent CLI 参考手册
以下是 Pi Agent 所有命令行参数的完整参考。
模式选项
| 参数 | 说明 | 示例 |
|---|
| （默认） | 交互模式，终端 TUI 界面 | pi |
| -p, --print | Print 模式，输出结果后退出 | pi -p "总结代码" |
| --mode json | JSON 模式，所有事件以 JSON 行输出 | pi --mode json -p "总结" |
| --mode rpc | RPC 模式，stdin/stdout JSONL 协议 | pi --mode rpc |
模型选项
| 参数 | 说明 | 示例 |
|---|
| --provider name | 指定 AI 提供商 | --provider anthropic |
| --model pattern | 模型 ID，支持 provider/id 和 :thinking 格式 | --model openai/gpt-4o / --model sonnet:high |
| --api-key key | 直接传入 API Key，优先级最高 | --api-key sk-ant-... |
| --thinking level | 推理等级：off/minimal/low/medium/high/xhigh/max | --thinking high |
| --models patterns | 逗号分隔的模型列表，限制 Ctrl+P 循环 | --models "claude-*,gpt-4o" |
| --list-models | 列出所有可用模型 | --list-models |
会话选项
| 参数 | 说明 | 示例 |
|---|
| -c, --continue | 继续最近的会话 | pi -c |
| -r, --resume | 浏览并选择历史会话 | pi -r |
| --session path|id | 使用指定会话文件或 UUID | --session abc123 |
| --fork path|id | 从指定会话分叉出新会话 | --fork abc123 |
| --session-dir dir | 自定义会话存储目录 | --session-dir .pi/sessions |
| --no-session | 临时模式，不保存会话 | pi --no-session |
| -n, --name name | 设置会话显示名称 | --name "重构认证模块" |
工具选项
| 参数 | 说明 | 示例 |
|---|
| -t, --tools list | 白名单指定工具，逗号分隔 | --tools read,bash,edit,write |
| -xt, --exclude-tools list | 禁用指定工具，逗号分隔 | --exclude-tools bash |
| -nbt, --no-builtin-tools | 禁用所有内置工具，保留扩展工具 | pi --no-builtin-tools |
| -nt, --no-tools | 禁用所有工具，纯对话模式 | pi --no-tools |
资源选项
| 参数 | 说明 | 示例 |
|---|
| -e, --extension source | 加载扩展，可重复使用 | -e ./my-ext.ts -e npm:@foo/bar |
| --no-extensions | 禁用扩展自动发现 | pi --no-extensions |
| --skill path | 加载 Skill，可重复使用 | --skill ./my-skill |
| --no-skills | 禁用 Skill 自动发现 | pi --no-skills |
| --prompt-template path | 加载提示词模板，可重复使用 | --prompt-template ./review.md |
| --no-prompt-templates | 禁用模板自动发现 | pi --no-prompt-templates |
| --theme path | 加载主题，可重复使用 | --theme ./my-theme.json |
| --no-themes | 禁用主题自动发现 | pi --no-themes |
| -nc, --no-context-files | 禁用 AGENTS.md/CLAUDE.md 加载 | pi -nc |
其他选项
| 参数 | 说明 | 示例 |
|---|
| --system-prompt text | 替换默认系统提示词 | --system-prompt "你是 Python 专家" |
| --append-system-prompt text | 追加到系统提示词 | --append-system-prompt "使用中文回复" |
| --verbose | 强制显示详细启动信息 | pi --verbose |
| -a, --approve | 本次运行信任项目本地文件 | pi -a |
| -na, --no-approve | 本次运行不信任项目本地文件 | pi -na |
| -h, --help | 显示帮助信息 | pi -h |
| -v, --version | 显示版本号 | pi -v |
文件参数
使用 @ 前缀引用文件：
$ pi @prompt.md "回答这个问题"
$ pi -p @screenshot.png "图中有什么"
$ pi @src/code.ts @src/test.ts "对比这两个文件"
