Google Antigravity CLI: The Free Gemini Agent in Your Terminal

Why Antigravity Matters

Google Antigravity is an agent-first development platform built around Gemini. Unlike a chat assistant that only suggests code, Antigravity plans work, edits files, runs terminal commands, and verifies the result across a project. It ships in three forms: a desktop app, an IDE, and a terminal CLI called agy.

For developers who live in a shell, the CLI is the fastest way in. It is free with a personal Google account, which makes it one of the most accessible frontier agents for students, indie developers, and teams already standardized on Google Cloud.

Install the CLI

macOS and Linux:

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

Windows PowerShell:

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

Verify the installation:

agy --version

Sign In

Run agy with no arguments. It opens a browser window for Google sign-in, then returns you to the terminal once authentication completes.

agy

Your First Task

Change into a repository and describe the outcome rather than the keystrokes:

cd my-project
agy -p "Add integration tests for the payments module and run them"

The agent reads the project, proposes a plan, edits files, and executes the test command. Review each diff before accepting it, especially in repositories that deploy automatically from the main branch.

CLI or IDE?

Use the CLI when you want to script agents, work over SSH, or keep your existing editor. Use the Antigravity IDE or desktop app when you want the visual Agent Manager, artifact review, and browser control in one window. Both surfaces share the same underlying agent capabilities, so you can start in one and continue in the other.

Permissions and Safety

Antigravity asks before running commands that reach the network or touch files outside the workspace. Keep those prompts enabled. In larger repositories, add an AGENTS.md or rules file so the agent knows your build commands, test suite, and coding conventions. Explicit instructions reduce wasted tool calls and make review easier.

Where It Fits

Antigravity is a strong default for Gemini users: free access, a real terminal agent, and tight integration with Google models and Google Cloud. Pair it with the AI Launchpad on Tecrese to compare it against Codex and Claude Code before committing your workflow.