反重力 CLI 功能

插件

插件如何工作 插件是命名空间包，可以包含技能、代理、规则、MCP 服务器和挂钩作为单个可部署单元。当您安装插件时，CLI 将文件暂存在您的主目录中的 ~/.gemini/antigravity-cli/plugins/<plugin_name>/ 下。反重力代理会自动发现并加载这些分阶段的自定义。

~/.gemini/antigravity-cli/
├── plugins/
│└── <plugin_name>/
│├── plugin.json         # Required marker file
│├── mcp_config.json     # Optional MCP server definitions
│├── hooks.json          # Optional event hooks definition
│├── skills/             # Optional skills
│├── agents/             # Optional subagents
│└── rules/              # Optional rules
└── import_manifest.json        # Tracking manifest

访问插件组件 暂存和加载后，您可以使用斜杠命令与 CLI 内的插件组件进行交互。

终端沙箱终端沙箱是一种轻量级安全隔离机制，可在代理执行本地 shell 命令时保护您的主机系统免受潜在破坏性文件操作或未经授权的出站网络请求的影响。

CLI 不是运行繁重的虚拟机或容器，而是利用本机操作系统功能（Linux 上的 nsjail 、macOS 上的 sandbox-exec 和 Windows 上的 AppContainer ）以零启动开销强制执行严格的包含边界。

配置 您可以在 settings.json 文件（位于 ~/.gemini/antigravity-cli/settings.json ）中配置沙箱行为：

{
  "enableTerminalSandbox": true
}
  • ** enableTerminalSandbox ** （布尔值，默认值： false ）：在所有本地代理进程上启用常规执行遏制屏障。

交互式批准 当代理提出需要您确认的终端命令时，CLI 提示符会根据您的设置动态调整：

  • 启用沙箱时：如果您需要暂时绕过单个受信任命令的遏制边界，确认提示将包含一个特定选项是，并且在没有沙箱限制的情况下运行。
  • 当沙箱被禁用时：如果您想强制在安全边界内执行特定的、有潜在风险的命令，提示将包含一个选项“是，并在沙箱中运行”。

CLI 斜线命令参考

Antigravity CLI 支持直接在提示框中输入各种斜杠命令来管理对话、配置设置和检查代理功能。

核心斜线命令

命令 类别 目的
** /resume ** （别名 /switch ） 对话 打开对话选择器以恢复或切换会话。
** /rewind ** （别名 /undo ） 对话 将对话历史记录回滚到之前的检查点。
** /rename <name> ** 对话 重命名活动对话线程以便于跟踪。
** /permissions ** 配置 选择代理自治级别（ request-review 、 always-proceed 或 strict ）。
** /model ** 配置 选择默认推理模型（跨会话持续）。
** /keybindings ** 配置 打开交互式键盘快捷键编辑器。
** /statusline ** 配置 自定义 CLI 状态栏中显示的实时指示器。
** /tasks ** 工具和监控 监视、查看日志或终止活动的后台任务。
** /skills ** 工具和监控 浏览本地和全局封装代理工作流程。
** /mcp ** 工具和监控 打开面板以配置和管理模型上下文协议服务器。
** /open <path> ** 实用程序 立即在您喜欢的外部编辑器中打开文件。
** /usage ** 实用程序 打开终端内的内联交互式帮助手册。
** /logout ** 账户 注销您的 Google 会话并清除缓存的凭据。

通过 settings.json 进行高级定制对于高级用户，多个斜杠命令支持通过 ~/.gemini/antigravity-cli/settings.json 配置进行深度自定义：

  • 细粒度权限：定义特定的允许/拒绝命令，而不是全局级别：

json "permissions": { "allow": ["command(git)", "command(npm test)"], "deny": ["command(rm -rf)"] }

  • 自定义状态行和窗口标题：您可以将实时代理元数据（包含 CWD、活动模型、令牌使用、状态等的 JSON 格式）直接传输到您自己的自定义 shell 脚本中，以生成动态状态栏或终端窗口标题。

反重力 CLI 中的子代理

Antigravity CLI 具有异步子代理框架，允许主代理委托并行工作、执行背景研究并运行系统测试，而不会阻止您的活动对话。

什么是子代理？ 子代理是独立的并发代理会话，旨在与主对话并行处理特定的后台任务。

  • 用途：主代理自动生成子代理来执行后台操作，例如查找文档、运行构建或验证修复。
  • 功能：子代理可以完全访问代码搜索、文件编辑、终端命令和网络搜索等工具，以完成分配的任务。
  • 主代理决定子代理获得哪些工具和权限，包括是否可以使用 MCP 工具以及是否可以写入文件。

管理代理： /agents 面板

Antigravity CLI 提供交互式终端 UI，用于查看、管理和批准运行子代理的操作。

  • 访问：在提示中键入 /agents 以打开子代理面板。
  • 概述：该面板显示活动和已完成的子代理的列表，包括表面级别的详细信息，例如它们的状态（正在运行、完成、已终止等）以及它们正在执行的当前步骤。

<公告> 图标：信息 iconColor: var(--主题-primary) 颜色：var(--主题-表面-表面-容器) 文本：从面板中选择子代理将打开全屏详细信息视图。此视图显示子代理的整个对话，包括其步骤、想法和工具执行日志。 </公告>

工具确认和批准 当子代理想要执行需要用户权限的工具（例如运行本地命令或写入文件）时，它将显示该请求。您可以通过两种方式管理审批：

  1. 详细视图批准 子代理详细信息视图具有包含所有待批准的交互部分，您可以在其中有选择地批准或拒绝请求。

<公告> 图标：灯泡 iconColor: var(--主题-primary) 颜色：var(--主题-表面-表面-容器) 文本： 提示：使用键盘快捷键 ctrl+j 从主对话直接“传送”到等待您批准的下一个子代​​理的详细视图。 </公告>

  1. 快速路径警报 为了让您保持在流程中，当子代理请求权限时，Antigravity CLI 会在提示框正上方显示快速路径警报。

<公告> 图标：灯泡 iconColor: var(--主题-primary) 颜色：var(--主题-表面-表面-容器) 文本： 提示：您可以使用 ctrl+k 立即批准待处理的子代理权限，而无需离开主对话。 </公告>