Google open-source terminal agent with free tier Fact-checked · 2026-11-17

Gemini CLI Hub: Free Tier Quota, Google Sign-in, GEMINI.md and Extensions

Guide to Google's Apache-2.0 open-source terminal agent (google-gemini/gemini-cli): free quota with a personal Google account, GEMINI.md instructions, sandboxing and MCP extensions.

Key takeaways

  • Gemini CLI (`google-gemini/gemini-cli`) is Apache-2.0 open source and offers a generous free tier when signing in with a personal Google account.
  • Includes built-in Google Search grounding, file tools and shell execution backed by Gemini's large context window.
  • Configured via hierarchical `GEMINI.md` files, `~/.gemini/settings.json`, MCP servers and Gemini CLI extensions.
  • Supports `--sandbox` execution using macOS Seatbelt, Docker or Podman containers.

Key facts: pricing, models, surfaces & safety

Pricing & quota
Apache-2.0 open source · Free tier with personal Google account

Sign in with a personal Google account for free Code Assist quota, or connect a paid Gemini API key or Google Cloud Vertex AI project for higher rate limits and enterprise data governance.

Models & providers
Google Gemini Pro & Flash models (AI Studio & Vertex AI)

Runs Gemini models directly through Google account login, `GEMINI_API_KEY`, or Vertex AI enterprise endpoints.

OS & surfaces
macOS · Linux · Windows (Node.js terminal CLI)

Distributed via npm (`npx @google/gemini-cli`) and runs in any terminal or integrated IDE shell.

Safety & permissions
Prompts before writes/commands · Optional `--sandbox` isolation

Asks confirmation before modifying files or running shell commands by default; `--sandbox` isolates execution inside Seatbelt, Docker or Podman.

Extension points: GEMINI.md, settings.json and Extensions

Ecosystem tools integrate with Gemini CLI through three mechanisms:

GEMINI.md

Hierarchical context files loaded from `~/.gemini/GEMINI.md` and the project workspace.

~/.gemini/settings.json

Configures sandbox defaults, approval behavior and connected MCP servers.

Gemini CLI Extensions

Reusable extension packages bundling custom tools, prompts and MCP integrations.

Setup & troubleshooting guides

Gemini CLI ecosystem & extensions

Plugins, config packs, switchers and orchestration layers in the directory built for Gemini CLI, by stars; each has its own FARS review.

Plugins, routing & companion extensions

Dev & Engineering

Caveman Token-Saving Toolkit

Reduce coding-agent token use by compressing what agents read and shortening what they say.

72 · Some gaps ★ 122k · 1d ago
Dev & Engineering

Agentic Plugin Marketplace

Composable developer-workflow plugins for multiple coding-agent harnesses.

70 · Some gaps ★ 43k · 3d ago
Productivity & Collaboration

gws for Google Workspace

A dynamic CLI for calling Google Workspace APIs with structured JSON output for scripts, operators, and AI-assisted workflows.

66 · Some gaps ★ 32k · today
Dev & Engineering

Plannotator

Visually annotate your coding agent's plans and diffs in the browser and send feedback back with one click.

80 · Good ★ 14k · today
Dev & Engineering

Coucou Agent Companion

Keep coding-agent sessions and approval requests in view on your Mac, then follow them from your iPhone.

67 · Some gaps ★ 7.4k · today
Dev & Engineering

Obsidian Mind

Persistent, searchable memory for AI coding agents across sessions and repositories.

72 · Some gaps ★ 5.6k · 1mo ago
Dev & Engineering

Council of High Intelligence

Put consequential decisions through independent analysis, direct challenge, and a verdict that preserves dissent.

63 · Some gaps ★ 4.9k · 5d ago
Dev & Engineering

cc-skills-golang: Agent Skills for Production-Ready Go

A curated, human-reviewed collection of Golang agentic skills covering code style, testing, security, performance, and more, ready for any compatible AI coding assistant.

51 · Major gaps ★ 3.9k · 12d ago
Dev & Engineering

CCB Multi-Agent Terminal Workspace

Coordinate multiple AI coding CLIs in visible terminal panes you can directly take over.

79 · Good ★ 3.6k · 1d ago
Design & Frontend

Designer Skills Pack

Agentic skills, commands, and plugins for design — from research to systems, UI, interaction, and delivery.

57 · Major gaps ★ 3.4k · 2mo ago
Automation & Ops

Open Computer Use (MCP desktop service)

An MCP service for running desktop Computer Use operations from AI clients.

79 · Good ★ 3k · 1d ago
Dev & Engineering

VibeKit — Safety Layer for Coding Agents

Run Claude Code, Gemini, Codex and more in an isolated sandbox with built-in sensitive data redaction and observability.

47 · Major gaps ★ 1.9k · 1y ago
Dev & Engineering

agmsg Cross-Agent Messaging

A local SQLite message layer for coordinating CLI coding agents across tools.

74 · Some gaps ★ 1.6k · today
Productivity & Collaboration

COG Second Brain

A self-evolving, local-first second brain that turns daily braindumps, team intelligence, and PM workflows into verified knowledge using plain Markdown files and AI agents.

57 · Major gaps ★ 1.5k · 29d ago
Dev & Engineering

Agent Deck

One terminal TUI to run, monitor, and switch between every Claude Code, Codex, and Gemini CLI session — with forks, worktrees, cost tracking, and phone-controlled orchestration.

74 · Some gaps ★ 1.3k · today
Dev & Engineering

Chisle

Cut your AI coding agent's token bill on three axes — terser prose, YAGNI-first code, compressed tool output — without losing accuracy.

77 · Good ★ 1.2k · 2d ago
Dev & Engineering

Claude Codex Settings

Battle-tested Claude Code, Codex CLI, and Cursor configs, plugins, hooks, and agents with Kimi, MiniMax, and GLM API support — fixing the failure modes of AI coding assistants.

61 · Some gaps ★ 1.2k · 1d ago
Dev & Engineering

claude-replay

Turns AI coding agent sessions into self-contained, embeddable interactive HTML replays that are easy to share.

72 · Some gaps ★ 863 · 8d ago
Dev & Engineering

Agent Manager

One tmux TUI that puts every AI coding agent in a single list with live status, quick prompts, and diff review.

75 · Good ★ 701 · today

Browse Gemini CLI skills on FollowSkills → Switching Gemini CLI between model providers? Read the CC Switch guide →

Gemini CLI comparisons & rankings

Related concepts

Frequently asked questions

Does the free Gemini CLI tier train on my code?

Data terms differ between the free personal Google account tier and paid API / Vertex AI tiers. For proprietary codebases, use a paid Gemini API key or Vertex AI enterprise credentials with data-logging disabled.

How do I enable sandboxing in Gemini CLI?

Pass `-s` or `--sandbox` on startup or enable `sandbox` in `~/.gemini/settings.json` to run shell commands inside macOS Seatbelt or a Docker/Podman container.

Host agent ecosystem hubs