# How to Install Antigravity CLI and Move Off Gemini CLI (2026)

> Google is replacing Gemini CLI with Antigravity CLI. Install it with curl -fsSL https://antigravity.google/cli/install.sh | bash on macOS or Linux, irm https://antigravity.google/cli/install.ps1 | iex in Windows PowerShell, or brew install --cask antigravity-cli. The command is agy. Run it in a project folder, sign in with your Google account, and run agy plugin import gemini to convert Gemini CLI extensions. Gemini CLI stopped serving Google AI Pro and Ultra users, and free Gemini Code Assist users, on June 18, 2026.

Format: howto · Published: 2026-11-20
URL: https://cognovaai.com/insights/how-to-install-antigravity-cli

Antigravity CLI is Google's terminal coding agent and the successor to Gemini CLI. Google announced the switch on May 19, 2026. "Antigravity cli" is now searched about 4,400 times a month in the US, according to Semrush, while "install gemini cli" still gets about 2,900 searches from people following outdated guides.

This guide covers a fresh install and the move from Gemini CLI. It follows Google's Antigravity docs, Google's developer blog and the Antigravity CLI GitHub releases as published on November 20, 2026. It is for business owners whose developers used Gemini CLI and for the developers themselves. We did not install Antigravity CLI on our test PC, so the commands come straight from Google's documentation.

## What you need

- A Google account (personal, Google AI Pro or Ultra) or a Google Cloud project for business use
- macOS, Linux, or Windows with PowerShell or Command Prompt
- A project folder you are happy to let the agent read and change
- Your existing Gemini CLI setup, if you are migrating

**Time needed:** 10–20 minutes, plus migration time if you used Gemini CLI

## Step 1: Check whether Gemini CLI still works for you

Google's developer blog says that from June 18, 2026, Gemini CLI stopped serving requests for Google AI Pro and Ultra subscribers and for the free Gemini Code Assist for individuals. Gemini Code Assist Standard and Enterprise customers are unaffected, and Gemini CLI stays available with paid API keys. Homebrew has marked the gemini-cli formula deprecated, with a disable date of December 18, 2026.

## Step 2: Install on macOS or Linux

Open a terminal and run `curl -fsSL https://antigravity.google/cli/install.sh | bash`. On a Mac with Homebrew you can run `brew install --cask antigravity-cli` instead; Homebrew lists macOS 12 or later. Google's docs say the installer puts the `agy` program in `~/.local/bin/agy`, and that you may need to add that folder to your PATH if the installer says so.

## Step 3: Install on Windows

Open PowerShell and run `irm https://antigravity.google/cli/install.ps1 | iex`. In Command Prompt, the README gives `curl -fsSL https://antigravity.google/cli/install.cmd -o install.cmd && install.cmd && del install.cmd`. Google's docs say the program goes into `C:\Users\<username>\AppData\Local\agy\bin`. Close and reopen the terminal afterwards so the new PATH takes effect.

## Step 4: Check the install

Run `agy --version`. On November 20, 2026, the latest release on Google's GitHub releases page and in Homebrew was 1.5.13. Some older Google codelabs still show version 1.1.27, so ignore that number. If the command is not found, Google's codelab says the installer may not have updated your PATH and will print instructions for adding it.

## Step 5: Sign in and trust your project folder

Create or open a project folder and run `agy`. On first launch it shows a sign-in menu: choose **Google OAuth** for a personal account, which opens a browser and asks you to paste a code back, or **Use a Google Cloud project** for business or pay-as-you-go use. You then pick a colour theme, accept the terms, choose a display mode and confirm you trust the folder. Use `/logout` to sign out.

## Step 6: Migrate from Gemini CLI

Google's migration guide says Antigravity CLI detects your Gemini CLI setup on first launch and offers to convert it. To convert Gemini CLI extensions into plugins, run `agy plugin import gemini`. Your GEMINI.md and AGENTS.md files keep working without changes. Move any project skills from `.gemini/skills/` to `.agents/skills/` by hand.

## Step 7: Move your MCP servers

MCP servers no longer live inside `~/.gemini/settings.json`. Google's migration guide puts global servers in `~/.gemini/config/mcp_config.json` and project servers in `.agents/mcp_config.json`. For remote servers, rename the `url` or `httpUrl` key to `serverUrl`. The `agy plugin import gemini` command reports how many server definitions it migrated, so check that output and test each server.

## Step 8: Run a first task and check your quota

Run a quick test with `agy -p "summarize what this project does"`, which runs one prompt and exits, or start an interactive session with `agy`. Inside a session, `/permissions` controls what the agent may do and `/usage` shows how much quota you have used. Google's pricing page lists a free individual tier with a baseline quota refreshed weekly, and higher quotas on Google AI Pro and Ultra.

## Using an API key instead of a Google sign-in

Google's install docs say an environment variable alone is not enough. You must also set the model provider in `~/.gemini/antigravity-cli/settings.json`:

```json
{
  "modelProvider": "gemini"
}
```

Then set `GEMINI_API_KEY` in your shell, for example `export GEMINI_API_KEY="your-api-key"` on macOS or Linux. The docs say `.env` files and `GOOGLE_API_KEY` are not read. Google does not show the PowerShell form, so on Windows set it as a user environment variable.

## Keeping it updated

If you installed with Homebrew, update with `brew upgrade --cask antigravity-cli`. The Homebrew page says Antigravity's own automatic updates are turned off for Homebrew installs. For script installs, the 1.5.13 release notes mention an `agy update` command, but we did not find it documented on Google's usage pages, so check the release notes before relying on it.

## Model changes to watch

Google's pricing page says several third-party models available in Antigravity, including Claude Sonnet 4.6, Claude Opus 4.6 and GPT-OSS-120b, will be removed on November 30, 2026. Run `agy models` to see what your account can use today.

## What we did and did not test

We did not install Antigravity CLI on our test PC, because it would add a program to the PATH and require a Google sign-in. Every command comes from Google's Antigravity docs, codelab, GitHub README and release notes, and from Homebrew, as published on November 20, 2026.

## How Cognova AI can help

We help small teams choose and roll out AI coding and automation tools, including moving off retired ones, with sensible permissions and training. See [AI Consulting](/services/ai-consulting-dallas), or compare with our guides to [installing Codex CLI](/insights/how-to-install-codex-cli) and [installing Claude Code](/insights/how-to-install-claude-code).

## Frequently asked questions

### Is Gemini CLI being discontinued?

For most individual users, yes. Google's developer blog announced on May 19, 2026 that Antigravity CLI replaces Gemini CLI, and that from June 18, 2026 Gemini CLI stopped serving Google AI Pro, Ultra and free individual users. Gemini Code Assist Standard and Enterprise customers are unaffected, and Gemini CLI still works with paid API keys. Homebrew will disable its gemini-cli formula on December 18, 2026.

### Is Antigravity CLI free?

There is a free tier. Google's Antigravity pricing page lists an individual plan at $0 a month with a baseline agent quota refreshed weekly. Google AI Pro and Ultra subscribers get higher quotas refreshed every five hours, and businesses can buy access through Google Cloud, starting at $30 per seat per month for Standard and Plus, or pay as they go. Workspace accounts are excluded from the Pro and Ultra plans.

### Do my Gemini CLI settings carry over to Antigravity CLI?

Most of them, with some manual steps. Antigravity CLI reads your GEMINI.md and AGENTS.md files as they are, offers to convert your setup on first launch, and converts extensions to plugins with agy plugin import gemini. You need to move project skills to .agents/skills, and MCP servers move to new mcp_config.json files with url renamed to serverUrl. Test each server after migrating.

## Sources

- [Google Developers Blog: Transitioning Gemini CLI to Antigravity CLI](https://developers.googleblog.com/an-important-update-transitioning-gemini-cli-to-antigravity-cli/)
- [Google Antigravity Docs: Install](https://antigravity.google/docs/install/)
- [Google Antigravity Docs: Getting started (CLI)](https://antigravity.google/docs/getting-started?tab=cli)
- [Google Antigravity Docs: Migrating from Gemini CLI](https://antigravity.google/docs/cli/gcli-migration)
- [Google Antigravity pricing](https://antigravity.google/pricing)
- [Antigravity CLI on GitHub](https://github.com/google-antigravity/antigravity-cli)
- [Antigravity CLI releases (GitHub)](https://github.com/google-antigravity/antigravity-cli/releases)
- [Google Codelabs: Hands-on with Antigravity CLI](https://codelabs.developers.google.com/antigravity-cli-hands-on)
- [Homebrew: gemini-cli formula](https://formulae.brew.sh/formula/gemini-cli)
- [Homebrew: antigravity-cli cask](https://formulae.brew.sh/cask/antigravity-cli)
- [Semrush Keyword Overview: antigravity cli (US database, November 2026)](https://www.semrush.com/analytics/keywordoverview/?q=antigravity+cli&db=us)
