---
title: "Gemini CLI: open-source terminal agent, free tier and alternatives"
canonical_url: https://cookiesforai.app/coding-agents/gemini-cli
markdown: https://cookiesforai.app/coding-agents/gemini-cli.md
publisher: "CookiesForAI"
last_updated: 2026-10-05T00:40:31+02:00
facts_checked: 2026-11-10
type: tool
summary: "Gemini CLI is an open source terminal coding agent by Google that runs Gemini models from the command line, with MCP, agent skills, subagents and hooks, under the Apache-2.0 license."
related:
  - "https://cookiesforai.app/coding-agents/antigravity"
  - "https://cookiesforai.app/coding-agents/claude-code"
  - "https://cookiesforai.app/coding-agents/codex"
  - "https://cookiesforai.app/coding-agents/opencode"
  - "https://cookiesforai.app/coding-agents/goose"
---

> Full index of this site: https://cookiesforai.app/llms.txt  
> Checked by CookiesForAI on 10 NOV 2026: repository facts (stars, last push, archived) re-read from GitHub.

# Gemini CLI

Gemini CLI is an open source terminal coding agent by Google that runs Gemini models from the command line, with MCP, agent skills, subagents and hooks, under the Apache-2.0 license.

## Facts

| Fact | Value |
|---|---|
| Made by | [Google](https://developers.google.com) |
| Type | Terminal coding agent |
| License | Apache-2.0 |
| Source | https://github.com/google-gemini/gemini-cli |
| GitHub stars | 108,753 on 10 NOV 2026 |
| Runs on | macOS, Windows, Linux, VS Code, JetBrains (via ACP), Zed (via ACP), Google Cloud Shell |
| Free tier | Free plan |
| Website | https://geminicli.com |
| Status | Access changed on 18 JUN 2026: Gemini CLI stopped serving free personal Google accounts and Google AI Pro and Ultra subscribers, who were told to move to Antigravity CLI. API key and Gemini Code Assist license sign-in still work. Source: [Gemini CLI announcement on GitHub](https://github.com/google-gemini/gemini-cli/discussions/28017). [All tracked AI changes](https://cookiesforai.app/ai-changelog) |
| Page updated | 05 OCT 2026 |
| Facts checked | 10 NOV 2026 ([how](https://cookiesforai.app/method)) |

## What it does

Gemini CLI is Google's open source agent for the terminal. It reads and edits files, runs shell commands, fetches web pages and can ground answers in Google Search. Its README describes Gemini 3 models with a 1 million token context window. It installs with npm or Homebrew and also comes preinstalled in Google Cloud Shell.

Gemini CLI can be extended with MCP servers, Agent Skills, extensions, subagents with their own context, and hooks that run scripts at points in the agent loop. It has a plan mode, sandboxing, checkpoints and a headless mode for scripts, and a GitHub Action (run-gemini-cli) for issue and pull request work. A VS Code companion extension and the Agent Client Protocol connect it to editors.

Gemini CLI changed how people sign in during 2026. Google's developer blog announced that from 18 JUN 2026 Gemini CLI stopped serving free personal Google accounts and Google AI Pro and Ultra subscribers, who were told to move to Antigravity CLI. The routes still documented are a Gemini API key (with a free tier), Vertex AI, and Gemini Code Assist Standard or Enterprise licenses for organizations.

## Changes to Gemini CLI

- Access changed on 18 JUN 2026: Gemini CLI stopped serving free personal Google accounts and Google AI Pro and Ultra subscribers, who were told to move to Antigravity CLI. API key and Gemini Code Assist license sign-in still work. Source: [Gemini CLI announcement on GitHub](https://github.com/google-gemini/gemini-cli/discussions/28017).

[All tracked AI changes](https://cookiesforai.app/ai-changelog)

## Who it is for

- Developers who want an open source terminal agent they can read and fork
- Teams on Google Cloud with Gemini Code Assist licenses or Vertex AI billing
- Scripted and CI use through headless mode and the run-gemini-cli GitHub Action
- Trying an agent at no cost with the free tier of a Gemini API key

## Who should pick something else

- Individuals who used a personal Google account or Google AI Pro or Ultra: Google ended that access on 18 JUN 2026 and pointed those users to Antigravity CLI
- Developers who want models from several vendors; OpenCode, Cline or Kilo Code support many providers
- People who want a desktop editor rather than a terminal; Antigravity and Cursor are editors

Strength: Gemini CLI is open source under Apache-2.0 with 107,216 GitHub stars (01 OCT 2026), and its free API-key tier lets you try it without a subscription.

Limit: Gemini CLI no longer serves free personal Google accounts or Google AI Pro and Ultra plans since 18 JUN 2026, and the free API-key tier is limited to the Flash model.

## What it costs

Free tier: Free plan. Free and open source under Apache-2.0; a Gemini API key has a free tier on the Flash model, and more use is billed per token or through Gemini Code Assist licenses.

Current prices: https://geminicli.com/docs/resources/quota-and-pricing/. Prices change often, so check the maker's own page before you buy.

## Agent skills and MCP

Skills: Gemini CLI supports Agent Skills natively. It reads workspace skills from .gemini/skills or .agents/skills and user skills from ~/.gemini/skills or ~/.agents/skills, plus skills shipped in extensions. Skills arrived as an experimental preview in v0.23.0 (07 JAN 2026) and were turned on by default in January 2026. gemini skills list and gemini skills install manage them. The open skills CLI installs into .agents/skills.

MCP: Gemini CLI adds MCP servers with gemini mcp add [options] \<name\> \<commandOrUrl\> [args...], where --scope picks user or project and --transport picks stdio, sse or http. Servers are saved under mcpServers in .gemini/settings.json (project) or ~/.gemini/settings.json (user); remote servers use url for SSE or httpUrl for streamable HTTP.

Browse all [agent skills](https://cookiesforai.app/skills) and [MCP servers](https://cookiesforai.app/mcp) in the directory.

## Questions people ask

### Is Gemini CLI still free?

Gemini CLI itself is free and open source. Model use is free with a Gemini API key within the free tier's daily limit on the Flash model, per its quota page read on 01 OCT 2026. The older free route through a personal Google account was retired on 18 JUN 2026, when Google pointed those users to Antigravity CLI.

### Does Gemini CLI support MCP and agent skills?

Yes. Add MCP servers with gemini mcp add or in .gemini/settings.json. Agent Skills load from .gemini/skills or .agents/skills, enabled by default since January 2026.

## Alternatives to Gemini CLI

- [Google Antigravity](https://cookiesforai.app/coding-agents/antigravity): Google Antigravity is an agentic development platform by Google that runs coding agents in a desktop command center, a standalone IDE, a CLI called agy and extensions for other editors.
- [Claude Code](https://cookiesforai.app/coding-agents/claude-code): Claude Code is a terminal coding agent by Anthropic that reads a codebase, edits files and runs commands, and also works in VS Code, JetBrains, a desktop app and the web.
- [OpenAI Codex](https://cookiesforai.app/coding-agents/codex): OpenAI Codex is a coding agent by OpenAI that runs as an open source CLI on your machine and as a cloud agent in ChatGPT, editing code, running commands and opening pull requests.
- [OpenCode](https://cookiesforai.app/coding-agents/opencode): OpenCode is an open source terminal coding agent by Anomaly that works with 75+ model providers, local models included, and also ships as a desktop app and IDE extension.
- [Goose](https://cookiesforai.app/coding-agents/goose): Goose is an open source AI agent, created by Block and now part of the Agentic AI Foundation at the Linux Foundation, that runs as a desktop app and CLI with any model provider.

## Compare coding agents

| Tool | Type | Runs on | Free tier |
|---|---|---|---|
| Gemini CLI | Terminal coding agent | macOS · Windows · Linux · VS Code · JetBrains (via ACP) · Zed (via ACP) · Google Cloud Shell | Free plan |
| [Aider](https://cookiesforai.app/coding-agents/aider) | Terminal coding agent | macOS · Windows · Linux · Docker | Free |
| [Amp](https://cookiesforai.app/coding-agents/amp) | Terminal coding agent | macOS · Linux · Windows (WSL) · Web · macOS app · iOS · Slack | Free plan |
| [Claude Code](https://cookiesforai.app/coding-agents/claude-code) | Terminal coding agent | macOS · Windows · Linux · VS Code · JetBrains · Desktop app · Web · iOS · Android | Paid only |
| [Cline](https://cookiesforai.app/coding-agents/cline) | Editor extension | VS Code · Cursor · Windsurf · VSCodium · Antigravity · JetBrains · CLI · Desktop app (macOS, Windows) | Free plan |

[Compare all 20 →](https://cookiesforai.app/coding-agents)

## More in Coding agents

- [Aider](https://cookiesforai.app/coding-agents/aider): Aider is an open source terminal coding agent from the Aider-AI project that edits files in your git repo with the model of your choice and commits each change automatically.
- [Amp](https://cookiesforai.app/coding-agents/amp): Amp is a coding agent by Amp Frontier Corporation, spun out of Sourcegraph, that runs in a terminal CLI, a web app and macOS and iOS apps, with per-thread cloud machines.
- [Claude Code](https://cookiesforai.app/coding-agents/claude-code): Claude Code is a terminal coding agent by Anthropic that reads a codebase, edits files and runs commands, and also works in VS Code, JetBrains, a desktop app and the web.
- [Cline](https://cookiesforai.app/coding-agents/cline): Cline is an open source coding agent by Cline Bot Inc. that runs as a VS Code or JetBrains extension and a CLI, using your own model keys or local models.
- [Continue](https://cookiesforai.app/coding-agents/continue): Continue is an open source coding agent for VS Code, JetBrains and the terminal by Continue Dev, Inc., which Cursor acquired; its GitHub repo is now read-only and no longer maintained.
- [Cursor](https://cookiesforai.app/coding-agents/cursor): Cursor is an AI code editor by Anysphere that pairs a desktop editor with an agent, a CLI and cloud agents, using models from several vendors plus its own Composer models.
- [Devin](https://cookiesforai.app/coding-agents/devin): Devin is a cloud coding agent by Cognition that works in its own virtual machines, takes tasks from Slack, GitHub, Linear or Jira, and also ships as a CLI and the Devin Desktop editor.
- [GitHub Copilot](https://cookiesforai.app/coding-agents/github-copilot): GitHub Copilot is an AI coding assistant by GitHub that works in VS Code, JetBrains and other editors, in a CLI, and as a cloud agent that opens pull requests on GitHub.
- [Google Antigravity](https://cookiesforai.app/coding-agents/antigravity): Google Antigravity is an agentic development platform by Google that runs coding agents in a desktop command center, a standalone IDE, a CLI called agy and extensions for other editors.
- [Goose](https://cookiesforai.app/coding-agents/goose): Goose is an open source AI agent, created by Block and now part of the Agentic AI Foundation at the Linux Foundation, that runs as a desktop app and CLI with any model provider.
- [Hermes Agent](https://cookiesforai.app/coding-agents/hermes-agent): Hermes Agent is an open source personal AI agent by Nous Research that runs in the terminal, a desktop app and messaging apps, and writes new skills for itself from completed tasks.
- [Junie](https://cookiesforai.app/coding-agents/junie): Junie is a coding agent by JetBrains that runs as a CLI on macOS, Windows and Linux, inside JetBrains IDEs and in GitHub or GitLab pipelines, with any model you choose.
- [Kilo Code](https://cookiesforai.app/coding-agents/kilo-code): Kilo Code is an open source coding agent by Kilo Code, Inc., acquired by Anaconda in 2026, that runs in VS Code, JetBrains IDEs, a CLI and cloud agents with 500+ models.
- [OpenAI Codex](https://cookiesforai.app/coding-agents/codex): OpenAI Codex is a coding agent by OpenAI that runs as an open source CLI on your machine and as a cloud agent in ChatGPT, editing code, running commands and opening pull requests.
- [OpenClaw](https://cookiesforai.app/coding-agents/openclaw): OpenClaw is an open source personal AI agent from the OpenClaw Foundation that runs on your own machine and takes tasks from WhatsApp, Telegram, Slack, Discord and other chat apps.
- [OpenCode](https://cookiesforai.app/coding-agents/opencode): OpenCode is an open source terminal coding agent by Anomaly that works with 75+ model providers, local models included, and also ships as a desktop app and IDE extension.
- [Roo Code](https://cookiesforai.app/coding-agents/roo-code): Roo Code was an open source coding agent extension for VS Code by Roo Code, Inc.; the extension was shut down on 15 MAY 2026 and its GitHub repository is archived.
- [Windsurf (now Devin Desktop)](https://cookiesforai.app/coding-agents/windsurf): Windsurf is an AI code editor by Cognition, renamed Devin Desktop on 02 JUN 2026, that pairs a desktop editor and Tab completions with a local agent and handoff to Devin's cloud agents.
- [Zed](https://cookiesforai.app/coding-agents/zed): Zed is an open source code editor by Zed Industries, written in Rust, with a built-in AI agent, edit predictions, external agents over ACP and real-time collaboration.
