Google released Gemini CLI on June 25, 2025, an open-source AI agent that brings its Gemini models into the terminal. The tool arrived under the Apache 2.0 license with a free tier for anyone with a personal Google account, a 1 million token context window and support for Model Context Protocol (MCP) servers. It gave developers a no-cost, inspectable alternative in the fast-growing category of terminal coding agents, and its generous limits made it easy to try on real projects.
Key Facts#
- Launch date: The first
@google/gemini-clipackage (version 0.1.0) was published to npm on June 25, 2025. The earliest release in the GitHub repository, an early-access pre-release, is dated June 24, 2025. - License: Apache 2.0, with the full source on GitHub.
- Free tier: Up to 60 model requests per minute and 1,000 model requests per day when signing in with a personal Google account, according to the launch-era README.
- Context window: The README advertised a 1 million token context window for querying and editing large codebases.
- Authentication: Personal Google accounts by default, with Google AI Studio API keys and Google Workspace accounts as alternatives.
- Installation: Run it directly with
npxfrom the GitHub repository or install it globally withnpm install -g @google/gemini-cli. - Extensibility: Built-in Google Search grounding and support for tools and MCP servers, including media generation with Imagen, Veo and Lyria.
What Happened#
Gemini CLI appeared as a public repository and npm package in the last week of June 2025. Package metadata shows version 0.1.0 published on June 25, followed by several more versions the same day as the team shipped fixes. Versions 0.1.6 and 0.1.7 followed on June 28, which gives a sense of the release pace in the first days.
The launch-era README described the tool as a command-line AI workflow tool that connects to your tools, understands your code and accelerates your workflows. It listed a practical set of jobs: querying and editing large codebases within and beyond the 1 million token context window, generating new apps from PDFs or sketches using Gemini's multimodal capabilities, automating operational tasks such as querying pull requests or handling complex rebases, and connecting new capabilities through tools and MCP servers.
The free tier stood out. Up to 60 requests per minute and 1,000 per day was enough for sustained individual use, which lowered the barrier for developers who had not yet paid for an AI coding tool. Teams that needed different terms could use an API key from Google AI Studio or sign in with a Google Workspace account instead.
Background#
By mid-2025, agentic coding had shifted toward the terminal. Anthropic's Claude Code had reached general availability in May, and OpenAI had released its own open-source Codex CLI in April. The appeal of this form factor is simple: a terminal agent can run the same build, test and git commands a developer uses, so it can check its work without a special editor integration.
Google's entry differed from its competitors in two ways at launch. The whole agent was open source under a permissive license, so teams could audit how it handled files, shell commands and credentials, and fork it if needed. And the free quota was large enough that cost was not a barrier to evaluation. Both choices put pressure on the rest of the market.
MCP support was also significant. By shipping with MCP from day one, Google signaled that the protocol Anthropic introduced in late 2024 had become the common way to extend coding agents, regardless of which company made the model.
Why It Matters for Developers#
Gemini CLI is distributed as a Node.js package, but it is language-agnostic in use. On a .NET codebase it can read a solution, run dotnet build and dotnet test through its shell tool and iterate on failures. As with any agent, the quality of your build and test setup largely determines the quality of its output, which our guide to AI-assisted .NET development covers in depth.
The most useful integration point for .NET teams is MCP. Gemini CLI reads MCP server definitions from its settings.json file, so a tool you build with the official C# SDK (see our MCP in C# guide) can be registered next to servers written in other languages. A stdio server that you run from source looks like this:
{
"mcpServers": {
"inventoryTools": {
"command": "dotnet",
"args": ["run", "--project", "./tools/Inventory.McpServer"],
"env": {
"INVENTORY_API_KEY": "$INVENTORY_API_KEY"
},
"timeout": 30000,
"trust": false
}
}
}Some practical points follow from how the tool works:
- Keep
trustoff for anything that writes. The setting bypasses confirmation prompts. Leave it at the defaultfalsefor tools with side effects. - Keep secrets out of the file. The configuration supports environment variable expansion, so reference secrets instead of pasting them. Our secrets management guide covers the options.
- Protect standard output in stdio servers. The stdio transport carries protocol messages over standard output, so .NET servers should send logs to standard error or a file.
- Check the data terms for your account type. Personal accounts, API keys and Workspace accounts are separate sign-in paths, so choose the one that matches your organization's policies before pointing the agent at proprietary code.
Project-level context files called GEMINI.md let a repository describe its conventions to the agent, a pattern similar to the instruction files other coding agents use.
What's Next#
Gemini CLI has changed quickly since launch. The project changelog records an extensions framework and extension catalog in late September 2025, an interactive shell in October, and model routing and a codebase investigator subagent later that month. Support for Gemini 3 models arrived in November 2025, and in December the free tier gained access to Gemini 3 Pro and Flash while the CLI became pre-installed in Google Colab. In February 2026, version 0.29.0 introduced a Plan Mode and made Gemini 3 the default for all users.
The current README also describes a Gemini CLI GitHub Action for automated pull request reviews, issue triage and on-demand help through @gemini-cli mentions, along with Homebrew, MacPorts and Anaconda installation options. Release 0.61.0 shipped on September 23, 2026.
Open questions for teams are the familiar ones for any fast-moving agent: how to pin versions in CI, how to review changes to agent behavior between releases, and how to govern which MCP servers developers may connect. Because the code is open, those questions can at least be answered by reading the source.