Antigravity CLI Getting Started — Gemini CLI Replacement

Google announced Antigravity CLI at I/O 2026 as the successor to Gemini CLI. Gemini CLI stops serving on June 18, 2026 for non-enterprise users. Here’s everything you need to know about the transition.

What Is Antigravity CLI?

Antigravity CLI (agy) is Google’s agent-first development tool, built in Go, powered by Gemini 3.5 Flash. It replaces Gemini CLI with a more capable agent framework that supports:

• Headless execution (-p mode)
• Workspace management (--add-dir)
• Session resume (--conversation)
• Plugin system
• Auto-permissions in headless mode

Installation

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

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

# Verify
agy --version
# Expected: 1.0.0

Basic Usage

Interactive Mode

agy

Opens an interactive session. Type your prompt, agy responds. Like a chat.

Headless Mode (Non-Interactive)

agy -p "explain what this function does" --add-dir ./src

Runs a single prompt, prints the response to stdout, and exits. This is the mode used for automation and multi-model workflows.

Working with Files

# Add a directory to the workspace
agy -p "list all TypeScript files and count lines" --add-dir /path/to/project

# agy can read, create, and modify files in the workspace
agy -p "create a README.md with project documentation" --add-dir .

Session Resume

# Continue the most recent conversation
agy -c

# Resume a specific conversation by ID
agy --conversation <conversation-id>

Migrating from Gemini CLI

Gemini CLI	Antigravity CLI	Notes
gemini -p "prompt"	agy -p "prompt"	Same flag
gemini -r session_id	agy --conversation id	Different flag name
gemini --include-directories /path	agy --add-dir /path	Different flag name
gemini -y	Auto in -p mode	No flag needed
gemini -m model-name	Not available	Fixed to Gemini 3.5 Flash
gemini -o stream-json	Not available	Plain text output only

Key difference: Antigravity CLI outputs plain text (no JSON streaming). This affects tools that parse Gemini’s JSON event stream.

Integration with CCG Workflow

CCG Workflow v3.1.0+ has native Antigravity CLI support. It’s the default frontend model.

# Install CCG with Antigravity as frontend
npx ccg-workflow
# Select "Antigravity" as frontend model in Step 2

# Use it
/ccg:go build a responsive navbar component
# CCG automatically routes frontend tasks to Antigravity CLI

The codeagent-wrapper binary handles the Antigravity CLI integration transparently — including plain text output parsing, workspace passthrough, and session management.

Timeline

Date	Event
May 19, 2026	Antigravity CLI 1.0 launched at Google I/O
June 18, 2026	Gemini CLI stops serving (free/Pro/Ultra users)
Post June 18	Enterprise users retain Gemini CLI access

FAQ

Q: Do I need to migrate immediately? A: No. Gemini CLI works until June 18. But setting up Antigravity CLI now gives you time to test.

Q: Is Antigravity CLI free? A: Same pricing model as Gemini CLI — free tier available, Pro/Ultra for higher usage.

Q: Can I use Antigravity CLI with other AI tools? A: Yes. CCG Workflow orchestrates Antigravity alongside Claude and Codex. Learn more →

Q: What about enterprise Gemini CLI users? A: Enterprise licenses (Gemini Code Assist Standard/Enterprise) retain Gemini CLI access with continued model updates.

Related Guides

• Claude Code vs Codex vs Gemini
• How to Use Multiple AI Models Together
• Claude Code Best Practices 2026

---

Guide based on Antigravity CLI 1.0.0 released May 19, 2026.