
在 2026 年 5 月 19 日 的 Google I/O 大会上,Gemini CLI 团队宣布该产品将转型为一款新产品: Antigravity CLI。该版本使用 Go 语言重写,设计目标是键盘优先的远程办公,其背后的智能体驱动程序与 Antigravity 2.0 桌面应用相同。如果您一直在 Google AI Pro 或 Ultra 账号上使用 Gemini CLI,您大约有 30 天的时间进行切换,之后请求将在以下日期停止服务: 2026 年 6 月 18 日。(2026 年 5 月发布时的说法;该日期已经过去,个人用户现在应使用 Antigravity CLI。)
Transitioning Gemini CLI users to Antigravity CLI We are unifying our efforts around a single harness and platform, Google Antigravity with four distinct surfaces: • Antigravity 2.0 • Antigravity CLI • Antigravity SDK • Antigravity IDE This will allow us to move faster and
— @geminicli May 19, 2026
将 Gemini CLI 用户迁移至 Antigravity CLI
@geminicli 官方账号宣布将 Google 的开发者代理(agent)技术栈统一为一个平台,涵盖四个产品形态:Antigravity 2.0、Antigravity CLI、Antigravity SDK 和 Antigravity IDE。
简短回答:什么是 Antigravity CLI,如何安装?
Antigravity CLI 是 Google 的终端智能体,命令是 agy。 它已取代个人用户使用的 Gemini CLI,并与 Antigravity 桌面应用运行同一套智能体引擎。 官方更新日志中的最新 CLI 版本是 v1.4.11(2026 年 10 月 30 日核对)。
- 安装:
curl -fsSL https://antigravity.google/cli/install.sh | bash(macOS、Linux)或irm https://antigravity.google/cli/install.ps1 | iex(Windows PowerShell)。 - 验证:
agy --version。 - 在项目目录运行
agy,并用 Google 账号登录。 - 输入
/查看斜杠命令,或输入/mcp添加 MCP 服务器。 - 更新:重新运行安装命令;如果用 Homebrew 安装,则运行
brew upgrade --cask antigravity-cli。
Get the latest on AI, LLMs & developer tools
New MCP servers, model updates, and guides like this one — delivered weekly.
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 日(已过去,2026 年 10 月 30 日核对)
- 企业版例外: Gemini CLI 将继续支持 Code Assist 标准版/企业版及付费 API 密钥
如果你目前的工作流依赖 Gemini CLI,你获得的并不是一次简单的更新。你获得的是一个并行的产品,你需要安装它,将其指向现有配置并进行验证。虽然大部分技能、MCP 服务器和 hooks 都可以迁移,但文件布局不同,二进制文件不同,且命令行界面(command surface)也经过了重构。请将其视为一次迁移,而非升级。如需分步迁移指南,请参阅我们的 Gemini CLI → Antigravity CLI 迁移指南。
3. 什么是 Antigravity CLI
根据官方概览页面的描述: Antigravity CLI 是 Antigravity 的轻量级终端用户界面(TUI)。它将与 Antigravity 2.0 相同的核心智能体能力 — 多步推理、多文件编辑、工具调用和对话历史 — 直接带到了你的终端。
Google AI Developers 账号在同一天发布了该产品的演示视频,并将其定位浓缩为一句话:
For those who prefer the terminal, the @Antigravity CLI is lightweight and lets you interact with your agents straight from the command line.
— @googleaidevs May 19, 2026
Antigravity CLI 演示 — 终端界面
对于那些偏好终端的用户,@Antigravity CLI 非常轻量,让你能直接从命令行与你的 agents 进行交互。
具体来说,这意味着三件事:
- 它是一个 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 在当天早些时候的一条推文中概括了其中三个:
We’ve created new easy ways to interact with Antigravity: 💻 2.0: A mission control where agents can work together simultaneously on a project ⌨️ CLI: A terminal interface to work with agents ⚙️ SDK: A toolkit that lets your software automatically connect to and use our AI
— @GoogleDeepMind May 19, 2026
Antigravity 界面 — DeepMind 的定义
2.0: A mission control where agents can work together simultaneously on a project. CLI: A terminal interface to work with agents. SDK: A toolkit that lets your software automatically connect to and use our AI agents.
加上原有的 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
引擎相同,交互体验不同。官方功能对比表:
| 功能 | Antigravity CLI | Antigravity 2.0 |
|---|---|---|
| 主要侧重 | 速度、键盘效率、低开销 | 全面性、可视化编排 |
| 界面 | 终端用户界面 (TUI) | 完整的 GUI 桌面应用程序 |
| 工作流 | SSH / 远程会话,键盘优先 | 本地工作区,重度编排 |
| Agent 引擎 | 共享核心 Agent 引擎 | 共享核心 Agent 引擎 |
实际应用场景:当你身处远程服务器、网络连接缓慢、处于 tmux 窗格中,或者单纯对 GUI 敬而远之时,CLI 是你的首选。而当你需要产物预览、diff 的可视化审查流程、语音输入以及 Scheduled Tasks 仪表板时,2.0 桌面应用则是你的不二之选。
6. 安装:如何安装 Antigravity CLI(Windows、Mac、Linux)
| 系统 | 安装方式 | 二进制文件位置 |
|---|---|---|
| macOS / Linux | curl -fsSL https://antigravity.google/cli/install.sh | bash | ~/.local/bin |
| Windows PowerShell | irm https://antigravity.google/cli/install.ps1 | iex | %LOCALAPPDATA%\agy\bin |
| Windows CMD | install.cmd | %LOCALAPPDATA%\agy\bin |
| Homebrew (macOS) | brew install --cask antigravity-cli | 由 Homebrew 管理 |
2026 年 10 月 30 日补充:官方安装页面当前仍显示 v1.4.4,而更新日志和 Homebrew cask 显示 v1.4.11,请以 agy --version 的输出为准。首次运行 agy 时按提示用 Google 账号登录;通过 SSH 使用时见下文第 7 节。
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 以及指向官方文档的链接表。
curl | bash 是规范的安装路径,对于 Google 官方域名来说没问题,但仍值得将其视为一个信任步骤。在共享基础设施上通过管道执行脚本前,请先检查脚本内容: curl -fsSL https://antigravity.google/cli/install.sh -o /tmp/agy-install.sh && less /tmp/agy-install.sh.
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 CLI | Antigravity CLI |
|---|---|---|
| 全局 | ~/.gemini/skills/ | ~/.gemini/antigravity-cli/skills/ |
| 工作区 | .gemini/skills/ 或 .agents/skills/ | .agents/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/config/mcp_config.json(Google 当前文档;2026 年 5 月发布时的文章写作~/.gemini/antigravity-cli/mcp_config.json,属于历史信息,若你的版本仍用旧路径请以 /mcp 面板为准)。工作区:.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 宣传异步/后台工作流的方式:以前会锁定终端会话的大型重构和多主题研究,现在可以在你继续输入时作为子智能体在后台运行。
有关多智能体模式的实践,请参阅我们的 多智能体编排演练。
Antigravity CLI 命令(agy 命令参考)
2026 年 10 月 30 日补充,已对照 Google 的 CLI 参考文档和 CLI v1.4.11。 可执行文件是 agy。直接运行会打开终端界面,也可以带参数改变会话行为。以下是 Google CLI 参考文档中列出的参数:
| 命令或参数 | 作用 |
|---|---|
agy | 在当前目录打开交互式终端界面。 |
agy -p "提示词" | 非交互式运行一次提示词(无头 print 模式)。别名:--print、--prompt。 |
-i, --prompt-interactive | 以交互方式运行初始提示词,然后继续会话。 |
-c, --continue | 继续最近一次对话。 |
--conversation <id> | 按 ID 恢复之前的对话。 |
--mode | 设置执行模式:accept-edits、auto(预览版)或 plan。 |
--model, --effort, --agent | 为会话选择模型、推理强度和智能体。可用 agy models 和 agy agents 列出。 |
--add-dir | 把一个目录加入工作区,可重复使用。 |
--output-format | print 模式的输出格式:text、json 或 stream-json。 |
--json-schema | 在 print 模式下强制结构化输出。 |
--sandbox | 本次会话开启终端沙箱。 |
--dangerously-skip-permissions | 自动批准所有工具权限请求,请谨慎使用。 |
--remote-control | 为会话启动 Remote Control 连接。 |
agy plugin install | list | validate | 在 shell 中管理插件(见上文插件一节)。 |
我在 Google 文档中没有找到 agy update、agy uninstall 或 agy mcp 子命令,所以本文不列出它们。一些旧文章把命令写成 antigravity,实际需要输入的是 agy。
Antigravity CLI 斜杠命令
在输入框中键入 / 可浏览命令,按 Tab 接受高亮的自动补全。本次更新时文档列出的命令如下:
| 斜杠命令 | 用途 |
|---|---|
/config | 交互式设置编辑器(别名 /settings)。 |
/model, /effort | 选择模型和推理强度。 |
/mcp | 打开 MCP 服务器管理面板。 |
/plugin | 插件管理器,或内联安装、卸载、启用、停用、列出(别名 /plugins)。 |
/skills | 浏览已加载的技能。/skills reload 会从磁盘重新读取。 |
/permissions | 管理工具的 allow、ask、deny 规则。 |
/hooks | 浏览已启用的 hooks。 |
/agents, /tasks | 管理自定义智能体和后台子智能体,监控后台 shell 任务。 |
/plan, /goal, /boost, /teamwork | 规划与深度推理工作流(/teamwork 面向付费方案)。 |
/resume, /fork, /rewind, /rename, /clear | 对话管理:恢复、分叉、回退、重命名、重置。 |
/diff, /context, /usage, /credits | 查看改动、上下文占用、配额和额度。 |
/add-dir, /open, /copy, /btw | 添加工作区目录、在编辑器中打开路径、复制回复、提一个旁支问题。 |
/remote-control, /schedule, /voice | Remote Control 开关、定时与 cron 计划、语音听写。 |
/logout | 断开账号并清除系统密钥环中保存的令牌。 |
/help, /changelog, /feedback, /exit | 帮助面板、版本说明、反馈和退出(别名 /quit)。 |
这是完整参考表的精简版,完整表中还有 /artifact、/browser、/codesearch、/grill-me、/keybindings、/learn、/statusline 和 /title。命令列表会随版本变化,请在你的版本里运行 /help 查看实际可用的命令。
Antigravity CLI 模式与 Auto 模式
在输入框中按 Shift+Tab 依次切换模式:default、accept-edits、auto、plan。也可以用 agy --mode=accept-edits、agy --mode=auto 或 agy --mode=plan 直接以某个模式启动,或在 settings.json 中用 agentMode 保存默认值。
| 模式 | 行为 |
|---|---|
| default | 编辑文件前显示 diff 供你审查,执行终端命令前会询问。 |
| accept-edits | 自动批准工作区内的文件创建和编辑,执行终端命令前仍会询问。 |
| auto(预览版) | 自动批准编辑,在终端沙箱内运行命令,并对需要离开沙箱的命令进行检查,安全且可撤销的命令无需提示即可运行。 |
| plan | 先用只读工具调研,在任何编辑之前给出计划并等待你批准。 |
- 确认终端沙箱可用(macOS 和 Linux,或安装了 2026 年 8 月更新的 Windows 11 24H2 及以上)。
- 运行
agy --mode=auto,或在~/.gemini/antigravity-cli/settings.json中设置"agentMode": "auto"。 - 查看右下角状态栏,auto 模式生效时会显示
auto。
Auto 模式在 macOS 和 Linux 上需要 CLI v1.3.5 或更高版本,在 Windows 上需要 v1.4.4 或更高版本,且不适用于商业版或企业版账号。不可用时 CLI 会以 default 模式启动,并且 Shift+Tab 的循环中不会出现 auto。toolPermission: "strict" 或 always-proceed 等设置会覆盖 auto 模式。更详细的说明见我们的 自动接受与 Autopilot 指南。
Antigravity CLI settings.json
用户设置文件是 ~/.gemini/antigravity-cli/settings.json。可以手动编辑,也可以通过 /config 修改。省略的键使用默认值。在文件顶部加入 "$schema": "https://antigravity.google/schemas/v1/settings.json" 可获得编辑器自动补全。
| 键 | 默认值 | 说明 |
|---|---|---|
agentMode | ""(default) | "accept-edits"、"auto" 或 "plan"。 |
toolPermission | request-review | 另有 proceed-in-sandbox、always-proceed 和 strict。 |
enableTerminalSandbox | false | 在操作系统沙箱内运行智能体命令。 |
allowNonWorkspaceAccess | false | 允许智能体访问工作区之外的文件。 |
modelProvider | "" | 设为 gemini 可使用 GEMINI_API_KEY 代替 Google 登录。 |
colorScheme | terminal | 主题,例如 dark 或 tokyo night。 |
notifications | false | 智能体需要你时发出终端提示音和桌面通知。 |
verbosity | medium | high、medium 或 low。 |
permissions | none | 包含 allow、ask、deny 规则的对象。 |
Google 的参考文档还列出了更多键(editor、editorMode、historySize、queuedMessages、sandboxProxy 等)。MCP 服务器的配置放在单独的 mcp_config.json 中,见上文 MCP 一节。
Antigravity CLI 与 Gemini CLI 的区别
| Gemini CLI | Antigravity CLI | |
|---|---|---|
| 命令 | gemini | agy |
| 配置目录 | ~/.gemini | ~/.gemini/antigravity-cli |
| MCP 配置 | 内联在 settings.json 中 | 单独的 mcp_config.json,远程服务器使用 serverUrl |
| 扩展 | Extensions | Plugins(agy plugin import gemini 可导入扩展) |
| 个人账号 | 2026 年 6 月 18 日已停止(历史信息) | Google AI Pro、Ultra 及免费账号的受支持路径 |
迁移只需几条命令。我们的 Gemini CLI 到 Antigravity CLI 迁移指南 逐步讲解了整个过程。
如何更新 Antigravity CLI
2026 年 10 月 30 日补充。Google 的 CLI 参考文档把更新方法指向其安装页面,而我无法加载那个页面,所以无法引用官方的更新命令。来源中能确认的做法如下:
- 用
agy --version查看版本,并与官方更新日志中的最新版本对比(2026 年 10 月 30 日为 v1.4.11)。 - Homebrew 安装:运行
brew upgrade --cask antigravity-cli。该 cask 标记为自动更新。 - 脚本安装:重新运行安装一节中的安装命令,很可能就能得到最新的二进制文件。这是我的推断,并非文档中的官方步骤。CLI 更新日志还提到插件会自动更新,这与更新 CLI 本身是两回事。
- Googlebook:通过 Google Play 更新或重新安装。
- 在 CLI 中运行
/changelog可阅读已安装版本的发布说明。
如何卸载 Antigravity CLI
Google 没有公布卸载命令。以下步骤综合了 Google 文档中的安装路径和 Homebrew cask 的定义。我们的 卸载 Antigravity 指南 讲的是桌面应用,不涉及 CLI。
- 在 CLI 中运行
/logout,清除系统密钥环中保存的令牌。 - Homebrew:
brew uninstall --cask antigravity-cli。加上--zap会同时删除~/.gemini/antigravity-cli。 - macOS 或 Linux 上的脚本安装:删除
~/.local/bin中的agy二进制文件。 - Windows 上的脚本安装:删除
%LOCALAPPDATA%\agy\bin中的agy二进制文件。 - 移除安装程序添加到 shell 配置文件中的
PATH行(如果安装时使用了--skip-path则无需操作)。 - 可选:删除
~/.gemini/antigravity-cli(设置)和~/.gemini/config(共享的规则、技能、hooks 与 MCP 配置)。第二个目录会被其他 Antigravity 界面共用,删除前请先确认。
如果 agy 是启动失败而不是安装失败,请参阅我们的 agy CLI 错误排查指南。
14. 安全脚注
README 中包含一个警告区块。它很简短,值得全文引用:
“AI 编程智能体已知存在某些安全风险,包括自主代码执行、数据外泄、提示词注入以及供应链风险。请确保您监控并验证智能体执行的所有操作。”
Google 收集的交互数据可以在设置中选择退出。在消费级层级中,CLI 默认开启数据收集。企业级行为则遵循您的 GCP 项目策略。如需深入了解威胁模型和值得调整的控制措施,请参阅我们的 Antigravity 安全指南 以及 危险命令预防指南。
15. 它(目前)还不具备的功能
官方文档明确指出 Antigravity CLI 发布时暂不具备的功能:
- 自定义主题不会迁移。 部分 Gemini CLI 扩展包含自定义主题;这些组件在插件导入过程中会被舍弃。
- 没有
skillsCLI 命令。 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 的适用人群
- 你在 Google AI Pro / Ultra 账号上使用 Gemini CLI — 6 月 18 日的截止日期已经过去(历史信息,2026 年 10 月 30 日核对),个人账号现在应使用 Antigravity CLI
- 你习惯在 tmux、远程服务器或以终端为主的 IDE 中工作
- 你希望获得与 Antigravity 2.0 相同的 agent harness,但不需要 GUI
- 你需要编排后台 subagents,且不希望它们阻塞你的 shell
- 你希望在不同平台间保持 MCP 服务器、skills 和 hooks 的可移植性
- 你使用的是 Code Assist Standard / Enterprise 许可证 — Gemini CLI 将继续可用
- 你依赖付费的 Gemini API 密钥 — 同样,Gemini CLI 仍受支持
- 你的工作流核心是 artefact 预览、视觉 diff 审查或语音输入 — 那么你更需要 2.0 版本
- 你依赖的某个 Gemini CLI 外围功能尚未迁移 — 请等待后续版本发布
17. FAQ
Q: Antigravity CLI 免费吗?
CLI 本身可以免费安装,且代码仓库在 GitHub 上公开。使用权限取决于你的 Google 账号层级 — 个人用户取决于 Google AI Pro、Ultra 或 Gemini Code Assist 配额;组织机构则取决于企业方案或付费 Gemini API 密钥。
Q: Antigravity CLI 支持通过 SSH 使用吗?
是 — 明确支持。CLI 会检测 SSH 会话并打印一个授权 URL,你可以在本地浏览器中完成授权。远程 SSH 是首要的设计目标,而非事后补救。
Q: Antigravity CLI 是用什么语言编写的?
Go。与基于 Node.js 的 Gemini CLI 相比,Google 使用 Go 重构了终端体验,以实现更低的内存开销和更快的启动速度。其背后的共享 agent harness 与驱动 Antigravity 2.0 的引擎相同。
问:我的 Gemini CLI 扩展还能用吗?
大部分都可以。首次启动时会提示进行迁移,将扩展转换为 Antigravity 插件。你也可以运行 agy plugin import gemini 手动执行。自定义主题和一些次要组件无法完美迁移;但技能、命令、MCP 服务器和 hooks 通常可以。
问:Antigravity CLI 和 Antigravity 2.0 是一回事吗?
不是。它们共享同一个智能体引擎并同步设置,但它们是不同的二进制文件。2.0 是一个专注于可视化编排的桌面 GUI。CLI 则是一个专注于速度和远程工作流的 TUI。
问:我可以继续使用 Gemini CLI 吗?
如果你使用的是 Code Assist 标准版或企业版,或者使用付费的 Gemini API 密钥,那么答案是肯定的 — 可以无限期使用。如果你使用的是 Google AI Pro、Ultra 或面向个人的免费版 Gemini Code Assist,Gemini CLI 已于以下日期停止响应请求: 2026 年 6 月 18 日(该日期已过去,截至 2026 年 10 月 30 日核对)。
问:Antigravity CLI 支持 MCP 服务器吗?
支持,包括本地和远程。配置位于 mcp_config.json (而不是像 Gemini CLI 那样内联在 settings.json 中)。远程服务器使用 serverUrl 字段,而不是 url。
18. 结论
我们的观点
如果你在个人 Google 账号上使用 Gemini CLI,那么即使在 2026 年 6 月 18 日强制停用之前,Antigravity CLI 就已经是更好的日常工具(该日期现已过去)。Go 语言重写带来的提升是实打实的(启动快、内存占用低),SSH 是原生支持的一等公民流程,插件迁移只需一条命令,而且你不再需要运行一个与桌面应用并行的代理。观望的理由很少:除非你需要企业许可证、付费 API 密钥,或者某个你确定尚未发布的特定 Gemini CLI 功能。
如果你本周只打算做一件事:在你最常使用 Gemini CLI 的机器上安装 Antigravity CLI,运行 agy plugin import gemini,并尝试一个你平时会在旧版 CLI 中运行的 20 分钟任务。只需一次会话,你就能知道迁移是否顺畅。
相关指南
有关分步迁移说明,请参阅 Gemini CLI → Antigravity CLI 迁移。有关驱动所有四个界面的模型,请参阅 Gemini 3.5 Flash 开发者指南。对于大部分仍然适用的旧版 Gemini CLI 工作流,请参考我们的 Gemini CLI 设置指南。