Skip to content
Agents tracked: 492 Releases (7d): 545 Agent status: 1 with issuesSince last limit reset: Claude 9d · Codex 7d For AI agents: Markdown Updated Nov 20, 2026

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.

Terminal coding agents Terminal agentOpen source · Apache-2.0

Use it in: CLI IDE Works with: MCP Own API key Multi-agent Headless / CI

Price
API usage or license
no free tier listed
Popularity
#5 in Terminal
Gid Score 62 / 100 · #15 of 251 ranked AI agents
Trend
Growing
downloads up 6.8% over 30 days · up 16.9% last week
Development
Actively updated
latest 0.69.0, yesterday
Community
109K GitHub stars
VS Code rating 4.1 / 5

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

MakerGoogle
TypeTerminal agent
First releasedJune 2025
LicenseApache-2.0
InterfacesCLI, IDE extension
PlatformsmacOS, Linux, Windows
ModelsGoogle Gemini models (Gemini 3 per site) via a Gemini/Vertex AI API key or a Code Assist license
Bring your own API keyYes
Main languageTypeScript
Open issues and PRs737
Open VSX downloads1,604,412 (includes updates)
Homebrew installs21,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.

Compare prices of all agents

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

Full monthly summary

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

All Gemini CLI use cases · All use cases

AgentGid articles about Gemini CLI

All guides

Get started with Gemini CLI

npmnpm install -g @google/gemini-cli
Homebrewbrew install gemini-cli
VS Codecode --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

Compare agents

Out of the boxAsks before shell commands and file writes.
Sandboxoptional Off by default; enable with --sandbox (macOS Seatbelt, Docker/Podman, gVisor or LXC).
Approval modesApproval modes default, autoEdit, plan and yolo; a policy engine with allow / ask_user / deny rules.
HooksBeforeTool hooks can block or rewrite a tool call.

From the official docs · 1 · 2 · 3, checked Oct 9, 2026.

What Gemini CLI users report right now

All 5 reports, questions and fixes →

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.

Source · Source · Where it was asked

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

All ways to use AI agents in 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 supports Agent Skills. Add ready-made skills for code review, slides, design, marketing and more: browse the Agent Skills catalog, with install commands for Gemini CLI.

Compare Gemini CLI with another agent

vs
# 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 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

All tools

Most used libraries and frameworks in 473 public GitHub repos set up for Gemini CLI, from their dependency files.

  1. TypeScript61.5%
  2. ESLint44.2%
  3. Tailwind CSS38.1%
  4. Prettier31.9%
  5. Vitest30.9%
  6. React30.4%
  7. Zod29.0%
  8. Vite28.3%
  9. Playwright (JavaScript)22.6%
  10. Tailwind Merge21.6%

Used far more often here than in AI-built projects overall: what sets Gemini CLI projects apart.

  1. Pi Agent Core3.4% · 8.5×
  2. Pi Coding Agent3.2% · 8.0×
  3. pi-tui3.2% · 8.0×
  4. c83.6% · 7.2×
  5. tslog3.4% · 6.8×
  6. @lit/context3.4% · 6.8×
  7. Rolldown3.4% · 6.8×
  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

All AI agent news

  1. Release GitHub Releases

    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

  2. Release GitHub Releases

    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

Monthly summary · Full changelog

0.69.0
  • 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
0.68.0
  • 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
0.67.0
  • 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
0.66.0
  • 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
0.65.0
  • 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
0.64.0
  • 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

Token prices of Google modelsnewest Google model in each family, output price per 1M tokens
Gemini ProGemini Flash

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.

Downloads per daynpm, 7-day average 70.8K/day
GitHub starsrunning total 109K
VS Code installsVisual Studio Marketplace, daily snapshots 1.2M
Hacker News mentionsposts and comments, rolling 7-day total 1 this week
Website rankTranco list; a lower rank means more traffic #145,386

Download the raw daily series: gemini-cli.csv

Gid Score breakdown

Adoption78
Community85
Attention11
Momentum53

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

NumberLatest readingLast checked
Package downloadsNov 17, 2026Nov 19, 06:19 UTC
GitHub starsNov 19, 2026Nov 19, 06:26 UTC
VS Code installsNov 19, 2026Nov 19, 06:26 UTC
Open VSX downloadsNov 19, 2026Nov 19, 06:26 UTC
Homebrew installsNov 19, 2026Nov 19, 06:26 UTC
Website rank (Tranco)Nov 18, 2026Nov 19, 06:30 UTC
Hacker News mentionsNov 18, 2026Nov 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

All agents on Terminal-Bench

BenchmarkModelEffortTasks solvedCost of runPlace
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:

AgentGid: #5 in Terminal Gid Score: 62/100 downloads: 495K/week ▲7% 30d

[![AgentGid: #5 in Terminal](https://agentgid.com/badges/gemini-cli-rank.svg)](https://agentgid.com/agents/gemini-cli/)
[![Gid Score: 62/100](https://agentgid.com/badges/gemini-cli-score.svg)](https://agentgid.com/agents/gemini-cli/)
[![downloads: 495K/week ▲7% 30d](https://agentgid.com/badges/gemini-cli-downloads.svg)](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.