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

Prompt Engineering in Cursor

Master prompt engineering in Cursor IDE. Agent mode vs inline editing, composer prompts, codebase-aware prompting, and .cursorrules integration strategies.

ZCode Is Not a Claude Code Clone — Zhipu's Chat-Triggered Coding Agent Is Something Stranger and More Interesting

Zhipu AI (Z.ai) just released ZCode 3.0 — an agentic development environment built around GLM-5.2 with a killer feature no Western tool has: trigger coding tasks from WeChat, Feishu, or Telegram. Here's what it means for the global coding agent market.

Antigravity CLI — AI Coding Agent for Everyone

Google's terminal-based AI coding agent. Replaces Gemini CLI for individual consumers. Go-native, multi-model, async workflows. Install with curl, authenticate with Google, start coding.

Antigravity CLI — Migration Guide from Gemini CLI