Status report

Gemini CLI status report: free limits, API keys and the move to Antigravity CLI

Updated November 17, 20268 min read

Gemini CLI still works in November 2026, but only for some people. Since June 18, 2026, Google serves it to companies with Gemini Code Assist Standard or Enterprise licences and to people with paid API keys, while free users and Google AI Pro and Ultra subscribers were moved to Antigravity CLI. Below: where things stand, who should keep using it, how to set it up with an API key, and how to switch if you were moved.

Where Gemini CLI stands in November 2026

Gemini CLI is alive, but no longer for everyone

On May 19, 2026 Google announced that Gemini CLI would hand its individual users over to Antigravity CLI. On June 18, 2026 it stopped serving requests from free accounts and from Google AI Pro and Ultra subscribers. Enterprise Code Assist customers and paid API key users carry on as before. If you are an individual with no paid key, Antigravity CLI is now your tool.

Gemini CLI is Google's open-source coding agent for the terminal. You start it with the gemini command, and it reads your project, edits files, runs shell commands and connects to outside tools. The code stays public under the Apache 2.0 licence on GitHub, and new stable versions still ship every week.

Google explained the change in its transition post. Its reasoning was that developers now want several agents working together on one job:

“...we can serve you best by pouring our energy into a single product built for today's multi-agent reality.”
Google Developers Blog, May 19, 2026

One more thing to know before you settle on Gemini CLI: its README says it is not tuned for the Gemini 4 model series. Google points people who want Gemini 4 Argon and later models to Antigravity CLI instead.

Is Gemini CLI free? The old limits and what replaced them

Gemini CLI launched in 2025 with a large free allowance. Before June 18, 2026, Google listed 1,000 requests per user per day if you signed in with a personal Google account, and 250 per day (Flash model only) with an unpaid API key. Older guides still quote those numbers. They no longer apply: the free sign-in route stopped serving requests in June.

So the honest answer to "is Gemini CLI free?" is: the program is free to download, but using it now needs either a company Code Assist licence or a paid Gemini API key, where you pay for what you use. Google's post confirms paid Gemini and Gemini Enterprise Agent Platform keys keep working. It does not say anything about free API keys, so don't count on one.

The free option today sits in Antigravity. Its Individual plan is $0 and includes unlimited Tab completions and Command requests, with basic weekly rate limits on agent work (as of November 2026). Google doesn't print the exact weekly numbers on its pricing page, so check /usage inside Antigravity CLI to see your own allowance.

Who can still use Gemini CLI

Keep Gemini CLI

your company pays for Gemini Code Assist Standard or Enterprise. Your access did not change.

Nothing changes for GitHub reviews

your organisation uses Gemini Code Assist for GitHub through Google Cloud. Google says that access is unchanged. The free consumer version of that GitHub app stopped taking new installs on June 18, 2026.

Keep Gemini CLI

you have a paid Gemini API key or a Gemini Enterprise Agent Platform key and are happy to pay per use.

Move to Antigravity CLI

you signed in with a free personal Google account. Those requests stopped on June 18, 2026.

Move to Antigravity CLI

you pay for Google AI Pro or Ultra through Google One. Your plan's agent allowance now lives in Antigravity.

Move to Antigravity CLI

you want Gemini 4 models or built-in multi-agent features such as /swarm.

If you work on Windows, the install steps differ a little (PowerShell, execution policy, setting keys with $env:). Our Gemini CLI on Windows page covers those details.

Gemini CLI install and API key setup

Google's install docs ask for Node.js 20 or newer and recommend macOS 15+, Windows 11 24H2+ or Ubuntu 20.04+. These steps use a paid Gemini API key, the most common route for individuals who still use Gemini CLI.

  1. 1

    Check Node.js

    Run node --version. If it prints v20 or higher, you're set. If not, install the LTS version from nodejs.org first.

  2. 2

    Install Gemini CLI

    Run npm install -g @google/gemini-cli. This puts the gemini command on your computer.

  3. 3

    Get an API key

    Open Google AI Studio at aistudio.google.com/app/apikey and create a key. Make sure the project behind it has paid billing, since free access to Gemini CLI has ended.

  4. 4

    Give the key to Gemini CLI

    On Mac or Linux run export GEMINI_API_KEY="YOUR_KEY". In Windows PowerShell run $env:GEMINI_API_KEY="YOUR_KEY". Both only last for that terminal window.

  5. 5

    Save it for next time

    Put the line GEMINI_API_KEY=YOUR_KEY in ~/.gemini/.env (on Windows, %USERPROFILE%\.gemini\.env). Gemini CLI looks there on every start.

  6. 6

    Start and choose the key

    Go to your project folder, run gemini, and pick Use Gemini API key when it asks how to sign in.

Watch out

Treat the key like a password. Never paste it into a file you commit to Git, and remember that any program started from a terminal where the key is set can read it.

Other ways to install Gemini CLI

# Try it once without installing
npx @google/gemini-cli

# Homebrew (macOS and Linux)
brew install gemini-cli

# MacPorts
sudo port install gemini-cli

Gemini CLI has three release channels. Stable (@latest) ships every Tuesday and promotes the previous week's preview. Preview (@preview) also ships weekly and may contain bugs. Nightly (@nightly) builds every day from the newest code.

Signing in with a company licence or Vertex AI

  • Code Assist licence: set GOOGLE_CLOUD_PROJECT to your company's project ID, run gemini and choose Sign in with Google.
  • Vertex AI: set GOOGLE_CLOUD_PROJECT and GOOGLE_CLOUD_LOCATION (for example us-central1), then either run gcloud auth application-default login or set GOOGLE_API_KEY, and choose Vertex AI at start-up.

Gemini CLI commands for everyday work

Once gemini is running you type requests in plain English. Three symbols do special jobs: / runs a built-in command, @ adds a file or folder to your request, and ! runs a shell command.

Type thisWhat happens
/helpLists every command
/initWrites a GEMINI.md file describing your project
/memoryShows or reloads the instructions Gemini has read
/modelChanges the model
/planPlans the work before touching any files
/chat and /resumeSaves, lists and reopens conversations
/restoreRolls files back to a checkpoint taken before an edit (only if checkpointing is switched on in your settings)
/compressShrinks a long chat to save room
/statsShows tokens used this session
/tools and /mcpLists built-in tools and connected MCP servers
/settingsOpens the settings screen
@src/app.ts explain thisSends that file along with your question
!npm testRuns the command and shows the output; ! on its own switches shell mode on or off
/quitLeaves Gemini CLI

To use Gemini CLI from a script, pass the prompt with -p: for example gemini -p "summarise this repo" prints an answer and exits.

GEMINI.md: rules Gemini reads every time

GEMINI.md is a text file in your project with your build commands, test commands and house rules. Gemini reads it at the start of each session. Rules you want in every project go in ~/.gemini/GEMINI.md. Gemini CLI can also read AGENTS.md, the shared format that Codex and others use. Add it to the context.fileName list in your settings.json file, and you don't have to keep two copies.

Gemini CLI vs Antigravity CLI

Gemini CLIAntigravity CLI
Commandgeminiagy
LicenceOpen source (Apache 2.0)No open-source licence listed in Google's docs
Built withNode.js (needs version 20+)Go, installed with a one-line script
Who it serves (Nov 2026)Code Assist Standard/Enterprise and paid API keysEveryone, including free and Google AI Pro/Ultra
Gemini 4 modelsNot tuned for themRecommended by Google
Teams of agentsSubagentsSubagents in the background plus /swarm
Add-onsExtensionsPlugins (import old extensions with agy plugin import gemini)
Project rulesGEMINI.md (plus AGENTS.md if you add it in settings)Reads GEMINI.md and AGENTS.md with no setup

In daily use the two feel alike: both read your project, edit files and run commands in the terminal. Antigravity CLI shares its agent engine with the Antigravity desktop app and adds team features such as /swarm, /goal and /schedule. Our Google Antigravity guide tours the whole Antigravity family.

Moving from Gemini CLI to Antigravity CLI

If your requests stopped working in June, the switch takes a few minutes. The steps follow Google's migration guide:

  1. Install Antigravity CLI with the line for your system (below).
  2. Open a new terminal and run agy --version to check it installed.
  3. Run agy in your project. On first launch it offers to bring over your Gemini CLI settings.
  4. Leave your GEMINI.md and AGENTS.md files where they are; Antigravity CLI reads them as they are.
  5. Convert your extensions with agy plugin import gemini.
  6. Move project skills from .gemini/skills/ to .agents/skills/, and MCP servers into mcp_config.json, where remote addresses use the serverUrl field.
# macOS and Linux
curl -fsSL https://antigravity.google/cli/install.sh | bash

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

Google says not every feature matched on day one, and custom terminal themes may not come across. For scripts, agy -p "your prompt" does the same job as gemini -p.

You may end up using Antigravity for some jobs and Claude Code or Codex for others. VibeCodingDeck is a Windows and Apple silicon Mac app that shows Gemini CLI, Antigravity and your other installed agents together in one grid, and lets you pass a stuck job from one to another. For a side-by-side of the big three, see Claude Code vs Codex vs Gemini or our Codex CLI reference.

Gemini CLI questions people keep asking

Is Gemini CLI free?

+

Not any more for individuals. Free sign-ins stopped on June 18, 2026. You now need a paid API key or a company Code Assist licence. The free route is Antigravity's $0 Individual plan, which has weekly rate limits.

What were the Gemini CLI free limits?

+

Before June 18, 2026, Google listed 1,000 requests per user per day with a free Google sign-in and 250 per day with an unpaid API key. Neither route serves requests in Gemini CLI now.

How do I install Gemini CLI?

+

Install Node.js 20 or newer, run npm install -g @google/gemini-cli, then type gemini in your project folder. Mac users can also run brew install gemini-cli.

How do I use a Gemini API key with Gemini CLI?

+

Create a key in Google AI Studio, set it as GEMINI_API_KEY (or save it in ~/.gemini/.env), run gemini and choose Use Gemini API key.

What is the difference between Gemini CLI and Antigravity CLI?

+

Gemini CLI (gemini) is open source and now serves enterprise licences and paid keys. Antigravity CLI (agy) is Google's newer terminal agent for everyone else, with team features like /swarm.

Will my GEMINI.md work in Antigravity CLI?

+

Yes. Antigravity CLI reads GEMINI.md and AGENTS.md without changes, so your project rules carry over.

Sources

Run up to 12 AI coding agents in one window.

Claude Code, Codex, Gemini, Grok and more, side by side. Windows and Mac. From $29 a month.

Get started

Keep reading