Skip to content
Cognova AI

AI Tools & ReviewsHow-to guide

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

By , AI consultantsPublished

In short

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.

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

  1. 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.

  2. 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.

  3. 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.

  4. 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.

  5. 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.

  6. 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.

  7. 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.

  8. 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:

{
  "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, or compare with our guides to installing Codex CLI and installing 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

  1. 1Google Developers Blog: Transitioning Gemini CLI to Antigravity CLI
  2. 2Google Antigravity Docs: Install
  3. 3Google Antigravity Docs: Getting started (CLI)
  4. 4Google Antigravity Docs: Migrating from Gemini CLI
  5. 5Google Antigravity pricing
  6. 6Antigravity CLI on GitHub
  7. 7Antigravity CLI releases (GitHub)
  8. 8Google Codelabs: Hands-on with Antigravity CLI
  9. 9Homebrew: gemini-cli formula
  10. 10Homebrew: antigravity-cli cask
  11. 11Semrush Keyword Overview: antigravity cli (US database, November 2026)

Cite this article

Cognova AI. (2026, November 20). How to Install Antigravity CLI and Move Off Gemini CLI (2026). Cognova AI. https://cognovaai.com/insights/how-to-install-antigravity-cli

Permanent link: cognovaai.com/insights/how-to-install-antigravity-cli. Quoting a passage? Select it and use “Copy quote” to get a link that jumps to that exact text.

Up nextHow to Install Codex CLI on Windows, Mac and Linux (2026)On macOS or Linux, install Codex CLI with curl -fsSL https://chatgpt.com/codex/install.sh | sh. On Windows, run OpenAI's PowerShell installer or use WSL2. On any system with Node.js, npm install -g @openai/codex also works. Then open your project folder, run codex and choose Sign in with ChatGPT. OpenAI says Codex is included in every ChatGPT plan from Free to Enterprise. The latest stable release on November 20, 2026 was 0.171.0.Continue reading

See where AI fits in your business

A 30-minute call with a consultant, not a sales rep. You leave with at least one concrete next step, whether or not we work together.