- fix(core,cli): preserve literal $ characters during template placeholder replacement
- feat(cli): add /stats heatmap subcommand for daily token usage
- fix(core): prevent GCLI_EXPAND_TARGET env collision in expandEnvVars
- chore(release): bump version to 0.69.0-nightly.20261104.g89e9d25d6
- fix(cli): serialize AnsiOutput to text content in ACP tool call updates
- Changelog for v0.67.0
Gemini CLI by Google
Google's open-source terminal agent that brings Gemini models to the command line for code editing, shell commands and MCP tools. Since 2026-06-18 it no longer serves free, Google AI Pro/Ultra or Google One users, who were moved to Antigravity CLI.
Use it in: CLI IDE Works with: MCP Own API key Multi-agent Headless / CI
On this page
Usage data: latest readings Nov 17 to Nov 19, 2026, last checked Nov 19, 06:30 UTC. Date of each number
What Gemini CLI does
Gemini CLI is a terminal agent from Google, first released in June 2025. You use it through a command-line tool and IDE extensions on macOS, Linux and Windows. Its documentation covers MCP servers, subagents or parallel agents, a non-interactive mode for scripts and CI and your own API key. Models: Google Gemini models (Gemini 3 per site) via a Gemini/Vertex AI API key or a Code Assist license. It is free and open source (Apache-2.0); you pay only for the models it calls.
Status: Still works with paid API keys and Code Assist Standard/Enterprise licenses, and the repo keeps releasing; since 2026-06-18 free Code Assist for individuals, Google AI Pro/Ultra and Google One users are moved to Antigravity CLI (announced 2026-05-19).
Teams use it for: Documentation, Workflow automation, Incident response, Building apps, Prototyping. See examples.
Recent developments
- 2026-06-18: Homebrew deprecated the gemini-cli formula (disable date 2026-12-18) in favour of the antigravity-cli cask
Key facts
| Maker | |
|---|---|
| Type | Terminal agent |
| First released | June 2025 |
| License | Apache-2.0 |
| Interfaces | CLI, IDE extension |
| Platforms | macOS, Linux, Windows |
| Models | Google Gemini models (Gemini 3 per site) via a Gemini/Vertex AI API key or a Code Assist license |
| Bring your own API key | Yes |
| Main language | TypeScript |
| Open issues and PRs | 737 |
| Open VSX downloads | 1,604,412 (includes updates) |
| Homebrew installs | 21,521 in 30 days · 733,020 in a year |
Pricing
What each Gemini CLI plan includes: usage limits →
As of 2026-06-18 the free Code Assist for individuals tier and Google AI Pro/Ultra access ended; Gemini CLI continues with paid Gemini/Vertex API keys (pay as you go) and Gemini Code Assist Standard/Enterprise licenses (1,500/2,000 requests per user per day per the quota docs). Antigravity CLI is free to everyone.
Source: official pricing page, checked Oct 30, 2026. Prices change often; confirm before you buy.
Quick answers
- Free to start?No
- Open source?Yes (Apache-2.0)
- Bring your own API key?Yes
- Runs onmacOS, Linux, Windows
- Where you use itCLI, IDE extension
- Supports MCP?Yes
- Model providersgoogle
- Subagents / multi-agent?Yes
- Runs in scripts / CI?Yes
- Feature comparisonAll agents
- Closest alternativeClaude Code · all alternatives
What's new in Gemini CLI: November 2026 so far
November brought stability improvements and new monitoring capabilities to Gemini CLI. The month focused on fixing edge cases in core functionality and adding tools for better visibility into agent performance.
- New /stats heatmap subcommand shows daily token usage patterns.
- IDE companion now bridges into container sandboxes for better integration.
- Extension validation command helps developers test custom extensions.
- Fixed duplicate agent loading and improved Windows compatibility.
3 releases this month · summarised from the official release notes · all months
How teams use Gemini CLI
Script Gemini CLI in your terminal: explain logs, write commits, document files
Gemini CLI's headless mode takes piped input and returns plain text or JSON. That makes it usable inside shell scripts, aliases and CI jobs.
Explanations of failures from piped logs, and commit messages generated from staged diffs. (as reported by Google)
Mod almost any PC game with Claude Code and the universal-modder plugin
An open-source GitHub project packages skills, a command-line tool, a shared knowledge base and the fal MCP server so AI coding agents such as Claude Code can mod PC games the use…
The repository ships three worked examples: a Terraria tModLoader weapon and boss pack with sprites made through fal, an Age of Empires II DE civiliz… (as reported by the project's author)
AgentGid articles about Gemini CLI
How to Start Using a Terminal Coding Agent: Setup, First Tasks and Guardrails
A practical manual for your first week with a command-line coding agent: installing one, running a first session, writing project instructions, setting permissions and keeping costs under control.
Best AI Agents in 2026: Live Rankings by Category
The leading AI agents for coding, design, research, data, marketing, sales, support, HR, finance, legal, DevOps and security, ranked by public usage data that refreshes daily, with prices and free options.
Best AI Coding Agents in 2026: Ranked by Usage, Benchmarks and Price
The AI coding agents developers use most, with live download and install numbers, benchmark results, entry prices and a way to choose between terminal, IDE and cloud agents.
Get started with Gemini CLI
Project instructions file for Gemini CLI: where it goes, format and a template →
| npm | npm install -g @google/gemini-cli |
|---|---|
| Homebrew | brew install gemini-cli |
| VS Code | code --install-extension Google.gemini-cli-vscode-ide-companion |
These commands use the packages tracked on this page. The vendor may recommend a different installer; see the official documentation.
Gemini CLI safety and permissions
| Out of the box | Asks before shell commands and file writes. |
|---|---|
| Sandbox | optional Off by default; enable with --sandbox (macOS Seatbelt, Docker/Podman, gVisor or LXC). |
| Approval modes | Approval modes default, autoEdit, plan and yolo; a policy engine with allow / ask_user / deny rules. |
| Hooks | BeforeTool hooks can block or rewrite a tool call. |
What Gemini CLI users report right now
Open Users report that since v0.63.0, YOLO mode keeps stopping for manual approval on ordinary shell commands because of a new "Untrusted Command Flags Detected" security warning. Later comments say it still happens in newer versions.
Reported on GitHub · 6 👍
Open Request Users on Gemini Code Assist Standard or Enterprise and on API keys ask for support for the new Gemini 4 Argon (Gemini 4 Pro) model in Gemini CLI, which they report is not yet available to them there.
Reported on GitHub · 6 👍
Fixed in v0.61.0 Users report that requesting a specific Flash model with --model (for example gemini-3.7-flash) was silently answered by gemini-3.5-flash with no error or warning, even for model names that do not exist.
Reported on GitHub · 14 👍
Closed Users report that newer Gemini Flash models (3.6 and 3.7) were missing from the /model picker for weeks after Google released them, so they could not select them in the CLI. A maintainer closed the issue saying v0.61.0 makes Gemini 3.8 Flash and 3.5 Flash Lite available.
Reported on GitHub · 16 👍
Does Gemini CLI's checkpointing save a restore point before shell commands change files, or only before file edits?
Checkpointing is off by default and is turned on with general.checkpointing.enabled in settings.json. The docs say a checkpoint (a snapshot in a shadow Git repository plus the conversation) is created when you approve a tool that modifies files, naming write_file and replace as examples; shell commands are not listed as a trigger. Saved checkpoints are listed and restored with /restore.
The most discussed problems in its GitHub repository, checked Nov 12, 2026. Written by AgentGid in its own words; statuses and fix versions come from the project's own pages. Reports are users' accounts, not AgentGid tests.
Run Gemini CLI inside GitHub
Run Gemini CLI: Invoke the Gemini CLI from a GitHub Action. Used in 5 public projects set up for AI coding agents (AgentGid scan).
uses: google-github-actions/run-gemini-cli@v0.1.22 · keys: gemini_api_key, google_api_key
Add the key in Settings → Secrets and variables → Actions, then add a workflow file with the line above. The model is paid through your own key; GitHub Actions minutes are free in public repositories.
Gemini CLI alternatives
Best Gemini CLI alternatives compared · All terminal coding agents
| # | Agent | Gid Score | Downloads 7d | 7d | 30d | Stars | Latest release | Price | |||
|---|---|---|---|---|---|---|---|---|---|---|---|
| 1 |
Claude CodeAnthropic |
88 | 18.9M | up 15.1% | up 15.5% | 156K+136/day | 2.1.328yesterday | $20/mo | |||
| 2 |
OpenAI CodexOpenAI |
84 | 26.6M | up 2.4% | up 7.4% | 136K+144/day | 0.168.07d ago | Free + $8/mo | |||
| 3 |
OpenCodeAnomaly (SST team) |
80 | 3.9M | up 15.4% | up 28.7% | 228K+266/day | 2.3.22d ago | Free + $10/mo | |||
| 7 |
PiEarendil Inc. (created by Mario Zechner) |
73 | 6.4M | up 1.6% | up 36.3% | 123K+193/day | 1.5.210d ago | Free (OSS) | |||
| 20 |
ClineCline Bot Inc. |
58 | 84.3K | down 8.7% | up 14.9% | 71.8K+38/day | 4.1.2625d ago | Free + $9.99/mo | |||
| 22 |
GitHub Copilot CLIGitHub (Microsoft) |
56 | 1.7M | down 8.3% | up 8.3% | 11.4K+6/day | 1.0.1142d ago | Free + $10/mo | |||
Head to head: Gemini CLI vs Claude Code · Gemini CLI vs Antigravity CLI · Gemini CLI vs OpenAI Codex · Gemini CLI vs OpenCode · Gemini CLI vs Pi
Tools in projects built with Gemini CLI
Most used libraries and frameworks in 473 public GitHub repos set up for Gemini CLI, from their dependency files.
- TypeScript61.5%
- ESLint44.2%
- Tailwind CSS38.1%
- Prettier31.9%
- Vitest30.9%
- React30.4%
- Zod29.0%
- Vite28.3%
- Playwright (JavaScript)22.6%
- Tailwind Merge21.6%
Used far more often here than in AI-built projects overall: what sets Gemini CLI projects apart.
- Pi Agent Core3.4% · 8.5×
- Pi Coding Agent3.2% · 8.0×
- pi-tui3.2% · 8.0×
- c83.6% · 7.2×
- tslog3.4% · 6.8×
- @lit/context3.4% · 6.8×
- Rolldown3.4% · 6.8×
- Lit Signals3.4% · 6.8×
Ratings from people who use Gemini CLI
No ratings yet. Used Gemini CLI? Rate it and say what it is good and bad at.
Gemini CLI news
-
Gemini CLI 0.69.0 released
fix(core,cli): preserve literal $ characters during template placeholder replacement; feat(cli): add /stats heatmap subcommand for daily token usage; fix(core): prevent GCLI_EXPAND_TARGET env collision in expandEnvVars
-
Gemini CLI 0.68.0 released
Changelog for v0.67.0-preview.0; Changelog for v0.66.0; docs(readme): clarify Gemini CLI scope, limitations, and tool landscape
What changed: recent Gemini CLI releases
- Changelog for v0.67.0-preview.0
- Changelog for v0.66.0
- docs(readme): clarify Gemini CLI scope, limitations, and tool landscape
- fix(cli): bound inline history re-render after terminal width changes
- fix(ui): handle surrogate pairs when truncating in sanitizeForDisplay
- fix(core): make isWithinRoot case-insensitive on Windows
Earlier releases
- Changelog for v0.65.0
- chore(release): bump version to 0.67.0-nightly.20261020.gb041de017
- Changelog for v0.66.0-preview.0
- feat(cli): bridge the IDE companion into container sandboxes over exec stdio
- fix(core): prevent duplicate agent loading when workspace is home directory
- fix(ide): exclude IDE settings and GEMINI.md files from open file con text
- Update ROADMAP.md to no longer reference outdated 2025 roadmap
- Changelog for v0.65.0-preview.0
- chore(release): bump version to 0.66.0-nightly.20261013.g204db94ae
- Changelog for v0.64.0
- fix(ui): implement synchronized output and isolate spinner rendering
- fix(ui): fix debug console height calculation and terminalBuffer flickering
- fix(cli): enforce read-only workspace settings in untrusted folders
- fix(core): avoid duplicate tool response turns when resuming sessions
- fix(core): prevent deletion of resumed session history on quick exit
- Changelog for v0.64.0-preview.0
- Changelog for v0.63.0
- fix(core): align OAuth callback iss parameter validation with RFC 9207 metadata
- refactor(a2a-server): implement V1 to V2 settings migration logic
- fix(acp): bridge PromptResponse.usage and emit usage_update notifications
- Changelog for v0.63.0-preview.0
- fix(cli): propagate resolved folder trust state in headless mode
- chore(release): bump version to 0.64.0-nightly.20260929.gd75234cae
- fix(cli): prevent CPU hang and quote swallowing on @ within code
Gemini CLI prices over time
Gemini CLI popularity and usage data
Gemini CLI was downloaded 495K times from npm in the week ending Nov 17, 2026, up 16.9% on the week before and up 6.8% over the last 30 days compared with the 30 before. Its VS Code extension has 1.2M installs and average 4.1 out of 5 across 21 marketplace ratings. The GitHub repository has 109K stars, 1,892 of them added in the last 30 days. The latest stable release is 0.69.0, published Nov 19, 2026; there were 4 stable releases in the past 30 days. On Terminal-Bench 2.1 its best listed result is 65.8% with Gemini 3 Pro, ranking 6 of 6 agents on that board. It was mentioned in 10 Hacker News posts and comments over the last 30 days.
Download the raw daily series: gemini-cli.csv
Gid Score breakdown
Gid Score shows public popularity and activity (usage, GitHub stars, mentions, growth), not the quality of the product. Each component is scored 0 to 100 from public signals; a dash means no data for it. How the Gid Score works.
How fresh these numbers are
| Number | Latest reading | Last checked |
|---|---|---|
| Package downloads | Nov 17, 2026 | Nov 19, 06:19 UTC |
| GitHub stars | Nov 19, 2026 | Nov 19, 06:26 UTC |
| VS Code installs | Nov 19, 2026 | Nov 19, 06:26 UTC |
| Open VSX downloads | Nov 19, 2026 | Nov 19, 06:26 UTC |
| Homebrew installs | Nov 19, 2026 | Nov 19, 06:26 UTC |
| Website rank (Tranco) | Nov 18, 2026 | Nov 19, 06:30 UTC |
| Hacker News mentions | Nov 18, 2026 | Nov 19, 06:26 UTC |
We fetch every source once a day. Registries publish downloads and page views a day or two late, so their latest reading trails the check. A reading more than 4 days old is marked out of date; the Gid Score still uses it until a newer one arrives.
Gemini CLI benchmark results
| Benchmark | Model | Effort | Tasks solved | Cost of run | Place |
|---|---|---|---|---|---|
| Terminal-Bench 2.1 | Gemini 3 Pro | high | 65.8% ± 2.7 | $248 | #6 of 6 |
| Gemini 3.1 Pro | high | 65.8% ± 3.3 | $236 | ||
| Terminal-Bench 2.0 | Gemini 3.1 Pro · v0.35.0 | — | 61.4% ± 4.1 | — | #27 of 43 |
| Gemini 3.1 Pro · v0.34.0 | — | 59.4% ± 4.2 | — | ||
| Gemini 3 Flash | — | 47.4% ± 3.0 | — | ||
| Gemini 2.5 Pro · v0.11.3 | — | 19.6% ± 2.9 | — |
Up to four best runs per board. Scores are not comparable between Terminal-Bench versions. Source: Terminal-Bench (tbench.ai).
Gemini CLI FAQ
How much does Gemini CLI cost?
As of 2026-06-18 the free Code Assist for individuals tier and Google AI Pro/Ultra access ended; Gemini CLI continues with paid Gemini/Vertex API keys (pay as you go) and Gemini Code Assist Standard/Enterprise licenses (1,500/2,000 requests per user per day per the quota docs). Antigravity CLI is free to everyone.
Is Gemini CLI open source?
Yes. Gemini CLI is open source, released under the Apache-2.0 license.
How popular is Gemini CLI?
Gemini CLI was downloaded 495K times from npm in the week ending Nov 17, 2026, up 16.9% on the week before and up 6.8% over the last 30 days compared with the 30 before. Its VS Code extension has 1.2M installs and average 4.1 out of 5 across 21 marketplace ratings. The GitHub repository has 109K stars, 1,892 of them added in the last 30 days.
What is the latest version of Gemini CLI?
The latest stable release we track is 0.69.0, published on Nov 19, 2026.
What are the alternatives to Gemini CLI?
The closest alternatives in the same category by Gid Score are Claude Code, OpenAI Codex, OpenCode, Pi.
For the makers of Gemini CLI badges, corrections
Add a live badge to your README or site:
[](https://agentgid.com/agents/gemini-cli/)
[](https://agentgid.com/agents/gemini-cli/)
[](https://agentgid.com/agents/gemini-cli/)
Something wrong or outdated on this page? Send a correction with a link to the official source. More for makers.
Where these numbers come from
npm: @google/gemini-cli. GitHub: google-gemini/gemini-cli. VS Code Marketplace: Google.gemini-cli-vscode-ide-companion. Homebrew: gemini-cli. Site rank: geminicli.com on the Tranco list. See data sources for how each one is collected.
Product facts and pricing were checked against: developers.googleblog.com, geminicli.com, github.com, registry.npmjs.org, formulae.brew.sh, marketplace.visualstudio.com, open-vsx.org.