The problem
How it works
The README covers installing with npx, npm or Homebrew, signing in with a Google account, a Gemini API key or Vertex AI, and using the agent to query and edit large codebases, debug in plain language and run non-interactively in scripts. Simon Willison had early access in June 2025, listed its small built-in tool set (file read and write, edit, grep, glob, shell, web fetch and search, memory) and had the CLI inspect its own source to find them.
Results and limitations
Willison called it very good, crediting Gemini’s million-token context and its judgement about when to read files and when to run commands. Google’s May 2026 post reports over 100,000 GitHub stars and 6,000 merged pull requests.
Before you try it
Since 18 June 2026 the repository says Gemini CLI is maintained for Gemini Code Assist Standard and Enterprise customers; free and Google AI Pro or Ultra users were moved to Antigravity CLI, which Google says lacks full feature parity at first. The README also warns it is not tuned for Gemini 4 models. Check which tool your account supports before you start. Results depend on your setup and were not independently reproduced by Top 200 Repos.
Tools and repositories
- Tools
- Gemini CLI · Node.js
- Prerequisites
- A Gemini Code Assist Standard or Enterprise licence or a paid API key; individual accounts now use Antigravity CLI instead.
Try it yourself: Map an unfamiliar codebase before editing
Fill the fields to adapt the prompt. Empty fields stay as visible [placeholders].
Read this repository and explain how [Feature area] works: the entry points, the main modules and data flow, and where tests for it live. Cite file paths for every claim. Then propose the smallest change that would [Change goal], list the files you would edit, and wait for my approval. After approval, make the change, run [Test command], and show the diff and test output. Do not run commands that delete files or push to a remote.The same prompt works in other terminal agents, which makes it a fair way to compare them on your own code.
Related videos
About google-gemini/gemini-cli
Google Gemini CLI Is FREE & Crazy Powerful: Real World Coding Test & First Impressions (opens in a new tab)
The description links the GitHub repository.
Watch on YouTube (opens in a new tab)About google-gemini/gemini-cli
Gemini CLI – the real Claude Code killer? (opens in a new tab)
The description links the GitHub repository.
Watch on YouTube (opens in a new tab)Independent creators. Listing a video implies no endorsement, sponsorship or partnership.
Sources
- google-gemini/gemini-cli README (opens in a new tab)
Project documentation · github.com · Undated · Source checked 11 Nov 2026, 10:02 UTC
What this source supports
- Install with npx, npm or Homebrew; sign in with Google, an API key or Vertex AI
- Query and edit large codebases; non-interactive mode for scripts
- Status note: enterprise Code Assist only; free access moved to Antigravity CLI on 18 June 2026
- Not optimized for Gemini 4 models
- Gemini CLI (opens in a new tab)
First-person account · simonwillison.net · Published 25 Jun 2025 · Source checked 11 Nov 2026, 10:02 UTC
What this source supports
- Early hands-on access; judged it very good
- Credits the million-token context and good judgement about tools
- Open source under Apache 2.0, with a small built-in tool set
- An important update: Transitioning Gemini CLI to Antigravity CLI (opens in a new tab)
Vendor post · developers.googleblog.com · Published 19 May 2026 · Source checked 11 Nov 2026, 10:02 UTC
What this source supports
- Over 100,000 GitHub stars and 6,000 merged pull requests
- Google is unifying terminal work into Antigravity CLI
- No 1:1 feature parity at first; skills, hooks, subagents and extensions carried over

