Antigravity CLI 深度解析

在 2026 年 5 月 19 日 的 Google I/O 大会上，Gemini CLI 团队宣布该产品将转型为一款新产品： Antigravity CLI。该版本使用 Go 语言重写，设计目标是键盘优先的远程办公，其背后的智能体驱动程序与 Antigravity 2.0 桌面应用相同。如果您一直在 Google AI Pro 或 Ultra 账号上使用 Gemini CLI，您大约有 30 天的时间进行切换，之后请求将在以下日期停止服务： 2026 年 6 月 18 日。

1. 官方公告

上述推文来自负责发布 Google 官方 Gemini CLI 的团队。这并不是在宣布一项功能更新，而是在宣布一次产品更迭。5 月 19 日发布的系列内容依次为：一篇题为 “ 的 Google 开发者博客文章。重要更新：将 Gemini CLI 迁移至 Antigravity CLI”，以及发布在 antigravity.google 的 Antigravity CLI 发布博客， Antigravity 2.0的发布博客，以及位于 github.com/google-antigravity/antigravity-cli的公开 GitHub 仓库。

综合来看，其意图非常明确：Google 已决定弃用 “Gemini CLI” 这一产品名称，并将整个开发者代理领域统一到 Antigravity 品牌下。CLI 是四个产品形态之一；另外三个分别是 Antigravity 2.0（桌面 GUI）、Antigravity SDK（编程接口）和 Antigravity IDE（目前仍在发布中）。

2. 摘要

• 产品： Antigravity CLI — 一个终端 UI 代理客户端
• 替代对象： Gemini CLI（面向个人层级用户）
• 语言： Go (Gemini CLI 原为 Node)
• 共享底座： 与 Antigravity 2.0 相同的智能体引擎
• 安装方式： macOS, Linux, Windows (curl, PowerShell 或 CMD)
• 身份验证： 系统密钥环，支持 Google 登录回退方案；支持 SSH 感知
• 支持： 插件、智能体技能、MCP 服务器、hooks、子智能体
• 异步： CLI 编排并行的后台子智能体
• 源码： 公开仓库位于 google-antigravity/antigravity-cli
• 迁移： agy plugin import gemini 将扩展转换为插件
• Gemini CLI 停止服务： 个人层级账户截止日期为 2026 年 6 月 18 日
• 企业版例外： Gemini CLI 将继续支持 Code Assist 标准版/企业版及付费 API 密钥

3. 什么是 Antigravity CLI

根据官方概览页面的描述： Antigravity CLI 是 Antigravity 的轻量级终端用户界面（TUI）。它将与 Antigravity 2.0 相同的核心智能体能力 — 多步推理、多文件编辑、工具调用和对话历史 — 直接带到了你的终端。

Google AI Developers 账号在同一天发布了该产品的演示视频，并将其定位浓缩为一句话：

具体来说，这意味着三件事：

• 它是一个 TUI，而不是 GUI。 Antigravity CLI 旨在通过终端驱动，而不是通过鼠标点击。README 明确指出，它 “针对键盘驱动的工作流和远程 SSH 会话进行了优化，且资源开销极低。”
• 它与 Antigravity 2.0 共享同一个智能体引擎。 该 CLI 运行的并不是独立的模型或精简版的智能体。它运行的是与桌面应用程序相同的核心智能体框架（agent harness），只是表现层不同。
• 它的定位是与 2.0 版本并行使用。 You can export a CLI conversation into Antigravity 2.0 to continue working with a richer GUI. Settings and permissions sync bidirectionally.

4. 四界面平台

在本周之前，“Antigravity” 指的是一个 IDE。而在 2026 年 5 月 19 日之后，它意味着一个拥有四个界面的平台，所有界面都由同一个核心智能体框架支持。Google DeepMind 在当天早些时候的一条推文中概括了其中三个：

加上原有的 Antigravity IDE，以下是完整的四界面版图：

• Antigravity 2.0 — 适用于 macOS、Linux 和 Windows 的全新独立桌面应用。Agent-first，无需 IDE。包含动态子智能体、异步任务管理、JSON hooks 以及计划任务（cron 风格调用）。请参阅我们的 Gemini 3.5 Flash 开发者指南 以了解 2.0 相关的模型上下文。
• Antigravity CLI — 本文的主题。终端优先的智能体界面，采用 Go 语言重构。
• Antigravity SDK — 用于将 harness 嵌入到自有应用中的编程接口。与 2.0 和 CLI 同步发布。
• Antigravity IDE — 原始产品。目前仍在更新，但其中的 Agent Manager 界面将在未来版本中弃用，转而由独立的 2.0 应用取代。

这对 CLI 尤为重要的原因是：核心 harness 的改进会同时发布到所有界面。无论是智能体可调用的新工具、更优的规划循环，还是全新的权限模型 —— 你无需等待 CLI 团队进行向后移植。

5. CLI vs Antigravity 2.0

引擎相同，交互体验不同。官方功能对比表：

实际应用场景：当你身处远程服务器、网络连接缓慢、处于 tmux 窗格中，或者单纯对 GUI 敬而远之时，CLI 是你的首选。而当你需要产物预览、diff 的可视化审查流程、语音输入以及 Scheduled Tasks 仪表板时，2.0 桌面应用则是你的不二之选。

6. 安装

README 发布了三个安装命令。它们都是从以下地址拉取 Shell 脚本的单行命令： antigravity.google/cli/install.*:

# macOS / Linux
curl -fsSL https://antigravity.google/cli/install.sh | bash

# Windows PowerShell
irm https://antigravity.google/cli/install.ps1 | iex

# Windows CMD
curl -fsSL https://antigravity.google/cli/install.cmd -o install.cmd && install.cmd && del install.cmd

安装后，二进制文件名为 agy （而非 antigravity — 这在编写脚本时很重要）。使用以下命令验证： agy --version。Antigravity CLI 还采用双重分发模式：同一个项目作为一个公开的 Go 仓库发布在 github.com/google-antigravity/antigravity-cli 附带演示 GIF 以及指向官方文档的链接表。

7. 身份验证，包括远程 SSH

CLI 通过系统密钥环进行身份验证，并以 Google 登录作为备选方案。以下是两个值得了解的工作流：

• 本地： 首次运行会打开默认浏览器。请使用关联了 Google AI Pro、Ultra、Gemini Code Assist 或企业级 GCP 项目的 Google 账号登录。凭据将存储在系统密钥环中。
• 远程 / SSH： CLI 会检测 SSH 会话并改为打印授权 URL。你在本地机器上打开该 URL，完成 OAuth 流程，随后令牌将回传并绑定到该 SSH 会话。这是早期 Gemini CLI 流程中的一个显著痛点；现在它已成为原生支持的一等公民场景。
• 退出登录： /logout 清除已保存的凭据。

对于企业级访问，你需要在配置过程中连接一个 GCP 项目。随后 CLI 将通过该项目路由调用，以便进行计费和配额管理。官方企业页面涵盖了 GCP 项目的具体要求；个人用户流程则不需要。

8. 共享 Agent 治理层

这是解释产品中所有其他选择的架构决策。Antigravity CLI 和 Antigravity 2.0 都运行在相同的 核心 Agent 引擎。摘自官方 CLI 博客文章：

“Antigravity CLI 的一个主要目标是整合 Google 构建的开发者界面上的单一 agent harness，以便在未来实现更快速的改进。”

三个层面的影响：

• 设置和权限双向同步。 在 2.0 中设置的模型权限同样适用于 CLI，反之亦然。您无需维护两个 allowlists。
• Conversations export sideways. 默认情况下，对话不会在不同产品之间共享，但您可以通过以下方式在 2.0 中调出 CLI 对话： @conversation 下拉菜单以在 GUI 中继续。
• 改进只需发布一次。 当 Google 向 harness 发布更好的 tool-routing 算法或更智能的 planning loop 时，两个界面都会在同一天获得更新。无需 CLI 团队进行 backport。

9. 上下文文件和规则

Antigravity CLI 读取与 Gemini CLI 相同的上下文文件：

• 工作区上下文： GEMINI.md 以及 AGENTS.md 来自当前活动的工作区目录。
• 全局上下文： ~/.gemini/GEMINI.md，自动加载并在所有工作区中生效。

如果您有针对现有 Gemini CLI 流程的规则文件，它们将继续有效。如需了解结构化的跨工具规则模式，请参阅我们的 AGENTS.md 指南 以及 GEMINI.md 系统提示词指南。

10. Plugins（原为：Extensions）

Gemini CLI 曾将 extensions 作为共享功能的包格式。Antigravity CLI 将此界面重命名为 plugins— 根据官方文档，“业界已将该术语标准化”。

首次启动时，你会看到一个迁移提示，用于将 Gemini CLI extensions 转换为 Antigravity plugins。如果你跳过了该步骤或在其他地方安装了 CLI，请显式运行导入：

agy plugin import gemini

Real output from the official docs, showing the import walking a multi-component extension:

[ok]    conductor
          - skills      : skipped (not found)
          - agents      : skipped (not found)
          ✔ commands    : 6 processed (converted to skills)
          - mcpServers  : skipped (not found)
          - hooks       : skipped (not found)
[ok]    google-workspace
          ✔ skills      : 6 processed
          - agents      : skipped (not found)
          ✔ commands    : 4 processed (converted to skills)
          ✔ mcpServers  : 1 processed
          - hooks       : skipped (not found)

注意事项：自定义主题不会迁移；commands 变为 skills（旧的 commands 概念被合并到更广泛的 skills 原语中）；MCP 服务器会迁移，但配置文件位置会发生变化（参见第 12 节）。

11. Agent Skills

Agent skills 是可重用智能体行为的最小单元 — 即描述斜杠命令以及智能体在被调用时应执行的操作的小文件。它们源自 Gemini CLI，并在 Antigravity CLI 中仍然是一个一等公民概念，使用相同的 /skills 命令进行管理。

位置已更改：

全局技能会自动加载，无需手动操作。位于旧版 .gemini/skills/ 文件夹中的工作区技能需要移动至 .agents/skills/。有关编写技能的详细教程，请参阅我们的 Antigravity 技能设置指南 和 掌握 Agent 技能。

值得注意的一个缺失点：Antigravity CLI 目前还没有与 gemini skills 命令等效的终端管理功能。你可以手动编写 skill 文件，或者通过 npx skills install进行安装。

12. MCP 服务器

Antigravity CLI 同时支持本地和远程 MCP 服务器，且通过同一个 /mcp 命令。需要注意与 Gemini CLI 的两个配置差异：

• 独立的配置文件。 Antigravity 将 MCP 服务器配置存储在专用的 mcp_config.json 文件中，而不是内联在 settings.json中。 全局：~/.gemini/antigravity-cli/mcp_config.json。工作区： .agents/mcp_config.json。
• 字段重命名。 对于远程 MCP 服务器，Antigravity CLI 使用 serverUrl 而不是 url （或已弃用的 httpUrl）。如果不重命名该字段，直接复制过来的 Gemini CLI 配置在远程服务器上将静默失败。

有关 MCP 配置模式的背景信息，请参阅我们的 MCP 教程 以及 自定义 MCP 服务器指南。

13. Hooks 与子智能体

这两项功能均源自 Gemini CLI 和 Antigravity 2.0 系列：

• Hooks。 Defined as JSON. They let you intercept and control the agent at specific lifecycle moments — before a tool call, after a file edit, on session start. This is the same JSON hook format introduced in Antigravity 2.0.
• 动态子智能体。 主智能体可以派生专注于特定任务的子智能体以进行并行工作。这就是 CLI 宣传异步/后台工作流的方式：以前会锁定终端会话的大型重构和多主题研究，现在可以在你继续输入时作为子智能体在后台运行。

有关多智能体模式的实践，请参阅我们的 多智能体编排演练。

14. 安全脚注

README 中包含一个警告区块。它很简短，值得全文引用：

“AI 编程智能体已知存在某些安全风险，包括自主代码执行、数据外泄、提示词注入以及供应链风险。请确保您监控并验证智能体执行的所有操作。”

Google 收集的交互数据可以在设置中选择退出。在消费级层级中，CLI 默认开启数据收集。企业级行为则遵循您的 GCP 项目策略。如需深入了解威胁模型和值得调整的控制措施，请参阅我们的 Antigravity 安全指南 以及 危险命令预防指南。

15. 它（目前）还不具备的功能

官方文档明确指出 Antigravity CLI 发布时暂不具备的功能：

• 自定义主题不会迁移。 部分 Gemini CLI 扩展包含自定义主题；这些组件在插件导入过程中会被舍弃。
• 没有 skills CLI 命令。 Skills 仍通过智能体内部的 /skills进行管理，但目前没有等同于 gemini skills 的终端级管理功能。文件编写或 npx skills install 是目前的替代方案。
• 不承诺 1:1 的功能对等。 Google 明确表示 “there won't be 1:1 feature parity right out of the gate.” 承诺提供的是 “the most critical features” — skills、hooks、subagents、plugins。如果你依赖特定的 Gemini CLI 外围命令，请在操作前先进行确认。

16. Antigravity CLI 的适用人群

17. FAQ

18. 结论

如果你本周只打算做一件事：在你最常使用 Gemini CLI 的机器上安装 Antigravity CLI，运行 agy plugin import gemini，并尝试一个你平时会在旧版 CLI 中运行的 20 分钟任务。只需一次会话，你就能知道迁移是否顺畅。

来源

• Google Developers Blog — 重要更新：将 Gemini CLI 过渡到 Antigravity CLI（2026 年 5 月 19 日）
• X 上的 @geminicli — 过渡公告推文串
• Google Antigravity CLI 介绍 — antigravity.google
• Google Antigravity 2.0 介绍 — antigravity.google
• Antigravity CLI 概览 — 官方文档
• 从 Gemini CLI 迁移 — 官方文档
• google-antigravity/antigravity-cli — GitHub 仓库