---
url: /antigravity/cli-reference.md
description: 快速查阅所有 TUI 斜杠命令、默认键盘快捷键和 JSON 配置参数。
---

# CLI 参考 (CLI Reference)

快速查阅所有 TUI 斜杠命令、默认键盘快捷键和 JSON 配置参数。

## 核心斜杠命令 (Core slash commands)

在提示框内输入 `/` 即可打开自动补全命令选择菜单。

| 命令 (Command) | 类别 (Category) | 别名 (Alias) | 执行用途 (Execution Purpose) |
| :--- | :--- | :--- | :--- |
| **/add-dir \<path>** | 实用工具 | — | 向活跃工作空间添加目录路径。 |
| **/agents** | 工具与任务 | — | 打开 Agent 管理器面板以监控后台子 Agent。 |
| **/btw \<query>** | 实用工具 | — | 在后台提问一个旁侧问题，而不打断主对话。 |
| **/clear** | 实用工具 | — | 清空终端并重置活跃的对话上下文。 |
| **/config** | 配置 | `/settings` | 打开交互式设置编辑器浮层。 |
| **/diff** | 实用工具 | — | 显示所有被修改工作空间文件的统一 Diff。 |
| **/exit** | 核心 | — | 关闭 TUI 会话并恢复您的宿主 Shell。 |
| **/fast** | 配置 | — | 启用快速模式（跳过推理规划）以执行快速操作。 |
| **/fork** | 对话 | `/branch` | 将当前对话线程克隆到一个新的并行会话中。 |
| **/hooks** | 工具与任务 | — | 浏览活跃的预检/后置格式化脚本钩子。 |
| **/keybindings** | 配置 | — | 打开交互式快捷键编辑器。 |
| **/logout** | 账户 | — | 断开您的个人资料连接并从安全密钥环中清除认证 Token。 |
| **/mcp** | 工具与任务 | — | 打开模型上下文协议 (MCP) 服务端管理器。 |
| **/model** | 配置 | — | 选择您偏好的推理模型（跨会话持久化）。 |
| **/open \<path>** | 实用工具 | — | 强制在您系统默认的编辑器中打开路径。 |
| **/permissions** | 配置 | — | 在全局权限预设（`request-review`、`always-proceed`、`strict`）之间进行切换。 |
| **/planning** | 配置 | — | 启用针对复杂工程任务的多轮计划生成模式。 |
| **/rename \<name>** | 对话 | — | 重命名当前会话线程。 |
| **/resume** | 对话 | `/switch`, `/conversation` | 打开对话选择器浮层以选择并加载先前的线程。 |
| **/rewind** | 对话 | `/undo` | 将您的对话历史回滚到先前的消息。 |
| **/skills** | 工具与任务 | — | 浏览已加载的本地和全局 Agent 技能包。 |
| **/statusline** | 配置 | — | 打开状态栏自定义浮层。 |
| **/tasks** | 工具与任务 | — | 打开任务管理器面板以监控后台 Shell 执行日志。 |
| **/title \[on/off]** | 配置 | — | 切换或设置终端窗口标题更新。 |
| **/usage** | 实用工具 | — | 在终端内启动离线开发者帮助手册。 |

## 默认按键绑定 (Default keybindings)

键盘快捷键命令涵盖了全局控制、提示框输入、导航以及审批操作。

### 全局控制

无论当前聚焦的是哪个面板、浮层或提示框，这些快捷键始终处于活动状态。

| 按键 (Key) | TUI 命令 | 动作行为 (Action Behavior) |
| :--- | :--- | :--- |
| **Esc** | `cli.escape` | 关闭活动面板、中止活动流，或清空空白提示词。 |
| **Ctrl+C** | `cli.exit` | 终止 CLI 会话（如果 Agent 正在工作，则提示确认）。 |
| **Ctrl+L** | `cli.clear_screen` | 刷新并清除可视终端缓冲区。 |

### 提示框输入按键

在提示框内编写指令时，这些按键处于活动状态。

| 按键 (Key) | TUI 命令 | 动作行为 (Action Behavior) |
| :--- | :--- | :--- |
| **Enter** | `prompt.submit` | 将您的提示词或活动菜单选择提交给 Agent。 |
| **Shift+Enter / Ctrl+J** | `prompt.newline` | 插入一个干净的换行符而不提交。 |
| **Ctrl+V** | `prompt.paste` | 将图形媒体文件或剪贴板内容粘贴到提示词中。 |
| **Ctrl+O** | `prompt.toggle_trajectory` | 展开或折叠详细的工具推理输出。 |
| **Ctrl+R** | `prompt.open_review` | 打开产物审查面板。 |
| **Ctrl+G** | `prompt.external_editor` | 启动您默认的 `$EDITOR` Shell 来撰写提示词。 |
| **Alt+J** | `prompt.teleport_agent` | 立即将焦点切换到下一个等待确认的子 Agent。 |
| **Ctrl+K** | `prompt.fast_approve` | 立即批准状态警报中列出的待处理子 Agent 操作。 |
| **Ctrl+A** | `prompt.cursor_start` | 将提示词插入光标移动到行首。 |
| **Ctrl+E** | `prompt.cursor_end` | 将提示词插入光标移动到行尾。 |
| **Ctrl+Z** | `prompt.undo_text` | 撤销上一次编辑。 |
| **Ctrl+Shift+Z** | `prompt.redo_text` | 重做上一次撤销的文本操作。 |

### 导航与滚动

用于选择面板、菜单和可滚动的文本框中。

| 按键 (Key) | TUI 命令 | 动作行为 (Action Behavior) |
| :--- | :--- | :--- |
| **↑ / ↓** | `navigation.up` / `navigation.down` | 将高亮选择项向上或向下滚动一个条目。 |
| **PgUp / Shift+↑** | `navigation.page_up` | 将活动文本视口向上滚动一个页面块。 |
| **PgDn / Shift+↓** | `navigation.page_down` | 将活动文本视口向下滚动一个页面块。 |
| **← / →** | `navigation.left` / `navigation.right` | 在多页结构（如会话选择器）内切换页面。 |
| **Tab** | `navigation.tab` | 确认高亮的斜杠命令自动填充选项。 |

### 工具确认

在确认提示期间处于活动状态。

| 按键 (Key) | TUI 命令 | 动作行为 (Action Behavior) |
| :--- | :--- | :--- |
| **y** | `confirm.yes` | 授权所提议的工具、命令或活动产物。 |
| **n** | `confirm.no` | 拒绝所提议的工具、命令或活动产物。 |
| **A** | — | （在审查面板内）一键批准所有生成的产物（内置快捷键）。 |

## 配置项键名 (`settings.json`)

主要的设置键名、数据类型、系统默认值和预期参数。

| 配置键名 (Option Key Name) | 值类型 (Value Type) | 系统默认值 (System Default) | 参数特性与选项 (Parameter Characteristics & Options) |
| :--- | :--- | :--- | :--- |
| **colorScheme** | `string` | `"terminal"` | 配色方案：`"light"`、`"solarized light"`、`"colorblind-friendly light"`、`"dark"`、`"solarized dark"`、`"colorblind-friendly dark"`、`"tokyo night"` 或 `"terminal"`（继承原生 Shell 颜色）。 |
| **altScreenMode** | `string` | `"default"` | 屏幕缓冲区使用：`"default"`（原生终端行内模式）、`"always"`（使用备用屏幕无闪烁缓冲区）。 |
| **toolPermission** | `string` | `"request-review"` | 全局安全预设：`"request-review"`（对写入/Bash/网页工具进行提示）、`"proceed-in-sandbox"`（在沙箱内自动执行）、`"always-proceed"`（从不提示）或 `"strict"`（对所有非读取工具进行提示）。 |
| **artifactReviewPolicy** | `string` | `"asks-for-review"` | 代码审查策略：`"asks-for-review"`（在写入代码前始终提示）、`"agent-decides"`（动态提示）或 `"always-proceed"`（从不提示）。 |
| **notifications** | `boolean` | `false` | 在任务完成时发出系统桌面和终端铃声通知。 |
| **showTips** | `boolean` | `true` | 在生成轮次期间在提示面板上方显示有用的 Agent 提示。 |
| **showFeedbackSurvey** | `boolean` | `true` | 在活动任务完成时定期显示质量反馈调查。 |
| **editor** | `string` | `"auto"` | 目标文本编辑器工具：`"auto"`（参考系统 `$EDITOR`）、`"vim"`、`"emacs"` 或自定义文本标识。 |
| **allowNonWorkspaceAccess** | `boolean` | `false` | 允许 Agent 的文件读取和写入工具导航到已识别的 Git/工作空间根目录之外。 |
| **enableTerminalSandbox** | `boolean` | `false` | 将 Agent 启动的所有本地执行命令限制在操作系统容器化隔离环内。 |
| **enableTelemetry** | `boolean` | `true` | 允许收集指标和崩溃日志流，以提高工具的可靠性。 |
| **verbosity** | `string` | `"high"` | 视觉详细程度：`"high"`（呈现完整的思考和工具输出）或 `"low"`（仅显示最少的视觉进度指示器）。 |
| **runningLightSpeed** | `string` | `"medium"` | 视觉跑马灯进度动画速度：`"fast"`、`"medium"`、`"slow"` 或 `"off"`。 |

## 下一步 (Next Steps)

了解如何安全地部署权限策略、沙箱以及自定义插件：

* **权限与沙箱 (Permissions & Sandbox)**：强制执行命令行隔离规则。
* **插件与技能 (Plugins & Skills)**：创建您自己的自定义斜杠命令。
* **安装与身份验证 (Installation & Auth)**：更新您的 CLI 安装。