# Antigravity CLI

> 在 NeuroSquad 卡片中运行谷歌的 Antigravity CLI（agy，Gemini CLI 的继任者）——如何安装、哪些可用、哪些不可用。

Source: https://docs.neurosquad.ai/zh/agents/antigravity

**Antigravity CLI**（`agy`）是谷歌的终端编程智能体，也是 Gemini CLI 的继任者：一个与 Antigravity
桌面应用共用智能体引擎的程序。它是闭源的——它的 GitHub 仓库里只有 README 和更新日志，没有代码。在
NeuroSquad 中，每个 Antigravity 智能体都是一张卡片，里面运行着真正的 `agy`。

基于 Antigravity CLI 1.3.1 测得。

## 安装

**1. 安装 agy 命令**

使用谷歌的安装程序。在 Windows 的 PowerShell 中：

```powershell
irm https://antigravity.google/cli/install.ps1 | iex
```

在 macOS 和 Linux 上：

```bash
curl -fsSL https://antigravity.google/cli/install.sh | bash
```

NeuroSquad 的 **Settings → Setup** 可以替你安装。

**2. 登录一次**

在终端里运行 `agy`，用谷歌账号登录——或者用 Gemini API 密钥设置（在它的设置中写
`modelProvider: "gemini"`，并在环境中设置 `GEMINI_API_KEY`）。它首次运行的界面——配色方案、谷歌条款
和数据使用同意——由你自己回答；NeuroSquad 绝不会替你作答。卡片也可以改用
[OpenRouter](https://docs.neurosquad.ai/zh/providers/openrouter) 或 [你自己的服务器](https://docs.neurosquad.ai/zh/providers/your-servers)。

**3. 添加 Antigravity 卡片**

添加一张智能体卡片并选择 **Antigravity CLI**。

## 可用功能

- **准确的状态。** agy 自己的生命周期钩子告诉卡片一轮何时开始（`PreInvocation`）、何时结束
（`Stop`）；agy 交给窗口标题命令的状态说明屏幕上何时出现确认，卡片会写明它想运行什么
（`run_command — rm -rf dist`）或它提出的问题。参见 [已完成 / 需要你的输入](https://docs.neurosquad.ai/zh/agents/notifications)。
- **箭头。** NeuroSquad 的 MCP 服务器写在卡片自己的 `mcp_config.json` 中，并由 `mcp(neurosquad/*)`
规则放行，所以它的工具从不询问。工具变化时 agy 会重新获取列表：工作中画出的箭头就在它的下一个请求里。
已安装的 MCP 服务器单独接入，每次调用前 agy 都会询问。
- **画布模式。** NeuroSquad 的钩子拒绝 `run_command`、`manage_task`、`search_web`、
`read_url_content` 和浏览器工具，命令因此都在终端卡片中运行——危险模式下也一样。参见
[画布模式](https://docs.neurosquad.ai/zh/squads/canvas-mode)。
- **会话。** 对话 id 由 agy 选定；卡片从钩子中得知它，重启后继续同一段对话
（`agy --conversation <id>`）。`/clear` 会把卡片切换到新的对话。找不到的对话会自动重新开始。
- **长会话。** 上下文指示器（基准是 agy 报告的窗口大小）、提示队列、工作日志和交接。agy 会自己压缩上下文。
- **用量。** 每个请求的令牌——输入、缓存命中、输出——都从 agy 自己的记录中读取；子智能体有各自的对话，
与父级一起统计并标明为子智能体，见 [用量与费用](https://docs.neurosquad.ai/zh/usage)、[Run Stats](https://docs.neurosquad.ai/zh/cards/run-stats) 和
[Agent Pulse](https://docs.neurosquad.ai/zh/cards/agent-pulse)。
- **模型与提供方。** 按卡片选择模型；领队智能体可以用 `agent_set_model` 更换。OpenRouter 和你自己的兼容
OpenAI 的服务器通过 NeuroSquad 在你电脑上运行的小型转换器工作（agy 只支持 Gemini API）；密钥不会到达 agy。
- **切换 CLI。** 把对话转到 Claude Code，再转回来。
- **插件。** [记忆](https://docs.neurosquad.ai/zh/plugins/mem0-memory)、[Context7](https://docs.neurosquad.ai/zh/plugins/context7-docs)、
[Caveman](https://docs.neurosquad.ai/zh/plugins/caveman) 和 [Graphify](https://docs.neurosquad.ai/zh/plugins/graphify) 通过 agy 的 `PreInvocation` 钩子进入它的每一轮。
- **用手机操作。** 卡片在 [远程访问](https://docs.neurosquad.ai/zh/remote) 中和其他卡片一样可用。

## 危险模式

处于危险模式的卡片会以 `--dangerously-skip-permissions` 启动 agy。agy 无法在运行中切换这一点，所以开启或
关闭都会以同一段对话重启卡片。参见 [危险模式](https://docs.neurosquad.ai/zh/agents/dangerous-mode)。

## 从 Gemini CLI 迁移过来

谷歌已于 2026 年 6 月 18 日对免费用户和 Pro/Ultra 订阅用户关闭 Gemini CLI，Antigravity CLI 取代了它在
NeuroSquad “添加卡片”菜单中的位置。你已有的 Gemini 卡片照常运行，标记为 **Gemini CLI (legacy)**；卡片上的
**切换到 Antigravity** 一键即可把对话带过去。引用 Gemini CLI 的模板会以 Antigravity CLI 打开。agy 会像
Gemini CLI 一样读取你的 `GEMINI.md` 和 `AGENTS.md`。

## 须知

- **不会写入你的 `~/.gemini`。** 每张卡片都用自己的 Gemini 文件夹运行 agy：它的设置、`hooks.json` 和
`mcp_config.json` 是你的配置加上 NeuroSquad 的一层，而你的对话、引导状态、插件、技能和规则以链接接入。
因此 `agy --conversation <id>` 在普通终端里同样可用。在卡片内更改的设置只保留在卡片中。
- **用 Esc 停止一轮。** 在空闲的 agy 上按 Ctrl+C 只会准备退出，所以 NeuroSquad 从不发送它——预算制动器和
手机上的按键行使用 Escape。
- **卡片内关闭了 agy 的自动更新。** 请在终端里更新（`agy update`）。
- **谷歌自家模型没有价格。** NeuroSquad 里还没有 Gemini 的标价，所以使用你谷歌登录的卡片显示令牌和
“无价格”——绝不会显示 $0。agy 为对话起标题的额外调用不在它的记录里，所以用量不会计入。
- **不支持令牌节省器。** [令牌节省器](https://docs.neurosquad.ai/zh/plugins/rtk-ai-token-saver) 会改写 shell 命令，而 agy 的钩子只能
允许、询问或拒绝命令，不能修改它。
- **你的数据与谷歌。** agy 在你的谷歌账号和谷歌条款下运行；除非你在 agy 的设置中选择退出，谷歌会收集交互
数据——参见 [antigravity.google/terms](https://antigravity.google/terms)。

> Antigravity 卡片目前只能在本机运行——暂不支持 WSL 或 SSH 工作区。