Skip to main content

Documentation Index

Fetch the complete documentation index at: https://mintlify.com/google-antigravity/antigravity-cli/llms.txt

Use this file to discover all available pages before exploring further.

This guide walks you through everything you need to go from zero to your first working session with Antigravity CLI. By the end, you will have agy installed, authenticated, and running on a real task in your codebase.
1

Install the CLI

Run the one-line installer for your platform. On macOS or Linux, open a terminal and run:
curl -fsSL https://antigravity.google/cli/install.sh | bash
On Windows PowerShell:
irm https://antigravity.google/cli/install.ps1 | iex
On Windows Command Prompt:
curl -fsSL https://antigravity.google/cli/install.cmd -o install.cmd && install.cmd && del install.cmd
After the installer finishes, open a new terminal window so the agy command is available on your PATH. See Installation for platform-specific details and verification steps.
2

Authenticate with your Google account

Launch the CLI from your terminal:
agy
Antigravity CLI authenticates through the system keyring. On your first launch — or whenever no saved session exists — it starts a Google Sign-In flow:
  • Local machine: Your default browser opens automatically to the Google Sign-In page. Complete sign-in there and return to the terminal.
  • Remote / SSH session: The CLI detects that no browser is available and prints an authorization URL instead. Open that URL in a browser on any device, complete sign-in, and the terminal session will resume automatically.
Run /logout at any time to clear your saved credentials and sign out.
For enterprise access using a GCP project, see Authentication for the full setup flow.
3

Start your first session

Once authenticated, you are in an interactive chat session. Navigate to a project directory before launching, or start from any directory and reference paths explicitly in your prompt.Type a task in plain language and press Enter. For example:
Add input validation to the user registration form in src/forms/register.ts
The agent reads the relevant files, reasons through the changes needed, and presents a diff for your review before applying anything. You approve or reject each proposed change.
The agent will never apply edits or run commands without your explicit approval. You remain in control of every action.
4

Use slash commands

Slash commands give you direct control over the CLI from within a session. Type / to see a list of available commands. Commonly used commands include:
  • /resume — Open a previous session and continue where you left off.
  • /logout — Sign out and clear saved credentials.
  • /usage — View real-time model usage and remaining quota.
  • /quota — Check your current quota limits.
  • /settings — Open Settings to adjust preferences and permissions.
For the full list of available commands and their options, see the Command reference.

​
Next steps

You are ready to use Antigravity CLI. Here are useful places to go from here:
  • Authentication — Learn about the full auth flow, enterprise GCP access, and managing credentials.
  • Command reference — Browse every slash command available in the CLI.
  • Remote SSH guide — Configure Antigravity CLI for headless and remote environments.
  • Export to GUI — Continue a terminal session in the Antigravity 2.0 interface.

Build docs developers (and LLMs) love

Get started for freeTalk to us