用途
Antigravity CLI（命令名 agy）是 Google 官方推出的命令行 AI 工具，取代此前的 Gemini CLI。该技能面向本地安装的 agy v1.3.0（功能覆盖至 v1.2.17），用于指导 AI 编码智能体、自动化 CI/CD 流水线、编排多智能体集群、配置 Model Context Protocol（MCP）服务器、管理自定义 Markdown 智能体，以及通过 agy CLI 控制工作区环境。
背景：agy 于 2026 年 5 月 19 日在 Google I/O 上发布。Gemini CLI 已于 2026 年 6 月 18 日停止为消费者和免费用户提供服务；使用 Gemini Code Assist Standard/Enterprise 的企业用户可继续使用 Gemini CLI。
主要能力
架构特征：Go 二进制（非 Node.js），启动延迟低、无 npm 依赖、内置嵌入式 ripgrep 引擎；与 Antigravity IDE 桌面应用共享相同的智能体运行框架、运行时与定制引擎；插件系统取代旧版 Gemini CLI 扩展；在 Gemini 模型上单轮最多支持 512 次工具调用。二进制识别：主可执行文件为 agy（部分 Linux 发行版为 antigravity），可通过 ANTIGRAVITY_CLI_ALIAS 环境变量覆盖，默认安装路径通常为 ~/.local/bin/agy。
命令行标志覆盖打印模式、输入/输出格式、JSON Schema、推理强度、权限跳过、沙箱、智能体与模型选择、执行模式、超时、工作区目录、项目上下文、远程控制、日志等。子命令包括：agy mcp（MCP 服务器管理）、agy remote-control（远程守护进程）、agy mic-serve（麦克风音频转发）、agy agent/agents、agy models、agy plugin/plugins、agy install、agy update、agy changelog。
自动化与无头脚本：打印模式（-p）会自动展开斜杠命令与已安装技能；零轮只读命令查询（如 /quota、/usage、/credits、/permissions、/skills）可输出机器可读 JSON，不消耗模型配额；通过 --input-format stream-json 支持 stdin/stdout 上的持续多轮 NDJSON 会话；--json-schema 强制最终输出符合 JSON 模式（根 schema 必须为 "type": "object"）；使用不同退出码区分启动错误（1）、致命 API 错误（3）等，退出码 3 时在 stderr 输出结构化 JSON 错误行。
自定义 Markdown 智能体：使用带 YAML frontmatter 的 Markdown 文件定义主智能体与专用子智能体，存放于项目 .agents/agents/ 或全局 ~/.gemini/config/agents/。frontmatter 字段包括 name、description、mainAgent、subagent、hidden、model、commandExecutionPolicy、inheritCustomizations、excludeDefaultComponents、rules、agents 等。支持 @<subagent-name> 直接派发任务、子智能体目录自动注入、内置图像生成子智能体、隔离 worktrees。
定制系统与令牌预算：用户与工作区规则拥有专用 20,000 令牌预算，超出时按换行边界截断，不会挤占技能、工作流、子智能体或 MCP 工具。清单目录仅加载直属项（可用 include_only 指定子项）。清单文件会在当前工作目录到项目 Git 根之间的每个 .agents/ 目录中合并加载。技能支持图标元数据、静默技能、通过 /skills reload 热重载。
交互界面：支持模态 Vim 编辑（Normal、Insert、Visual、Visual Line，含计数倍率与按键作用域定制）、/model 一次性模型切换、/config 与 /settings 快速导航、消息排队模式等。
使用方式
典型调用为 agy [flags] [prompt]。无头自动化可使用：agy -p "/skill-name 指令" --dangerously-skip-permissions 触发技能；agy -p "/quota" --output-format json 查询配额；持续流式会话可使用 agy -p --input-format stream-json --output-format stream-json。MCP 服务器通过 agy mcp add/list/enable/disable/remove 管理，配置写入 ~/.gemini/config/mcp_config.json。插件通过 agy plugin install/import/enable/disable/validate 管理，存放于 ~/.gemini/config/plugins/。
适用场景
AI 编码智能体引导、CI/CD 流水线自动化、多智能体编排、MCP 服务器配置、自定义智能体与技能管理、工作区环境控制，以及需要结构化输出与脚本化集成的终端工作流。
限制
资料仅覆盖 agy v1.3.0 与 v1.2.17 之前的功能。定价、收费、账户配额的具体数值、支持的操作系统完整列表及其他未在此说明的能力暂未提供。