Antigravity CLI: install, commands, and how agy works

What Antigravity CLI is

Google Antigravity started in November 2025 as an agent-first IDE built around Gemini 3. At I/O on 19 May 2026 it became a platform rather than an editor, and the CLI shipped as one of its surfaces. The important consequence for anyone in a terminal: Antigravity CLI is the successor to Gemini CLI, and on 18 June 2026 Gemini CLI stopped serving requests for free, Google AI Pro, and Google AI Ultra accounts.

The CLI and the desktop app share an agent core and sync settings, so a conversation started in the terminal can be exported into the desktop app when it outgrows a single pane.

Install it

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

agy --version

winget install Google.AntigravityCLI

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

curl -fsSL https://antigravity.google/cli/install.cmd -o install.cmd && install.cmd && del install.cmd

The installer edits your shell profile to add that directory to PATH and to register aliases. Two flags turn that off if you manage your own dotfiles.

curl -fsSL https://antigravity.google/cli/install.sh | bash -s -- --skip-path --skip-aliases

# then, if you change your mind
agy install     # configures environment paths and shell settings

agy update
agy changelog

First run

cd ~/code/your-project
agy

/usage      # or /quota
/credits    # remaining credits

Models and reasoning effort

One binary reaches three vendors. agy models prints exactly what your account can use, which is the only list worth trusting because it changes.

agy models

gemini-3.6-flash-high
gemini-3.6-flash-medium
gemini-3.6-flash-low
gemini-3.5-flash-high
gemini-3.5-flash-medium
gemini-3.5-flash-low
gemini-3.1-pro-high
gemini-3.1-pro-low
claude-sonnet-4-6
claude-opus-4-6-thinking
gpt-oss-120b-medium

Note that effort is baked into most model slugs. You can also set it separately.

agy --model gemini-3.1-pro-high --effort high
agy --model gemini-3.6-flash-low --effort low

Commands and flags

Subcommands

Flags

Slash commands

Headless mode

This is the part that makes agy useful in a Makefile, a git hook, or CI. It runs one prompt, prints, and exits.

agy -p "what does the retry logic in internal/queue do?"

# structured, for anything downstream
agy -p "list every exported function missing a doc comment" \
    --output-format json | jq

# streaming, when you want to watch a long run
agy -p "run the test suite and fix failures" --output-format stream-json

# multi-turn scripting
agy -p "now add tests for the case you just fixed" --continue

Exit code 0 means success, non-zero means failure, and the JSON payload carries a status of SUCCESS, ERROR, CANCELED, INTERRUPTED, INVALID, WAITING, or RUNNING. Check the status, not just the exit code: a run that ends WAITING on an approval is not a run that failed.

Permissions in headless runs

By default a headless run still respects your settings, and a tool that needs approval is soft-denied with a note on stderr. That is the correct default and the reason a CI job can appear to do nothing. Grant specific permissions rather than reaching for the blunt flag.

{
  "permissions": {
    "allow": ["command(git)", "write_file(src/)"]
  }
}

Coming from Gemini CLI

The two tools are the same idea with a different implementation. Most of your configuration carries over, and the CLI offers to migrate it the first time you run it.

# 1. extensions become plugins
agy plugin import gemini
agy plugin list

# 2. workspace skills move by hand
git mv .gemini/skills .agents/skills

agy plugin import also accepts claude, so a Claude Code plugin set can be brought across the same way.

The GitHub repository

The repository is github.com/google-antigravity/antigravity-cli. Two things about it surprise people arriving from the Gemini CLI repo, which had 106,000 stars and full Apache 2.0 source.

It is the place Google directs bug reports and feature requests, and where the changelog and examples live. It is not a mirror of the agent implementation. Gemini CLI was Apache 2.0 with the source in the open; Antigravity CLI ships as a proprietary binary with a public issue tracker. If open source is a hard requirement for you, that is the decision point, not the feature list.

When it does not behave

Questions people ask

Keep reading