Antigravity CLI — Migration Guide

Gemini CLI is deprecated for individual consumers as of June 18, 2026. This guide covers the complete migration to Antigravity CLI (agy).

For the detailed step-by-step with troubleshooting, see the blog migration guide. This page is a quick-reference.

Quick Reference: Command Mapping

Install

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

Auth

# OAuth
agy  # Follow browser flow on first run

# Gemini API key
export GEMINI_API_KEY="your-key"
# Also set "modelProvider": "gemini" in settings.json

# Enterprise (ADC)
gcloud auth application-default login --project your-project
export AGY_ADC_AUTH=true

Config Migration

Both CLIs use JSON settings files. Gemini CLI reads ~/.gemini/settings.json; Antigravity CLI reads ~/.gemini/antigravity-cli/settings.json.

Old (~/.gemini/settings.json):

{
  "model": {
    "name": "gemini-3.8-flash"
  },
  "tools": {
    "sandbox": "docker"
  }
}

New (~/.gemini/antigravity-cli/settings.json):

{
  "model": "Gemini 3.8 Flash (High)",
  "enableTerminalSandbox": false,
  "toolPermission": "request-review"
}

Extensions and Custom Commands → Plugins and Skills

Antigravity CLI does not have a /ralph-loop command. It imports Gemini CLI extensions and their commands as plugins and skills:

agy plugin import gemini

Workspace skills move from .gemini/skills/ to .agents/skills/; global skills move to ~/.gemini/antigravity-cli/skills/. Extensions become plugins managed with /plugin or agy plugin.

CI/CD Update

Old:

gemini -p "Review this PR" --output-format json

New:

agy -p "Review this PR" --output-format json

What Changes

• Binary: gemini → agy
• Config path: ~/.gemini/settings.json → ~/.gemini/antigravity-cli/settings.json
• Session storage: ~/.gemini/brain/ → ~/.gemini/antigravity-cli/brain/
• Extensions: Imported as plugins with agy plugin import gemini

What Stays

• GEMINI.md and AGENTS.md files
• MCP support (re-add servers)
• Sandbox modes
• Slash commands (/help, /clear, /model, etc.)
• Checkpointing
• Headless mode

Related

• Migration Guide Blog Post — Step-by-step with troubleshooting
• What You Need to Know — Transition overview + migration guide
• Getting Started — Fresh install walkthrough

Sources

• Migrating from Gemini CLI
• Antigravity authentication
• Antigravity plugins
• Antigravity MCP configuration
• Gemini CLI settings