Skip to content
Resource archive · retained for referenceExplore design skills →

Gemini CLI

Use Gemini CLI when you want a terminal-first coding agent with explicit context and tool boundaries.

About this resource

Gemini CLI is Google's open-source terminal agent for developers who want model access inside a local project. It is useful when a team wants a command-line agent with visible setup choices: Google OAuth or API-key authentication, stable versus preview release channels, GEMINI.md project context, MCP servers, checkpointing, sandboxing, and headless automation.

Capabilities

  • Terminal-first coding agent
  • MCP, skills, hooks, and custom context
  • Stable, preview, and nightly release channels

Use cases

  • Codebase exploration
  • Repo-local automation
  • MCP-connected terminal workflows

Getting started

  • Start on a disposable branch or sample repo
  • Use the stable release channel first
  • Verify sandbox, checkpointing, and MCP settings before write-heavy work

Strengths

  • Apache-2.0 open source
  • Works from the command line and supports headless automation
  • Official docs expose context, sandbox, checkpoint, and MCP controls

Considerations

  • Teams should choose stable releases for normal use and treat preview or nightly builds as test channels
  • Shell, file, and MCP tool access should be reviewed before using it on sensitive repositories
  • Authentication choice matters: personal OAuth, API key, and Vertex AI paths carry different quota and governance assumptions

Questions

Is Gemini CLI an official Google project?

Yes. The public repository is under the google-gemini organization and is published under the Apache-2.0 license.

Should teams start with preview or nightly builds?

Usually no. Stable is the safer default; preview and nightly channels are better treated as test surfaces for specific changes.

Gemini CLI for Terminal AI Agents