All Antigravity CLI commands explained: installation, agy flags, slash commands, MCP integration, and model selection. The reference for Google's AI terminal.
Links marked with * are affiliate links. If a purchase is made through such links, we receive a commission.
"Free? That can't be as good as Claude Code..." That was my first thought when I heard about the Gemini CLI back in 2025. Google had just released their AI terminal as open source.
That story has since come to an end. Google shut down the Gemini CLI on June 18, 2026 and replaced it with the Antigravity CLI: a new terminal tool with the command agy that belongs to the Antigravity platform. New commands, new models, new limits. And yes: a few bitter pills to swallow, too.
In this article, I'll show you all Antigravity CLI commands, from installation to slash commands to MCP integration. Plus a close look at what changed compared to the Gemini CLI and when switching makes sense.
TL;DRKey Takeaways
The Antigravity CLI (command: agy) is Google's successor to the Gemini CLI, which was shut down on June 18, 2026
/plan, /goal, /model, and shell mode via ! are the most important commands for your daily workflow
Besides Gemini 3.6 Flash and 3.1 Pro, you can also pick Claude Sonnet 4.6 and Opus 4.6 as models
The free tier is much smaller than before: about 20 agent requests per day instead of 1,000
From Gemini CLI to Antigravity CLI: What Happened?
The switch happened fast, but Google did announce it beforehand.
At I/O 2026, Google introduced Antigravity 2.0 and announced that the entire terminal experience would move there. One month later, on June 18, 2026, it was over: the Gemini CLI and the Gemini Code Assist extensions stopped serving consumer requests.
The problem is: this wasn't just a rename. The Gemini CLI was an open-source project with over 105,000 GitHub stars. The Antigravity CLI is a closed-source Go binary. And the generous free tier of 1,000 requests per day shrank to about 20 agent requests per day. The community was understandably angry, and I get it.
The good news:
Technically, the Antigravity CLI is a real step forward. Subagents that work in parallel, background tasks, hooks, a planning mode, and free model choice including Claude models. Yes, you read that right: you can work with Claude Opus inside Google's own terminal tool.
Installing the Antigravity CLI
Installation no longer runs through npm but through an install script from Google:
# macOS and Linux
curl -fsSL https://antigravity.google/cli/install.sh | bash
# Windows (PowerShell)
irm https://antigravity.google/cli/install.ps1 | iex
# Afterwards: verify the installation
agy --version
Authentication
The first time you run agy, your browser opens for login. You have two options: a regular Google account (OAuth) or a Google Cloud project for enterprise setups.
Note
Your settings live in ~/.gemini/antigravity-cli/settings.json, by the way. Google kept the old Gemini CLI configuration directory, a little quirk of the migration.
Basic Commands: The Daily Workflow
Getting started is simple: type agy and go. For scripts and quick questions, there's the non-interactive mode:
# Interactive mode in the current directory
agy
# Quick question without a session
agy -p "Explain the architecture of this codebase"
# Start with a specific model
agy --model "Gemini 3.1 Pro (High)"
# Auto-approve all tool calls (careful!)
agy --dangerously-skip-permissions
Warning
The --dangerously-skip-permissions flag runs all tool calls without asking. The name says it all. Only use this in projects where nothing can break!
By default, the CLI asks before every action. You can fine-tune this in the settings with four permission modes: request-review (default), proceed-in-sandbox, always-proceed, and strict.
All Slash Commands in Detail
Here's the complete list of slash commands I was able to verify. The most exciting ones first: /plan, /goal, and /grill-me didn't exist in the Gemini CLI.
Command/help
DescriptionShows the help menu with three tabs (general, commands, shortcuts)
Example / Tip/help
Command/model
DescriptionShows available models and switches between them
Example / TipSwitch between Gemini 3.6 Flash and Claude Opus 4.6
Command/plan
DescriptionCreates an implementation plan before touching any code
Example / Tip/plan Refactor the login page
Command/goal
DescriptionKeeps working until the specified goal is completely finished
Example / Tip/goal All tests pass
Command/grill-me
DescriptionInterview mode: the AI grills you with questions before planning
Example / TipIdeal before larger features
Command/btw
DescriptionAsks a side question without interrupting the running task
Example / Tip/btw What does this function do?
Command/diff
DescriptionShows all changes directly in the terminal
Example / TipReview before approving edits
Command/context
DescriptionShows current context usage
Example / TipCheck regularly during long sessions
Command/agents
DescriptionDisplays all active agents
Example / TipOverview when running parallel subagents
Command/tasks
DescriptionMonitors background processes
Example / TipUse together with Ctrl+b
Command/artifacts
DescriptionShows and manages plans and artifacts
Example / TipLook up implementation plans
Command/mcp
DescriptionVerifies configured MCP servers
Example / Tip/mcp
Command/hooks
DescriptionInspects all loaded and active hooks
Example / TipCheck which interceptors are running
Command/config
DescriptionOpens the settings overlay (color scheme, options)
Example / TipAlternative: /settings
Command/keybindings
DescriptionCustomizes keyboard shortcuts
Example / TipOr edit the JSON file directly
Command/quit
DescriptionExits the Antigravity CLI cleanly
Example / TipAlternative: press Ctrl+D twice
Description
Example / Tip
/help
Shows the help menu with three tabs (general, commands, shortcuts)
Creates an implementation plan before touching any code
/plan Refactor the login page
/goal
Keeps working until the specified goal is completely finished
/goal All tests pass
/grill-me
Interview mode: the AI grills you with questions before planning
Ideal before larger features
/btw
Asks a side question without interrupting the running task
/btw What does this function do?
/diff
Shows all changes directly in the terminal
Review before approving edits
/context
Shows current context usage
Check regularly during long sessions
/agents
Displays all active agents
Overview when running parallel subagents
/tasks
Monitors background processes
Use together with Ctrl+b
/artifacts
Shows and manages plans and artifacts
Look up implementation plans
/mcp
Verifies configured MCP servers
/mcp
/hooks
Inspects all loaded and active hooks
Check which interceptors are running
/config
Opens the settings overlay (color scheme, options)
Alternative: /settings
/keybindings
Customizes keyboard shortcuts
Or edit the JSON file directly
/quit
Exits the Antigravity CLI cleanly
Alternative: press Ctrl+D twice
Tip
/grill-me is underrated! The AI asks you detailed interview-style questions before implementing anything. It feels like extra work at first, but it saves you massive correction loops afterwards.
Shell Mode and Background Tasks
With the exclamation mark, you switch into shell mode and run regular terminal commands without leaving the session:
# Toggle shell mode (and back with !)
! git status
# Send a running task to the background: Ctrl+b
# Then monitor its progress:
/tasks
# Display active agents:
/agents
The combination of Ctrl+b and /tasks is one of the biggest improvements over the Gemini CLI: you can let a long task keep running and kick off the next one in parallel.
Keyboard Shortcut!
DescriptionToggles shell mode on and off
ContextExample: ! git status
Keyboard ShortcutCtrl+b
DescriptionSends the running task to the background
ContextMonitor with /tasks
Keyboard ShortcutCtrl+D
DescriptionExits the CLI (press twice)
ContextAlternative: /quit
Description
Context
!
Toggles shell mode on and off
Example: ! git status
Ctrl+b
Sends the running task to the background
Monitor with /tasks
Ctrl+D
Exits the CLI (press twice)
Alternative: /quit
CLI Flags
The Antigravity CLI is more spartan with flags than its predecessor. These are the most important documented options:
Flagagy
DescriptionStarts interactive mode in the current directory
Exampleagy
Flag-p
DescriptionNon-interactive mode: one task, one answer, done
Exampleagy -p "Explain the architecture of this codebase"
Flag--model
DescriptionStarts directly with a specific model
Exampleagy --model "Gemini 3.1 Pro (High)"
Flag--dangerously-skip-permissions
DescriptionRuns all tool calls without asking (careful!)
ExampleOnly use in throwaway projects
Flag--version
DescriptionShows the installed version
Exampleagy --version
Description
Example
agy
Starts interactive mode in the current directory
agy
-p
Non-interactive mode: one task, one answer, done
agy -p "Explain the architecture of this codebase"
--model
Starts directly with a specific model
agy --model "Gemini 3.1 Pro (High)"
--dangerously-skip-permissions
Runs all tool calls without asking (careful!)
Only use in throwaway projects
--version
Shows the installed version
agy --version
Model Selection: Gemini, Claude, and GPT-OSS
With /model, you pick the model for your task. And this is where it gets interesting, because Google doesn't limit you to its own models:
Fast everyday tasks, most generous free-tier limits
Gemini 3.1 Pro (Low/High)
Google
Complex coding and reasoning tasks
Claude Sonnet 4.6 (Thinking)
Anthropic
Strong all-round coding with visible reasoning
Claude Opus 4.6 (Thinking)
Anthropic
Demanding architecture and refactoring work
GPT-OSS 120B (Medium)
OpenAI (open weights)
Open-weights option for simpler tasks
Tip
For fast everyday tasks, Gemini 3.6 Flash is plenty, and it has the most generous limits. I save the Claude and Pro models for complex refactorings, where the small free tier would otherwise burn up quickly.
MCP Integration
Model Context Protocol (MCP) works in the Antigravity CLI too, but the configuration has moved compared to the Gemini CLI. There are two levels: global for all projects and local per workspace:
Then use /mcp to check whether your servers are connected. The output shows you which tools they provide.
Subagents, Skills, and Hooks
Under the hood, the Antigravity CLI is a multi-agent system. Three building blocks are worth knowing:
Subagents work asynchronously and in parallel without blocking your main session. Keep track of them with /agents. Skills are markdown-based blueprints for teaching the CLI recurring workflows, a concept similar to Claude Code. And hooks are interceptors that run automatically before or after certain actions; use /hooks to see which ones are active.
Limits and Pricing
Now for the unpleasant part. The Antigravity CLI is officially free during the public preview, but the quotas are rough:
The free tier only includes about 20 agent requests per day, with quotas refreshing every five hours. That's a steep drop from the Gemini CLI's 1,000 requests per day. Paid tiers raise the ceiling: Google AI Pro starts at $20 a month, and the top AI Ultra Max plan costs $200 a month for a much larger quota. Once your quota runs out, you can also buy credits directly.
Note
For serious daily use, you won't get around a subscription. The free tier lets you test the tool, nothing more. Check your usage regularly with /context.
Frequently Asked Questions About Antigravity CLI Commands
The Antigravity CLI (command: agy) is Google's AI agent for the terminal and the official successor to the Gemini CLI. It is the lightweight terminal interface of the Antigravity platform and supports multi-step reasoning, multi-file editing, subagents, hooks, and MCP integration.
During the public preview, the Individual plan costs $0 but is heavily metered: the free tier only includes about 20 agent requests per day. Paid tiers add more quota, from Google AI Pro at $20 a month up to AI Ultra Max at $200 a month. AI Ultra Max includes roughly 20 times the quota of the Pro plan, plus purchasable credits.
Google shut down the Gemini CLI and the Gemini Code Assist extensions for consumer requests on June 18, 2026. The open-source project with over 105,000 GitHub stars was effectively retired, and its successor, the Antigravity CLI, is closed source. The community was not amused.
Yes. Besides Gemini 3.6 Flash and Gemini 3.1 Pro, you can pick Claude Sonnet 4.6 and Claude Opus 4.6 (both with thinking) as well as GPT-OSS 120B. Switch models with /model.
No. Unlike the Gemini CLI, agy is a closed-source Go binary. If you want an open-source terminal tool, you'll need alternatives like OpenClaw or Aider.
Yes. You configure MCP servers globally in ~/.gemini/antigravity-cli/mcp_config.json or per project in .agents/mcp_config.json. Use /mcp to verify which servers are connected.
Finn Hillebrandt is the founder of Gradually AI, an SEO and AI expert. He helps online entrepreneurs simplify and automate their processes and marketing with AI. Finn shares his knowledge here on the blog in 50+ articles as well as through the AI Business Club.