Skip to Content
智能体Antigravity CLI

Antigravity CLI

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

基于 Antigravity CLI 1.3.1 测得。

安装

安装 agy 命令

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

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

在 macOS 和 Linux 上:

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

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

登录一次

在终端里运行 agy,用谷歌账号登录——或者用 Gemini API 密钥设置(在它的设置中写 modelProvider: "gemini",并在环境中设置 GEMINI_API_KEY)。它首次运行的界面——配色方案、谷歌条款 和数据使用同意——由你自己回答;NeuroSquad 绝不会替你作答。卡片也可以改用 OpenRouter 或 你自己的服务器。

添加 Antigravity 卡片

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

可用功能

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

危险模式

处于危险模式的卡片会以 --dangerously-skip-permissions 启动 agy。agy 无法在运行中切换这一点,所以开启或 关闭都会以同一段对话重启卡片。参见 危险模式。

从 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 为对话起标题的额外调用不在它的记录里,所以用量不会计入。
  • 不支持令牌节省器。 令牌节省器 会改写 shell 命令,而 agy 的钩子只能 允许、询问或拒绝命令,不能修改它。
  • 你的数据与谷歌。 agy 在你的谷歌账号和谷歌条款下运行;除非你在 agy 的设置中选择退出,谷歌会收集交互 数据——参见 antigravity.google/terms 。

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