Antigravity CLI (agy) 常用命令与配置速查表

Antigravity CLI (agy) 是 Google Antigravity 2.0 生态下的轻量级终端原生智能体工具（采用 Go 重写），支持并发子智能体编排、Git Worktree 隔离、Agent Skills、插件生态与 MCP 协议，全面接替原个人版 Gemini CLI。

本速查表梳理 agy CLI 启动参数与子命令、交互式斜杠命令、快捷键、.agents/ 与 mcp_config.json 配置体系，以及从 Gemini CLI 平滑迁移的重点排坑项。

🔗 相关矩阵速查：三大终端 AI 编程 CLI 横向对比速查表 · Claude Code 常用命令与 CLI 全景速查表 · OpenAI Codex CLI 常用命令与配置速查表 · AI Agent Skill 核心架构与开发速查表

1. 安装、子命令与 CLI 启动参数

1.1 安装与初始化

# 安装 Antigravity CLI
curl -fsSL https://antigravity.google/cli/install.sh | bash

# 启动交互式 TUI（首次运行按屏幕提示完成认证）
agy

1.2 核心子命令与启动选项

2. 交互式内置斜杠命令速查 (Slash Commands)

进入 agy 交互界面后输入 / 即可触发命令与自动补全：

2.1 基础控制、会话与历史管理

2.2 模型、工作流、Agent 与扩展管理

3. 终端快捷键与输入语法速查

4. 配置文件体系与 mcp_config.json 规范

4.1 全局与工作区目录映射

⚠️ 远程 MCP 配置关键变更（serverUrl）：mcp_config.json 配置远程 HTTP MCP 服务器时不再支持 url 或 httpUrl，必须使用 serverUrl 字段，否则会出现静默无法连接。

{
  "mcpServers": {
    "remote-docs": {
      "serverUrl": "https://docsmcp.googleapis.com/mcp/v1",
      "oauth": {
        "clientId": "OAUTH_CLIENT_ID",
        "clientSecret": "OAUTH_CLIENT_SECRET"
      }
    },
    "local-tool": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://mcp.example.com/mcp"]
    }
  }
}

5. 从 Gemini CLI 迁移至 agy 快速对照

自 2026 年 6 月 18 日起，面向个人免费版及 Google AI Pro / Ultra 订阅的旧版 Gemini CLI 已停止请求处理（仅保留企业级 Gemini Code Assist 或按量 API Key 存量场景）。升级至 agy 的核心差异如下：