Installing Antigravity CLI: a basic guide

Goal

By the end you'll have Antigravity CLI installed, signed in with your Google account, and a first agent task running against a real project.

Antigravity CLI is the terminal-first surface for Google's Antigravity platform. The binary is called agy. It runs the same agents you'd use in the Antigravity editor, but from the terminal: natural-language tasks, parallel subagents, MCP servers, and slash commands, without switching context.

Prerequisites

macOS, Linux, or Windows (PowerShell or CMD).
A terminal with permission to install binaries onto your PATH.
A Google account with access to Antigravity.
A local project to work on.

This guide covers Antigravity CLI v1.1.22.

Steps

1. Install the binary

Pick the method for your system.

macOS / Linux:

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

Windows (PowerShell):

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

Windows (CMD):

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

The installer places the agy binary at:

macOS / Linux: ~/.local/bin/agy
Windows: C:\Users\<username>\AppData\Local\agy\bin

If agy isn't found after installing, add that directory to your PATH and open a new terminal.

2. Verify the install

agy --version

Expected check: it prints the installed version (for example 1.1.22). If the shell says "command not found", open a new session so it picks up the updated PATH.

Navigate to a project and start the CLI:

cd path/to/your/project
agy

The first run walks you through:

Color scheme — Solarized Dark, Dark, Solarized Light, or your terminal's own colors.
Rendering mode — Alt-Screen (full-screen TUI) or Inline (keeps output in your terminal history).
Workspace trust — confirm you trust this repository. The agent then indexes the files.

Authentication runs through your Google account: a browser window opens for you to sign in. On a remote machine, copy the URL shown in the terminal and open it locally.

4. Run your first task

Inside the session, describe what you want in plain language:

Write a simple Python script to fetch the text of a web page

The agent plans, edits files, and runs commands, pausing for your approval on anything it can't undo.

5. Explore the built-in commands

/agents        # launch and manage parallel subagents
/config        # terminal and behavior settings
/keybindings   # view and customize shortcuts

Expected result

agy --version prints the version.
agy opens the TUI on your project after the one-time setup.
You're signed in with your Google account and the workspace is trusted and indexed.
A first natural-language task produces real file changes.

Troubleshooting

Common issues

agy: command not found after installing: the installer added the binary to your PATH but your current shell didn't pick it up. Open a new terminal, or add the install directory (~/.local/bin on macOS/Linux) to your PATH manually.
Browser doesn't open for sign-in: copy the authentication URL printed in the terminal and open it in a browser yourself. Useful over SSH.
Agent won't touch files: you likely skipped workspace trust or marked the repo untrusted. Restart agy in the project and confirm trust.
TUI clears your scrollback: you picked Alt-Screen rendering. Re-run setup or use /config to switch to Inline mode.

Next step

Configure the CLI per project with /config, wire up MCP servers for external tools and data, and use /agents to fan a large task out across parallel subagents.