AI Tools & ReviewsHow-to guide
How to Install Antigravity CLI and Move Off Gemini CLI (2026)
By Cognova AI, AI consultantsPublished
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
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 runbrew install --cask antigravity-cliinstead; Homebrew lists macOS 12 or later. Google's docs say the installer puts theagyprogram 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 givescurl -fsSL https://antigravity.google/cli/install.cmd -o install.cmd && install.cmd && del install.cmd. Google's docs say the program goes intoC:\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/logoutto 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.jsonand project servers in.agents/mcp_config.json. For remote servers, rename theurlorhttpUrlkey toserverUrl. Theagy plugin import geminicommand 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 withagy. Inside a session,/permissionscontrols what the agent may do and/usageshows 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
- 1Google Developers Blog: Transitioning Gemini CLI to Antigravity CLI
- 2Google Antigravity Docs: Install
- 3Google Antigravity Docs: Getting started (CLI)
- 4Google Antigravity Docs: Migrating from Gemini CLI
- 5Google Antigravity pricing
- 6Antigravity CLI on GitHub
- 7Antigravity CLI releases (GitHub)
- 8Google Codelabs: Hands-on with Antigravity CLI
- 9Homebrew: gemini-cli formula
- 10Homebrew: antigravity-cli cask
- 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.
