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.”
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
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
Install Gemini CLI
Run
npm install -g @google/gemini-cli. This puts thegeminicommand on your computer. - 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
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
Save it for next time
Put the line
GEMINI_API_KEY=YOUR_KEYin~/.gemini/.env(on Windows,%USERPROFILE%\.gemini\.env). Gemini CLI looks there on every start. - 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-cliGemini 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_PROJECTto your company's project ID, rungeminiand choose Sign in with Google. - Vertex AI: set
GOOGLE_CLOUD_PROJECTandGOOGLE_CLOUD_LOCATION(for exampleus-central1), then either rungcloud auth application-default loginor setGOOGLE_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 this | What happens |
|---|---|
/help | Lists every command |
/init | Writes a GEMINI.md file describing your project |
/memory | Shows or reloads the instructions Gemini has read |
/model | Changes the model |
/plan | Plans the work before touching any files |
/chat and /resume | Saves, lists and reopens conversations |
/restore | Rolls files back to a checkpoint taken before an edit (only if checkpointing is switched on in your settings) |
/compress | Shrinks a long chat to save room |
/stats | Shows tokens used this session |
/tools and /mcp | Lists built-in tools and connected MCP servers |
/settings | Opens the settings screen |
@src/app.ts explain this | Sends that file along with your question |
!npm test | Runs the command and shows the output; ! on its own switches shell mode on or off |
/quit | Leaves 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 CLI | Antigravity CLI | |
|---|---|---|
| Command | gemini | agy |
| Licence | Open source (Apache 2.0) | No open-source licence listed in Google's docs |
| Built with | Node.js (needs version 20+) | Go, installed with a one-line script |
| Who it serves (Nov 2026) | Code Assist Standard/Enterprise and paid API keys | Everyone, including free and Google AI Pro/Ultra |
| Gemini 4 models | Not tuned for them | Recommended by Google |
| Teams of agents | Subagents | Subagents in the background plus /swarm |
| Add-ons | Extensions | Plugins (import old extensions with agy plugin import gemini) |
| Project rules | GEMINI.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:
- Install Antigravity CLI with the line for your system (below).
- Open a new terminal and run
agy --versionto check it installed. - Run
agyin your project. On first launch it offers to bring over your Gemini CLI settings. - Leave your
GEMINI.mdandAGENTS.mdfiles where they are; Antigravity CLI reads them as they are. - Convert your extensions with
agy plugin import gemini. - Move project skills from
.gemini/skills/to.agents/skills/, and MCP servers intomcp_config.json, where remote addresses use theserverUrlfield.
# macOS and Linux
curl -fsSL https://antigravity.google/cli/install.sh | bash
# Windows PowerShell
irm https://antigravity.google/cli/install.ps1 | iexGoogle 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 startedKeep reading
Windows setup
Gemini CLI on Windows after the 2026 change: what to install and how
Product tour
A tour of Google Antigravity: the app, CLI, IDE, extensions and SDK
Three-way comparison
Claude Code vs Codex vs Gemini: the three CLI coding agents compared
Buyer's guide
The best AI coding agents in 2026, sorted by how you work
Command reference
Codex CLI command reference: from install to codex exec