Practical guides

Moving from Gemini CLI to Antigravity CLI: installation and migration

Since June 18, 2026, Gemini CLI no longer serves free, Google AI Pro and AI Ultra accounts. Who is affected, how to install Antigravity CLI and migrate skills, extensions and MCP servers.

By Audryk · October 20, 2026

• Practical guides
• Coding agents
• #guides
• #Google
• #MCP

On May 19, 2026, Google announced that Antigravity CLI would replace Gemini CLI for individual accounts (Google Developers Blog). The switch happened on June 18, 2026. This guide sums up who is affected, then covers installation and migration according to Antigravity's official documentation, verified on 2026-10-20.

Who is affected?

• Affected: since June 18, 2026, Gemini CLI and the Gemini Code Assist IDE extensions no longer serve Google AI Pro and AI Ultra subscribers, nor free users of Gemini Code Assist for individuals. The "Login with Google" option no longer gives access to Gemini CLI (Google).
• Not affected: organisations with a Gemini Code Assist Standard or Enterprise license, or using Gemini Code Assist for GitHub through Google Cloud. Gemini CLI also remains accessible with paid Gemini or Gemini Enterprise Agent Platform API keys (Google Developers Blog). Google's deprecation page adds that Standard and Enterprise subscriptions follow a separate schedule (Google).

According to Google, Antigravity CLI does not offer full feature parity out of the gate, but keeps the features it considers critical: Agent Skills, Hooks, Subagents and Extensions, now called plugins. Built in Go, it shares the same agent harness as the Antigravity 2.0 desktop app.

Install Antigravity CLI

The command is called agy (Antigravity).

macOS, Linux and Googlebook (binary installed at ~/.local/bin/agy):

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

Windows PowerShell (binary in C:\Users\<username>\AppData\Local\agy\bin):

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

Windows CMD:

curl -fsSL https://antigravity.google/cli/install.cmd -o install.cmd && install.cmd && del install.cmd

Check the installation in a new terminal:

agy --version

On first launch, the setup asks for a color scheme and a rendering mode (full-screen buffer or inline in your terminal history).

Sign in

On launch, agy looks for a session in the operating system's secure keyring (Apple Keychain, Linux Secret Service, Windows Credential Manager). If none is found, it opens your browser: sign in with a personal Google Account (Free, Pro or Ultra plan) or choose "Business account" for a Gemini Enterprise account (Antigravity). Over SSH, the CLI gives you a URL to open manually.

Migrate your Gemini CLI setup

On first launch, if agy detects a Gemini CLI configuration, an interactive checklist offers to convert extensions and global settings and to move session tokens into the system keyring (Antigravity).

Manually, to convert Gemini extensions into Antigravity plugins:

agy plugin import gemini

The command scans the legacy local directories and converts skills, commands (turned into skills) and MCP server definitions.

What stays the same: the project's GEMINI.md and AGENTS.md context files, as well as the global ~/.gemini/GEMINI.md, are read as they are.

What changes:

• Global skills: from ~/.gemini/skills/ to ~/.gemini/antigravity-cli/skills/.
• Project skills: from .gemini/skills/ to .agents/skills/. You must move this folder manually for the agent to recognise them.
• MCP servers: no longer declared in ~/.gemini/settings.json but in dedicated files, ~/.gemini/config/mcp_config.json (global) and .agents/mcp_config.json (project).
• Remote MCP servers: when migrating manually, the url or httpUrl key becomes serverUrl.

Official mcp_config.json example:

{
  "mcpServers": {
    "remote-indexer": {
      "serverUrl": "https://mcp.internal.enterprise.com/sse",
      "env": {
        "AUTH_TOKEN": "secure_alpha_token"
      }
    }
  }
}

Some custom terminal themes or experimental visual overlays from Gemini CLI may not carry over. For MCP principles shared with other agents, see our guide How to set up an MCP server.

Quotas and plans

Antigravity is available to individual accounts under terms derived from Google's Terms of Service (Antigravity). All plans include Gemini models, including Gemini 3.8 Flash, as the core agent model, and access to the CLI. Limits vary:

• Without Google AI Pro or Ultra: a weekly quota and a weekly rate limit;
• Google AI Pro: a quota refreshed every five hours, up to a higher weekly limit;
• Google AI Ultra: the highest quota, refreshed every five hours, and access to third-party models.

Pro and Ultra subscribers can buy AI credits for usage beyond their quota. Google does not support bring-your-own-key (BYOK) for extra rate limits. In the CLI, /usage shows quota usage per model and /credits the credit balance (command reference).

Useful commands

• /model picks the model (the choice persists across sessions);
• /mcp opens the MCP server manager; /plugin the plugins manager;
• /resume loads a previous conversation; /rewind rolls back to an earlier message;
• /permissions manages tool permissions; /exit quits.

Going further

• Google's flagship model: the Gemini 4 Argon tool page, available in Antigravity CLI according to Google, but not in the Antigravity IDE.
• Other free or low-cost options: Choosing a coding agent by budget.
• Gemini CLI among the most-followed agents: open-source coding agents on GitHub.

Sources

• Google Developers Blog: An important update: Transitioning Gemini CLI to Antigravity CLI (May 19, 2026), verified 2026-10-20
• Google: Gemini Code Assist consumer accounts, verified 2026-10-20
• Antigravity Docs: Getting started, verified 2026-10-20
• Antigravity Docs: Authenticate, verified 2026-10-20
• Antigravity Docs: Migration (Gemini CLI), verified 2026-10-20
• Antigravity Docs: Plans, verified 2026-10-20
• Antigravity Docs: CLI commands, verified 2026-10-20

Key takeaway: individual Google accounts must move to Antigravity CLI (agy), which imports extensions and MCP servers; only project skills need to be moved by hand to .agents/skills/.

Spotted an error in this article? Report it · Our corrections policy