How to Install and Use the Antigravity CLI

Google launched the Antigravity command-line interface (CLI) as a standalone terminal agent under the binary name agy on May 19, 2026. Conversations started in the terminal open in the Antigravity 2.0 desktop app, so a CLI session can be picked up there.

Installation requires a single shell command followed by browser-based authentication with a Google account or headless configuration with an application programming interface (API) key.

Antigravity CLI Installation and Authentication

The Antigravity CLI installs with one command: a curl script on macOS, Linux and Googlebook, or a PowerShell line on Windows.

On a machine with a browser, you sign in to agy with a Google account.

For headless use, users authenticate by exporting a GEMINI_API_KEY environment variable and configuring "modelProvider":"gemini" inside client settings.

• macOS, Linux, and Googlebook installation: curl -fsSL https://antigravity.google/cli/install.sh | bash
• Windows PowerShell installation: irm https://antigravity.google/cli/install.ps1 | iex
• Interactive login: run agy in any terminal window and complete the Google account authentication prompt in the browser
• Headless login: set GEMINI_API_KEY and set modelProvider to gemini in configuration settings

Core Commands and Terminal Slash Workflows

To start the Antigravity CLI, run agy in a project folder.

Inside a session you type slash commands. Subagents run in parallel and inherit the main agent's permissions, so they can do only what the main session is already allowed to do. Hooks are JSON-configured shell scripts that run before or after tool and model calls, which lets a team add its own checks, and workspace hooks override global ones.

• agy: launches the interactive terminal session inside the current working directory
• /plan: switches the session into plan mode to create an implementation plan
• /goal and /grill-me: both are on Google's published slash-command list in the I/O 2026 feature deep dive; try each one in a test project before building a workflow on it
• /browser: a listed slash command; separately, Google's docs say the Antigravity browser uses allow and deny lists and its own Chrome profile, which keeps agent browsing apart from your everyday Chrome logins
• /schedule: sets up scheduled tasks that run on a cron schedule
• /teamwork-preview: the Teamwork preview, available on all paid plans since August 27, 2026

Relationship to the Desktop Application and External Editors

The Antigravity CLI shares its agent harness and settings with the Antigravity 2.0 desktop application, so a setting changed in one applies in the other. Conversations initiated in the terminal open directly inside the 2.0 desktop interface.

Antigravity 2.0 is a completely separate desktop application without a built-in code editor. It succeeds the Agent Manager inside the Antigravity integrated development environment (IDE). Google says the Agent Manager will be removed from the IDE in an upcoming release.

Google has not deprecated the Antigravity IDE. When users update, they choose whether to keep the IDE, and Google recommends developers keep it. On August 20, 2026, Google released Antigravity extensions for VS Code, Visual Studio, Zed, JetBrains 2026.2.1+ and Xcode 27 beta 6+. They work on every plan, including free, so an editor user can reach Antigravity without moving to the 2.0 app. Mobile management operates through a browser-based Remote Control web interface, as Google publishes no native mobile application.

Migration Path from Gemini CLI

Google retired request processing for the legacy Gemini CLI and Gemini Code Assist IDE extensions on June 18, 2026 for Google AI Pro, Google AI Ultra, and free individual accounts. The official transition announcement directs terminal users to adopt agy.

Developers moving from Gemini CLI retain existing skills, hooks, and subagent architectures. GEMINI.md and AGENTS.md files still apply in the Antigravity CLI.

Google stated that the Antigravity CLI did not ship with full feature parity with Gemini CLI at launch. Developers should consult the Gemini CLI migration guide and run verification tests on local workflows before decommissioning existing scripts.

• Skill directories move from .gemini/skills to .agents/skills
• Model Context Protocol (MCP) server definitions move from legacy configs to mcp_config.json
• Existing Gemini CLI extensions convert to Antigravity plugins by running agy plugin import gemini
• Google says feature parity with Gemini CLI was not complete at launch, so test each imported extension before relying on it

Which Models the Antigravity CLI Can Use by Plan

Model availability inside the Antigravity CLI depends on the user's active Google subscription tier. Google does not publish an official default model for the terminal client.

Google began rolling out Gemini 4 Argon on October 13, 2026 for Google AI Ultra and eligible Gemini Enterprise accounts. It reaches the CLI and the desktop app but not the Antigravity IDE, per the Gemini 4 Argon announcement.

According to the official Antigravity models documentation, Google has scheduled the removal of Claude Sonnet 4.6, Claude Opus 4.6, and GPT-OSS-120B for November 2, 2026. Google's models documentation lists Nano Banana 2 as the model that handles images.

Pricing Plans and Quota Refresh Schedules

The Antigravity CLI operates under standard Google account plans. As of October 2026, the free Individual plan costs $0 and comes with basic weekly rate limits, unlimited Tab completions and unlimited Command requests.

Google AI Pro costs $20 per month. Usage quotas refresh on a rolling 5-hour clock until a secondary weekly limit is reached. Google AI Ultra starts at $100 per month with 5x Pro's token rate limit. The top Ultra tier was cut from $250 to $200 per month and carries 20x Pro.

Gemini Flash and Gemini Pro share a unified token allocation calculated against API consumption rates, while non-Gemini models draw from a separate fixed quota. Google eliminated base plan AI credit bundles in favor of an explicit AI Credit Overages setting toggled to Never or Always. Business access through Google Cloud starts at $30 per seat per month, or pay-as-you-go with a $0 seat fee plus consumption pricing. Enterprise access is included in eligible Gemini Enterprise Standard and Plus.

Google does not publish exact numeric token allowances, request quotas, credit-pack purchase costs, or student discounts. Account holders must review their current plan status directly on the Antigravity pricing page or read the Antigravity pricing guide.

Documented Failure Modes and Operational Safeguards

Five documented Antigravity incidents matter to CLI users: quota lockouts, HTTP 429 errors, a patched prompt-injection flaw, a drive wipe and account bans.

In January 2026, Google acknowledged a bug on community forums where 5-hour quota resets failed to clear, locking Pro users into multi-day lockout loops detailed on Google AI community discussions. Agent runs have also stopped with HTTP 429 RESOURCE_EXHAUSTED and the message Agent execution terminated due to error, as reported on discuss.ai.google.dev. The AI Credit Overages setting (Never or Always) decides whether usage past your plan limit is billed at Gemini Enterprise consumption pricing, so set it before a long run.

In April 2026, CyberScoop reported that Pillar Security found a prompt-injection flaw that led to code execution even in strict mode. Google fixed it on February 28, 2026. In December 2025, a Turbo-mode command wiped a user's drive, The Register reported. In February 2026, Google banned accounts that connected the third-party agent OpenClaw, according to VentureBeat.

Keep the terminal sandbox on, give each Antigravity project only the folders it needs (projects carry their own permissions), and do not connect third-party agents such as OpenClaw.

Target Audience Boundaries and Next Actions

The Antigravity CLI suits developers who want an agent in the terminal and do not need a code editor open beside it.

If you need full Gemini CLI feature parity on day one, run agy plugin import gemini and test each extension against the migration guide before relying on the Antigravity CLI. Users who require an interactive code editor rather than a terminal agent should also avoid relying solely on agy, turning instead to the Antigravity IDE or the official IDE extensions compared in Antigravity vs VS Code.

This advice would change if Google announces full feature parity with Gemini CLI or publishes numeric quotas for each plan.

To test terminal compatibility, run the installation script for your operating system, open a project repository in your terminal, execute agy, and complete the Google account authorization prompt.