
### 1. 终端启动/CLI 命令（在 shell 中直接运行）

Pi Mono 的 CLI 入口通常为 `pi-code` 或通过 `npx`/`pnpm` 调用。它支持非交互式的一行命令模式，也支持启动完整的 TUI（终端界面）。

| 命令示例 | 主要作用 | 典型用法/备注 |
| :--- | :--- | :--- |
| `pi-code` | 启动交互式 TUI 会话 | 最常用入口，进入后可与 AI 进行多轮对话，支持工具调用 |
| `pi-code "描述任务"` | 带初始 Prompt 启动会话 | `pi-code "修复这个 bug 并运行测试"` |
| `pi-code -p "查询"` | **非交互式管道模式**（执行后退出） | 适合脚本调用：`cat error.log \| pi-code -p "分析"` |
| `pi-code search "关键词"` | 直接在代码库中搜索逻辑 | 例如 `pi-code search "用户认证逻辑在哪"` |
| `pi-code refactor "目标"` | 执行特定重构任务 | 例如 `pi-code refactor "将类组件转为函数组件"`  |
| `pi-code --model <model>` | 启动时指定模型 | 支持切换不同的 LLM 提供商与模型  |

### 2. 常用全局 Flags（配置与环境）

| Flag | 作用 | 示例 |
| :--- | :--- | :--- |
| `--model <name>` | 指定使用的 AI 模型 | `pi-code --model gpt-4o` |
| `--system-prompt <file>` | 加载自定义系统指令文件 | 支持加载 `SYSTEM.md` 覆盖默认 Prompt  |
| `--dangerously-skip-permissions` | **跳过工具执行确认**（高风险，仅限可信环境） | 自动化脚本中使用，减少人工干预 |
| `--debug` | 开启详细调试日志 | 用于排查 Agent 循环或工具调用问题 |

### 3. 交互模式内 Slash 命令（进入 `pi-code` 后使用）

进入交互模式后，输入 `/` 即可触发各种内部命令。**注意：** 较新版本（≥ v0.29.1）已对命令进行了整合，强化了 `/settings` 统一菜单 。

| Slash 命令 | 主要作用 | 备注/演进说明 |
| :--- | :--- | :--- |
| `/help` | 显示所有可用的 Slash 命令 | 入门必备，随时查看 |
| `/settings` | **统一设置菜单** | **新版核心命令**，整合了以下旧版独立设置项 ：<br>- 思考级别 (Thinking Level)<br>- 主题 (Theme)<br>- 队列模式 (Queue)<br>- 自动压缩 (Auto-compact) |
| `/init` | 初始化项目上下文 | 扫描项目，生成记忆文件 (如 `CLAUDE.md` 或类似) |
| `/clear` | 清空当前会话历史 | 开始全新任务，重置上下文 |
| `/compact` | 压缩对话上下文 | 当会话 token 过多、响应变慢时使用 |
| `/model` | 对话中实时切换模型 | 如从 Haiku 切换到 Sonnet 处理复杂逻辑 |
| `/undo` / `/rewind` | 撤销上一步操作或变更 | 类似 Git 回退，AI 改坏了可以快速恢复状态 |
| `/cost` | 查看当前会话 Token 消耗与预估费用 | 监控使用量 |

### 核心设计哲学对应表

理解 Pi Mono 的命令，关键是理解它的 **四大核心工具**——所有操作最终都是为了驱动这四个能力 ：

| 工具名 | 对应的人类行为 | 典型 CLI 交互场景 |
| :--- | :--- | :--- |
| **Read** | 阅读代码 | AI 自动调用 `read` 分析报错文件 |
| **Write** | 创建新文件 | `pi-code "新建一个 React 组件"` |
| **Edit** | 精确修改 | AI 定位到具体行数进行替换 |
| **Bash** | 执行终端命令 | AI 运行 `npm run test` 验证修改 |
