# Google Antigravity CLI

Google 的终端编码代理，支持代码探索、多文件修改、自定义代理和连接工具，并适用于交互式及远程工作流。

> 这是 OpenNavo 上 Google Antigravity CLI 页面的 Markdown 版本，内容与网页相同： <https://opennavo.com/zh/apps/antigravity-cli>

- **最新版本**: `1.5.14,5302690847260672`
- **开发者**: Google
- **主页**: <https://antigravity.google/product/antigravity-cli>
- **分类**: [开发工具](https://opennavo.com/zh/categories/developer-tools)
- **安装**: `brew install --cask antigravity-cli`
- **近 30 天安装**: 17,498
- **Homebrew**: 可以安装，由 Homebrew 更新
- **下载地址**: <https://storage.googleapis.com/antigravity-public/antigravity-cli/1.5.14-5302690847260672/darwin-arm/cli_mac_arm64.tar.gz>
- **SHA-256**: `b01bdd4591e13ddfcb0e049bea74ae9f83e80829adcf64aaa58f5bfb1a425a54`

SHA-256 只用来核对下载的文件是否完整，不代表安全认证。

## 注意事项

\`agy\`'s automatic updates are disabled so that Homebrew manages them. Use \`brew upgrade --cask antigravity-cli\` instead of \`agy update\`.

## 安装与卸载内容

```json
[
  {
    "declaration": {
      "command_wrapper": [
        "agy",
        {
          "env": {
            "AGY_CLI_DISABLE_AUTO_UPDATE": "true"
          },
          "executable": "$HOMEBREW_PREFIX/Caskroom/antigravity-cli/1.5.14,5302690847260672/antigravity"
        }
      ],
      "target": "$HOMEBREW_PREFIX/bin/agy"
    },
    "phase": "install",
    "sources": [
      "agy"
    ],
    "target": "$HOMEBREW_PREFIX/bin/agy",
    "type": "command_wrapper"
  },
  {
    "declaration": {
      "zap": [
        {
          "trash": "~/.gemini/antigravity-cli"
        }
      ]
    },
    "phase": "cleanup",
    "sources": [],
    "type": "zap"
  }
]
```

## 介绍

Antigravity CLI 是 Google 面向代理式软件开发的终端界面。它适合希望在不离开终端的情况下进行代码探索、跨多个文件修改和借助工具执行任务的开发者，也适用于 SSH 和 tmux 工作流。它不同于 Antigravity 桌面应用，可独立运行。

### 功能
- 交互式对话、代码搜索，以及可审阅计划和差异的多文件编辑。
- 带有权限控制和沙盒行为的工具执行。
- 自定义代理和子代理、技能、规则、钩子及插件。
- 用于连接工具的 MCP 集成；服务提供方可能要求单独的凭据。
- 对话历史、恢复会话，以及可配置的主题和详细程度。
- 与 Antigravity 桌面体验共享代理能力和配置集成。

### 安装和首次使用
安装 `brew install --cask antigravity-cli`，然后在项目目录中运行 `agy`。这个 cask 会将提供的 antigravity 二进制文件链接为 agy。首次启动时会引导你选择主题和渲染选项、设置信任工作区并完成身份验证。Google 官方安装程序也是一种分发方式；请避免使用多个互相冲突的安装程序管理同一个可执行文件。

标准登录使用 Google 账号和适用的服务访问权限。身份验证信息可以存储在系统原生钥匙串中：Apple Keychain、Linux Secret Service 或 Windows Credential Manager。远程 SSH 会话支持在另一个浏览器中打开身份验证网址，并在获取验证码后返回。企业访问可能需要先完成组织和项目的入驻配置。

可选的 Gemini API 模式要求在 `~/.gemini/antigravity-cli/settings.json` 中同时设置 `GEMINI_API_KEY` 和 `modelProvider: "gemini"`；仅设置环境变量并不会选择该服务提供方。API 使用有独立的配额和计费。返回常规账号身份验证前，请移除服务提供方覆盖设置。`/logout` 会清除已存储的会话身份验证信息，但不会取消设置由环境提供的 API 密钥。

### 系统和依赖项
Homebrew cask 要求 macOS12 或更高版本，并会选择 Apple Silicon 或 Intel 归档文件。官方 CLI 安装文档也涵盖 Linux、Windows 和 Googlebook；这些是单独的安装方式，并非通过 Mac cask 安装的产品。在查阅到的 CLI 文档中，未确认 Windows/Linux 的最低版本号，也未确认固定的 RAM 要求；请勿用桌面 IDE 的要求替代。

cask 未声明其他 formula 依赖项，也未明确声明 cask 冲突。它提供原生 CLI，并非需要单独通过 npm 安装的 Node.js 包。需要可用的终端，以及到所选服务的网络连接。项目编译器、运行时、Git、构建工具和 MCP 集成所用的可执行文件取决于所执行的任务，必须另行准备。桌面应用为可选项。

官方 Apple Silicon1.3.1 归档文件大小为54,461,807字节，已通过 HTTP Content-Length 验证。已安装文件、缓存和对话数据还会占用下载文件之外的存储空间。Homebrew zap 包含 `~/.gemini/antigravity-cli`；移除此目录前，请检查并备份需要保留的设置和历史记录。清理本地数据不会删除 Google 账号。

### 账号、费用和许可
下载 CLI 不代表可以无限使用模型。托管服务的使用受账号资格、套餐权益、服务配额和任何付费 AI 额度限制；Gemini API 模式则遵循该 API 单独的计费和配额规则。请查看适用于你所在地区和账号的最新官方套餐及条款。

Google 的软件和服务条款适用。公开仓库发布了文档、示例和版本历史；仓库的存在并不能证明完整分发的客户端采用 MIT 或 Apache 许可。已连接的服务和项目依赖项各自有其许可。README 说明了交互数据收集和退出设置；发送项目内容前，请查阅适用的隐私条款和企业条款。

### 官方参考资料
- 产品：https://www.antigravity.google/product/antigravity-cli
- 安装：https://www.antigravity.google/docs/cli/install
- 文档：https://www.antigravity.google/docs/cli/overview
- 仓库和版本历史：https://github.com/google-antigravity/antigravity-cli
- 条款：https://www.antigravity.google/terms

## 系统要求

- macOS 12 起 · 应用版本: 1.5.14,5302690847260672 · Intel · <https://github.com/homebrew/homebrew-cask/blob/HEAD/Casks/a/antigravity-cli.rb> · 核查于 2026-11-22
  - <https://storage.googleapis.com/antigravity-public/antigravity-cli/1.5.14-5302690847260672/darwin-x64/cli_mac_x64.tar.gz>
  - SHA-256: `c142141141cbaa93f4e46904b76341e349f3f2b78445f877f39468dfe60dda1e`
- macOS 12 起 · 应用版本: 1.5.14,5302690847260672 · Apple 芯片 · <https://github.com/homebrew/homebrew-cask/blob/HEAD/Casks/a/antigravity-cli.rb> · 核查于 2026-11-22
  - <https://storage.googleapis.com/antigravity-public/antigravity-cli/1.5.14-5302690847260672/darwin-arm/cli_mac_arm64.tar.gz>
  - SHA-256: `b01bdd4591e13ddfcb0e049bea74ae9f83e80829adcf64aaa58f5bfb1a425a54`

## 卸载

- `brew uninstall --cask antigravity-cli`

普通卸载会删除应用本身，设置和缓存会保留。

### 深度清理（可选）

- `brew uninstall --zap --cask antigravity-cli`

`--zap` 还会删除 Homebrew 定义里列出的设置、缓存等文件，其中可能有其他应用共用的数据，删除后无法恢复；它也不保证没有任何残留。请先备份需要保留的数据；如要保留设置和缓存，请不要加 `--zap`。

普通卸载会删除应用本身，设置和缓存会保留。

- 文件和文件夹: `~/.gemini/antigravity-cli` — <https://github.com/homebrew/homebrew-cask/blob/HEAD/Casks/a/antigravity-cli.rb> · 以上条目来自 Homebrew 定义，核查于 2026-11-22；它们只说明定义声明会删除什么，不代表你的 Mac 上都有。

## 最新版本说明

### 1.5.14 (2026-11-21)

Google Antigravity CLI 1.5.14 让终端用户实时查看模型思考、审阅远程代理计划，并在文件改动前看到 swarm 进度。

**思考**

- /thinking 实时输出模型的完整思考，并在结束后保持展开。
- 默认关闭，设置保存在 settings.json 的 showThinking。

**远程**

- 计划模式让远程代理先写出可审阅的计划，再编辑或运行命令。
- 可将远程 Agent Mode 保存为 default、accept-edits 或 plan。

**Swarm**

- 终端至少 28 行时，/swarm board 增加实时 Overview。
- 显示目标、任务进度、受阻工作和最多六个线程。

## 资料与来源

- <https://opennavo.com/zh/apps/antigravity-cli>
- <https://opennavo.com/zh/apps/antigravity-cli/versions>
- <https://github.com/homebrew/homebrew-cask/blob/HEAD/Casks/a/antigravity-cli.rb> · 核查于 2026-11-22
- <https://formulae.brew.sh/cask/antigravity-cli>
