先判断你是不是需要迁移
如果你用的是个人 Google 账号、Google AI Pro、Google AI Ultra，或免费的 Gemini Code Assist for individuals，先按这篇迁到 Antigravity CLI。
Google 官方公告写明，2026-06-18 起，这些个人路径下的 Gemini CLI 和 Gemini Code Assist IDE extensions 会停止服务请求。企业许可和 Google Cloud 路径不一样，不要把所有账号都当成同一种情况。
| 需要迁移 | 个人账号 / Google AI Pro / Google AI Ultra / 免费 Gemini Code Assist for individuals |
| 不急着迁移 | Gemini Code Assist Standard 或 Enterprise / Google Cloud 管理的企业路径 |
| 关键日期 | 2026-06-18 |
先保留旧 Gemini CLI 配置
迁移前不要先删 `~/.gemini`，也不要先卸载 Gemini CLI。Antigravity CLI 第一次启动时会识别一部分 Gemini CLI 配置，并给出迁移选项。
先装新 CLI，确认 `agy` 能启动，再决定旧 CLI 是否保留。这样出问题时还能对照旧配置。
Windows 安装 Antigravity CLI
Windows 用 PowerShell 安装。安装完成后重新打开一个终端窗口，让新的 `agy` 路径生效。
irm https://antigravity.google/cli/install.ps1 | iexmacOS 或 Linux 安装 Antigravity CLI
macOS 和 Linux 用官方安装脚本。默认情况下，`agy` 会被放到用户本地 bin 路径里。安装后重新打开 shell。
curl -fsSL https://antigravity.google/cli/install.sh | bash确认 agy 命令可用
重新打开终端后，先确认系统能找到 `agy`。如果命令不存在，先检查 PATH，不要直接重装一遍。
agy --version
agy --help进入项目第一次启动
在你平时使用 Gemini CLI 的项目目录里启动 `agy`。第一次启动会让你选择主题、渲染方式、工作区信任和登录方式。
不要在无关目录启动后再让它猜项目路径。AI 编程 CLI 的上下文来自当前工作区。
cd your-project
agy导入 Gemini CLI 扩展
第一次启动时如果看到迁移选项，可以直接选择迁移 Gemini CLI extensions。错过了首次提示，也可以手动导入。
导入后看输出里哪些项目是 `processed`，哪些是 `skipped`。被跳过的扩展不要硬猜，先回到对应插件或 MCP 配置里检查。
agy plugin import gemini确认项目规则仍然生效
Antigravity CLI 会继续读取工作区里的 `GEMINI.md` 和 `AGENTS.md`。如果你的项目规则已经写在这些文件里，先启动 `agy` 看它是否按规则工作，不需要立刻重写一套。
全局规则仍然优先放在用户目录，项目规则放在项目根目录。不要把个人偏好写进会提交到仓库的项目文件。
| 项目规则 | GEMINI.md / AGENTS.md |
| 全局规则 | ~/.gemini/GEMINI.md |
| 先验证 | 让 agy 读项目规则，不改文件 |
移动项目级 Skills
如果你只用了全局 Skills，先在 `agy` 里运行 `/skills` 看是否已经加载。不要为了迁移先乱搬目录。
如果某个项目里原来有 `.gemini/skills`，Antigravity CLI 的项目级位置是 `.agents/skills`。确认这些技能确实还要用，再移动。
| Gemini CLI 项目 Skills | .gemini/skills |
| Antigravity CLI 项目 Skills | .agents/skills |
| 先检查 | 在 agy 里运行 /skills |
检查 MCP 配置
如果你在 Gemini CLI 里接过 MCP，迁移后重点看 MCP 是否还能显示、能不能调用。Antigravity CLI 会把 MCP 配置放到单独的 `mcp_config.json` 里。
远程 MCP 的字段也要注意：旧配置里如果写的是 `url` 或 `httpUrl`，迁到 Antigravity CLI 时应改成 `serverUrl`。
| 全局 MCP | ~/.gemini/antigravity-cli/mcp_config.json |
| 项目 MCP | .agents/mcp_config.json |
| 远程地址字段 | serverUrl |
用一个只读任务验证
迁移完成后，不要马上交给它改项目。先让 Antigravity CLI 只读当前项目，确认规则、Skills、MCP 和权限提示都正常。
这个任务不应该产生文件改动。它能稳定返回，再开始做真实修改。
先阅读当前项目，不要改文件。
请列出：
1. 项目使用的包管理器
2. 主要启动命令
3. 已加载的项目规则
4. 你认为需要我确认的权限动作迁移完成后确认三件事
最后只看三个结果。`agy` 能在项目里启动，原来的规则文件能被读取，一个只读任务能正常返回，这次迁移就先完成。
如果 2026-06-18 后旧 Gemini CLI 开始请求失败，先用 Antigravity CLI 继续当前工作，不要再围着旧 CLI 的登录状态排查。
- `agy --help` 能正常输出。
- 在项目目录启动 `agy` 后，能完成登录和工作区信任。
- 只读验证任务没有改文件，并且能读到 `GEMINI.md` 或 `AGENTS.md`。