Antigravity CLI, set up step by step

Antigravity CLI (agy) is Google's AI coding agent for the terminal. One command installs it, your Google account signs you in, and /model lets you switch between Gemini, Claude and OpenAI's open GPT-OSS model.

01Open a terminal

In VS Code: Terminal → New Terminal (or Ctrl + Shift + `). Any normal terminal works too.

02Install with one command

Windows (PowerShell)

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

macOS / Linux

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

Check it worked:

agy --version

03Start it and sign in

agy

The first time, your browser opens: approve with your Google account and come back to the terminal. On a remote server over SSH, it prints a link instead; open it, approve, and paste the code back quickly (the prompt closes after about 30 seconds).

04Switch models and effort

1. Type /model and press Enter.
2. Use ↑ / ↓ to pick a model: Gemini (Flash for speed, Pro for harder work), Claude Sonnet / Opus, or GPT-OSS.
3. Use ← / → to set the effort: low (fast), medium, or high (thinks longer, better on hard tasks, uses more quota).
4. Press Enter to select.

05Your first task

Open the terminal inside your project folder, then try:

explain what this project does

fix the failing test and show me what you changed

Read the commands and file edits it proposes before you accept them. Type ? to see keyboard shortcuts.

06If something goes wrong

• agy: command not found (Mac/Linux): run export PATH="$HOME/.local/bin:$PATH", then try again (add it to your ~/.zshrc or ~/.bashrc to keep it).
• Windows says it's already installed: that's fine, it updates itself in the background. Just run agy.
• Quota reached: switch to a lighter model or lower effort, or wait for it to reset.