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

Gemini CLI	Antigravity CLI
`gemini`	`agy`
`gemini -p "..."`	`agy -p "..."`
`gemini --version`	`agy --version`
`gemini mcp add ...`	`agy mcp add ...`
`gemini mcp list`	`agy mcp list`
`gemini mcp remove ...`	`agy mcp remove ...`
`gemini extensions install ...`	`agy plugin install ...`
`gemini extensions list`	`agy plugin list`
`/ralph-loop`	`/agents` with hooks
`/extensions`	`/skills`
`/sandbox`	`/config` (permissions via `/permissions`)
`/model`	`/model`
`GEMINI.md`	`GEMINI.md` (unchanged)
`.geminiignore`	`.antigravityignore` (fallback to .geminiignore)
`~/.gemini/gemini.yaml`	`~/.gemini/antigravity-cli/settings.json`

Install

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

Auth

# OAuth
agy  # Follow browser flow on first run

# API Key
export ANTIGRAVITY_API_KEY="your-key"

# Enterprise
export GOOGLE_CLOUD_PROJECT="your-project"

Config Migration

Gemini CLI used YAML. Antigravity CLI uses JSON.

Old (~/.gemini/gemini.yaml):

model:
  name: gemini-2.5-pro
sandbox:
  mode: workspace

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

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

Ralph Loop → Subagents + Hooks

Old:

/ralph-loop "Refactor database layer" --max-iterations 50

New:

Create .gemini/hooks/verify then:

/agents "Refactor database layer" --max-iterations 50

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 format: YAML → JSON
Config path: ~/.gemini/gemini.yaml → ~/.gemini/antigravity-cli/settings.json
Session storage: ~/.gemini/brain/ → ~/.gemini/antigravity-cli/brain/
Extensions: Managed through skills now
Ralph loop: Replaced by agents + hooks

What Stays

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

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

CLI-First Development with Antigravity Image Pipeline

Use fast CLI tools for all coding, then switch to Antigravity for Nano Banana image generation. Both under one Google AI Pro plan with no per-image fees.

Prompt Engineering in Antigravity CLI

Effective prompting strategies for Antigravity CLI. Multi-model routing, system prompts, context management, hooks, subagents, and agent skills.

AI Coding Tools — Prompt Engineering & Configuration

Complete guides for Claude Code, OpenCode, Gemini CLI, Cursor, GitHub Copilot, and more. Tool-specific prompt patterns, configuration files, and setup guides for every major AI coding assistant.

Antigravity CLI — Migration Guide from Gemini CLI