# Gemini CLI

Terminal-based coding agent that reads and changes files, runs shell commands, and can be extended through MCP, extensions, and skills.

Canonical profile: https://agenten-kompass.mmeierhoff.chatgpt.site/en/agents/gemini-cli/
Editor: [Michael Meierhoff](https://agenten-kompass.mmeierhoff.chatgpt.site/en/about/)
Sources reviewed: 2026-10-09
Basis: provider documentation. Examples are editorial suggestions, not hands-on product tests.

## Overview

Gemini CLI is Google's terminal-based agent for local development work. MCP, extensions, and skills supplement its built-in tools.

- Provider: Google
- Product family: Gemini
- Profile type: Local terminal agent
- Environment: Local terminal on macOS, Linux, Windows, or WSL
- Connections: Local files, shell, web search, MCP servers, extensions, and Agent Skills
- Setup: Set up Node.js, Gemini CLI, supported access, and a project directory
- Pricing model: CLI from USD 0; AI Pro USD 19.99/month, Ultra from USD 99.99/month (US prices); API separate

## Operation & oversight

Operational details for this profile have not yet been researched.

## Provider

Google develops AI models and developer and cloud tools. Gemini CLI is the terminal-based open-source agent; Antigravity combines desktop, IDE and CLI work with a shared agent core.

- Operator: Google
- Organization: Company
- Website: https://about.google
- Reviewed: 2026-10-09

- Repository: https://github.com/google-gemini/gemini-cli
- GitHub-Stars: 107256 (2026-10-09)
- License: Apache-2.0

- Provider source: https://about.google/company-info/

- Provider source: https://geminicli.com/docs/resources/quota-and-pricing/

- Provider source: https://antigravity.google/docs/home

- Provider source: https://api.github.com/repos/google-gemini/gemini-cli

## Prices and included usage

Pricing checked: 2026-10-09

The CLI offers free access. Higher allowances follow the Google subscription; API or Vertex access can be billed by usage.

### Google account / Code Assist Individual

USD 0

Up to 1,000 model requests per user per day.

Price source: https://geminicli.com/docs/resources/quota-and-pricing/

### Unpaid Gemini API key

USD 0

Up to 250 requests per day, Flash model only.

Price source: https://geminicli.com/docs/resources/quota-and-pricing/

### Google AI Pro

USD 19.99 per month on the US pricing page

Up to 1,500 CLI model requests per user per day.

Price source: https://gemini.google/subscriptions/

### Google AI Ultra 5x

USD 99.99 per month on the US pricing page

Ultra access with up to 2,000 CLI model requests per user per day.

Price source: https://gemini.google/subscriptions/

Google AI Plus is not supported according to CLI documentation. Workspace Code Assist Standard/Enterprise have separate seat licenses and quotas.

Pay-as-you-go uses Gemini API or Vertex billing; prices: https://ai.google.dev/gemini-api/docs/pricing and https://cloud.google.com/vertex-ai/generative-ai/pricing.

Pricing details: https://geminicli.com/docs/resources/quota-and-pricing/

## Key features

### Edit files and code

Built-in tools read project files and suggest targeted changes.

Source: https://geminicli.com/docs/reference/tools/

### Use shell and web tools

The agent can run shell commands and search for information using built-in tools.

Source: https://geminicli.com/docs/reference/tools/

### Connect MCP servers

MCP provides additional tools, resources, and prompts through local or remote servers.

Source: https://geminicli.com/docs/tools/mcp-server/

### Load extensions and skills

Extensions bundle configuration and tools; Skills provide task-specific instructions and resources.

Source: https://geminicli.com/docs/cli/using-agent-skills/

### Approve tool calls

File changes and shell commands are assessed according to security policies and may require confirmation.

Source: https://geminicli.com/docs/reference/tools/

### Revert changes using a checkpoint

Optionally saved project and conversation states can be restored with the restore command.

Source: https://geminicli.com/docs/cli/checkpointing/

### Headless automation

Non-interactive mode runs tasks from scripts and automated workflows.

Source: https://geminicli.com/docs/cli/headless/

### Hooks for agent events

Hooks connect agent run events with custom commands.

Source: https://geminicli.com/docs/hooks/

## Requirements and limits

### Local requirements and internet access

Requirement: Installation requirements include a supported operating system, Node.js, a shell, and internet access.

Source: https://geminicli.com/docs/get-started/installation/

### Sandbox depends on configuration

Limitation: Sandboxing must be configured for the platform; additional paths or network access may require separate approvals.

Source: https://geminicli.com/docs/cli/sandbox/

### Checkpoints are disabled by default

Limitation: Checkpoint recovery is available only after it has been enabled in the configuration.

Source: https://geminicli.com/docs/cli/checkpointing/

### Skills require activation approval

Requirement: The skills documentation requires source confirmation when installing from a remote URL and approval each time a skill is activated during a session.

Source: https://geminicli.com/docs/cli/using-agent-skills/

### Free daily allowances

Limitation: Free Google sign-in includes 1,000 model requests per person per day. A free Gemini API key includes 250 requests per day and is limited to Flash models.

Source: https://geminicli.com/docs/resources/quota-and-pricing/

## Example workflows

### Make a small change in the terminal

- Your input: A local repository, project rules, and a narrow acceptance criterion.
- Possible result: A traceable diff with completed checks.
- What to check: Review suggested commands, file changes, and test results.

### Use a project tool through MCP

- Your input: A reviewed MCP server, minimal credentials, and a specific task.
- Possible result: A structured tool call with a result in the CLI context.
- What to check: Check the server source, shared tools, arguments, and external effects.

## Context

Local installation requires Node.js, a shell and internet access. Free Google sign-in includes 1,000 requests per day; the free API key allows 250 Flash requests per day.

Official tools, MCP, sandbox, skills, checkpoint and installation documentation checked. Checkpoints require explicit enablement; security rules and sandbox behavior follow platform and configuration.

## Sources

- https://geminicli.com/docs/reference/tools/

- https://geminicli.com/docs/tools/mcp-server/

- https://geminicli.com/docs/cli/sandbox/

- https://geminicli.com/docs/cli/using-agent-skills/

- https://geminicli.com/docs/cli/checkpointing/

- https://geminicli.com/docs/get-started/installation/

- https://geminicli.com/docs/cli/headless/

- https://geminicli.com/docs/hooks/

- https://geminicli.com/docs/resources/quota-and-pricing/

[Sources and method](https://agenten-kompass.mmeierhoff.chatgpt.site/en/sources/)
