Gemini CLI Documentation llms.txt · AI Docs Browser · mdream

[llms.txt Tools](https://mdream.dev/llms-txt/gemini-cli/llms-txt)

# Gemini CLI Documentation llms.txt

Browse Gemini CLI Documentation documentation as markdown. Click any page in the sidebar to view it, or copy the full llms.txt for your AI tools.

geminicli.com/llms.txt

[Raw llms.txt](https://geminicli.com/llms.txt) [Raw llms-full.txt](https://geminicli.com/llms-full.txt)

Copy Markdown [](https://geminicli.com/llms.txt)

llms.txt

Guiding principle: Issues and pull requests

Detailed automation workflows

Current releases

Announcements: v0.50.0 - 2026-07-08

#28113

#28132

Announcements: v0.45.0 - 2026-06-03

#27345

#27288

#27461

Announcements: v0.44.0 - 2026-05-27

#26714

#21090

#27121

Announcements: v0.43.0 - 2026-05-22

#26480

#26514

#26888

Announcements: v0.42.0 - 2026-05-12

#26338

#26307

#26454

Announcements: v0.41.0 - 2026-05-05

#24174

#25814

#25720

Announcements: v0.40.0 - 2026-04-28

#15504

#25716

#25498

Announcements: v0.39.0 - 2026-04-23

#25148

#25058

#25079

Announcements: v0.38.0 - 2026-04-14

#24079

#24483

#24793

#23257

Announcements: v0.37.0 - 2026-04-08

#23691

#24079

#23805

Announcements: v0.36.0 - 2026-04-01

#21807

#23286

#23265

#22951

Announcements: v0.35.0 - 2026-03-24

#21972

#22026

#22680

#22736

Announcements: v0.34.0 - 2026-03-17

#21713

#20735

Announcements: v0.33.0 - 2026-03-11

#20622

#20988

#20853

Announcements: v0.32.0 - 2026-03-03

#19665

#20343

#20465

#20082

#20229

Announcements: v0.31.0 - 2026-02-27

#19676

#19284

#20024

#19567

Announcements: v0.30.0 - 2026-02-25

#18861

#18500

#19064

#18931

Announcements: v0.29.0 - 2026-02-17

#18324

#18414

#18686

#18311

Announcements: v0.28.0 - 2026-02-10

#15047

#17976

#17569

Announcements: v0.27.0 - 2026-02-03

#17078

#15720

#17144

Announcements: v0.26.0 - 2026-01-27

#16638

#15717

#16895

Announcements: v0.25.0 - 2026-01-20

@joshualitt

@NTaylorMullen

@sehoon38

Announcements: v0.24.0 - 2026-01-14

@adamweidman

@galz10

@NTaylorMullen

@NTaylorMullen

@scidomino

@NTaylorMullen

Announcements: v0.23.0 - 2026-01-07

Agent Skills

@sgeraldes

@jacob314

@CN-Scars

Announcements: v0.22.0 - 2025-12-22

Announcements: v0.21.0 - 2025-12-15

Gemini 3 Flash is now available in Gemini CLI

Announcements: v0.20.0 - 2025-12-01

@jackwotherspoon

@allenhutchison

Announcements: v0.19.0 - 2025-11-24

@benbrandt

Announcements: v0.18.0 - 2025-11-17

policy engine documentation

@scidomino

@JayadityaGit

Announcements: v0.16.0 - 2025-11-10

https://github.com/gemini-cli-extensions/datacommons

Announcements: v0.15.0 - 2025-11-03

Announcements: v0.12.0 - 2025-10-27

Announcements: v0.11.0 - 2025-10-20

@anj-s

@srivatsj

@akhil29

@abhipatel12

@capachino

Announcements: v0.10.0 - 2025-10-13

@galz10

@srivatsj

@jerop

Announcements: v0.9.0 - 2025-10-06

@jakemac53

@chrstnb

@jerop

@sgnagnarella

Announcements: v0.8.0 - 2025-09-29

@mistergarrison

@Fridayxiao

Announcements: v0.7.0 - 2025-09-22

@skeshive

@jerop

@anj-s

@rramkumar1

@scidomino

@capachino

Announcements: v0.6.0 - 2025-09-15

@jerop

@bulkypanda

@rramkumar1

@Aisha630

@masiafrest

@SandyTao520

@jerop

@miguelsolorio

Announcements: v0.5.0 - 2025-09-08

@jackwotherspoon

@allenhutchison

@SandyTao520

@silviojr

@JayadityaGit

@gsquared94

@chrstnb

@skeshive

https://codelabs.developers.google.com/gemini-cli-hands-on

Announcements: v0.4.0 - 2025-09-01

@miguelsolorio

@scidomino

@JayadityaGit

@abhipatel12

@psinha40898

@allenhutchison

@leehagoodjames

@deepankarsharma

@swissspidy

Install

Get started

Use Gemini CLI

Features

Configuration

Reference

Resources

Development

Releases

The goal

Level 1: Automated gates (must pass)

Level 2: Manual verification and dogfooding

Level 3: Telemetry and data review

The "go/no-go" decision

@google/gemini-cli

@google/gemini-cli-core

NPM workspaces

Highlights

What's Changed

#28116

#28132

#28113

#28147

Highlights

What's Changed

#28150

#28131

#28151

#28145

#27966

#28053

#28015

#28233

#28167

#28221

#28299

#27971

Admin Controls vs. System Settings

Available Controls

CLI commands

Interactive commands

CLI Options

Model selection

Extensions management

MCP server management

Skills management

Tracing

Agent Client Protocol (ACP)

Architecture and protocol basics

Capabilities and supported methods

Debugging and telemetry

Overview

Prerequisites

How to enable Auto Memory

How Auto Memory works

How to review extracted items

How to disable Auto Memory

Data and privacy

Limitations

Next steps

Agent Skills

memory management tutorial

Settings

dev vs prod environment

Release cadence and tags

Weekly release promotion

Manual releases

Rollback/rollforward

Patching

Release validation

Local testing and validation: Changes to the packaging and publishing process

Release deep dive

Notifications

How it works

Enabling the feature

Using the /restore command

How it works

How to use .geminiignore

Understand the context hierarchy

Manage context with the /memory command

Modularize context with imports

Customize the context file name

Next steps

Ignoring files

Memory tool

Custom commands

Quickstart: Create a skill with a prompt

Manual creation

Gemini CLI extension

Core concepts

Advanced development

Next steps

Skill best practices

Agent Skills overview

Get started with Agent Skills

1. System Overview

2. Configuration Primitives

3. Resolution Strategy

4. Configuration Reference

5. Practical Examples

File locations and precedence

Naming and namespacing

TOML file format (v1)

Handling arguments

Example: A "Pure Function" refactoring command

Before you begin

Code contribution process

GEMINI.md

Documentation contribution process

FAQ

an issue

Overview

Building the tests

Running the tests

Running a specific set of tests

Memory regression tests

Performance regression tests

Diagnostics

Linting and formatting

Directory structure

Continuous integration

Centralized configuration: The system settings file

User isolation in shared environments

Restricting tool access

Managing custom tools (MCP servers)

Enforcing sandboxing for security

Controlling network access via proxy

Telemetry and auditing

Authentication

Putting it all together: example system settings.json

How to enable Git worktrees

How to use Git worktrees

How to exit a Git worktree session

Resuming work in a Git worktree

Managing Git worktrees manually

Technical reference

Exit codes

Next steps

Automation tutorial

CLI reference

How to use the /model command

Best practices for model selection

How it works

Requirements

Enable notifications

Types of notifications

Next steps

Plan Mode

settings

How to enter Plan Mode

How to use Plan Mode

How to exit Plan Mode

Tool Restrictions

glob

get_internal_docs

cli_help

ask_user

MCP resource tools

custom plans directory

activate_skill

Customization and best practices

Commands

Planning workflows

enter_plan_mode

ask_user

custom plan directory and policies

exit_plan_mode

exit_plan_mode

custom policies

Automatic Model Routing

Cleanup

session retention

Non-interactive execution

YOLO mode

Usage

Interface

Key considerations

Enabling model steering

Using model steering

How it works

Next steps

Plan Mode

Agent Skills

Automatic saving

Resuming sessions

Parallel sessions with Git worktrees

Managing sessions

Configuration

Next steps

Memory tool

Checkpoint

CLI reference

Prerequisites

Overview of sandboxing

Quickstart

Configuration

Sandboxing methods

Tool sandboxing

Sandbox expansion

Running inside a Docker container

Advanced settings

Troubleshooting

Security notes

Related documentation

Configuration

Commands

Troubleshooting

Settings reference

How it works

Discovery tiers

Key benefits

Managing skills

Next steps

Get started with Agent Skills

Creating Agent Skills

Using Agent Skills

Best practices

Overview

How to enable

Quick examples

UI indicator

Variable Substitution

Export the default prompt (recommended)

Best practices: system.md vs GEMINI.md

Troubleshooting

Design for discovery

Progressive disclosure

Degrees of freedom

Bundle resources effectively

Anatomy of a great skill

Security and privacy

OpenTelemetry integration

Configuration

Google Cloud telemetry

Logs Explorer

Metrics Explorer

Trace Explorer

View and analyze logs with Logs Explorer

Create charts with Metrics Explorer

Find and explore traces

Local telemetry

Client identification

Logs, metrics, and traces

Available themes

Custom color themes

configuration precedence

Dark themes

Light themes

Enabling the feature

How it works: The trust dialog

Understanding folder contents: The discovery phase

Why trust matters: The impact of an untrusted workspace

Headless and automated environments

Overriding the trust file location

Managing your trust settings

The trust check process (advanced)

Discovery tiers

In-session management

Terminal utilities

Security and consent

Next steps

Get started with Agent Skills

Creating Agent Skills

Skill best practices

What is this?

Quick start

Commands

Verifying it works

Setup flags

How it works under the hood

Disabling

Advanced setup

Navigating this section

Role of the core

Security considerations

Chat history compression

Model fallback

File discovery service

Memory discovery service

Citations

Manual Setup

Configuration

What are subagents?

How to use subagents

Built-in subagents

Creating custom subagents

Subagent tool isolation

Policy Engine

Managing subagents

Remote subagents (Agent2Agent)

Extension subagents

Disabling subagents

Choose your path

Manage extensions

Installation

Manage extensions

Extension format

geminicli.com/extensions

settings.json file

Variables

ADK Samples (Python)

ADK Python Contributing Samples

Proxy support

Defining remote subagents

Authentication

Managing Subagents

Disabling remote agents

Development

Security

Release

Test and verify

Troubleshooting

List your extension in the gallery

Release through a Git repository

Release through GitHub Releases

Migrate an extension repository

How updates work

Choose your authentication method <a id="auth-methods"></a>

(Recommended) Sign in with Google <a id="login-google"></a>

Use Gemini API key <a id="gemini-api"></a>

Use Vertex AI <a id="vertex-ai"></a>

Set your Google Cloud project <a id="set-gcp"></a>

Persisting environment variables <a id="persisting-vars"></a>

Running in Google Cloud environments <a id="cloud-env"></a>

Running in headless mode <a id="headless"></a>

Use Gemini API Key

Vertex AI

What's next?

Gemini CLI: Quotas and Pricing

Gemini CLI: Terms of Service and Privacy Notice

Prerequisites

Extension features

Step 1: Create a new extension

Step 2: Understand the extension files

Step 3: Add extension settings

Step 4: Link your extension

Step 5: Add a custom command

Step 6: Add a custom GEMINI.md

(Optional) Step 7: Add an Agent Skill

Step 8: Release your extension

Next steps

Extension reference

Best practices

How to get started with Gemini 3 on Gemini CLI

How to enable Gemini 3 with Gemini CLI on Gemini Code Assist

Next steps

Recommended system specifications

Gemini Code Assist supported locations

Install Gemini CLI

Run Gemini CLI

Releases

What are hooks?

Core concepts

Configuration

Security and risks

Managing hooks

Quickstart: Install, authenticate, configure, and use Gemini CLI

Install

Authenticate

Configure

Use

Check usage and quota

Next steps

File management

Shell commands

Global hook mechanics

Configuration schema

Base input schema

Common output fields

Tool hooks

Tools Reference

Agent hooks

Model hooks

Lifecycle & system hooks

Stable Model API

VS Code companion extension

VS Code Marketplace

Open VSX Registry

Agent Client Protocol (ACP)

Using with sandboxing

Troubleshooting

I. The communication interface

II. The context interface

III. The diffing interface

IV. The lifecycle interface

Prerequisites

Quick start

Exit Code Strategies

Practical examples

Complete example: Smart Development Workflow Assistant

Packaging as an extension

Performance

Debugging

Development

Hook security

Troubleshooting

Authoring secure hooks

Privacy considerations

Description

Usage

Behavior

Next steps

Use Agent Skills

Build agent skills

ask_user (Ask User)

Usage Examples

Technical reference

Next steps

File management tutorial

Trusted folders

Description

Usage

Behavior

Next steps

Command reference

Configuration guide

1. list_mcp_resources (ListMcpResources)

2. read_mcp_resource (ReadMcpResource)

Technical reference

Technical behavior

Use cases

Next steps

Memory management guide

Project context (GEMINI.md)

1. enter_plan_mode (EnterPlanMode)

2. exit_plan_mode (ExitPlanMode)

What is an MCP server?

Core integration architecture

Working with MCP resources

How to set up your MCP server

Discovery process deep dive

Tool execution flow

How to interact with your MCP server

Status monitoring and troubleshooting

Important notes

Security and environment sanitization

Returning rich content from tools

MCP prompts as slash commands

Managing MCP servers with gemini mcp

Troubleshooting and Diagnostics

Instructions

Technical reference

Configuration

Interactive commands

Important notes

Environment variables

Command restrictions

Policy Engine

Use cases

Next steps

Shell commands tutorial

Sandboxing

Technical reference

Technical behavior

Use cases

Next steps

Task planning tutorial

Session management

Technical reference

Technical behavior

Use cases

Next steps

Task planning tutorial

Session management

Technical reference

Technical behavior

Plan Mode

Use cases

Next steps

Web tools guide

Web search tool reference

Slash commands (/)

Gemini CLI Extensions

Checkpointing documentation

Session Management

settings documentation

Input prompt shortcuts

At commands (@)

Shell mode and passthrough commands (!)

Technical reference

Technical behavior

Use cases

Next steps

Web tools guide

Web fetch tool reference

Configuration layers

Settings files

Custom sandbox profiles

Shell history

Environment variables and .env files

Command-line arguments

Context files (hierarchical instructional context)

Memory Import Processor documentation

Sandboxing

Usage statistics

Customizing Keybindings

Additional context-specific shortcuts

collaboratively edit or comment

Vi mode shortcuts

Limitations

Windows Terminal

Terminal

Overview

Syntax

Supported path formats

Examples

Safety features

Error handling

Code region detection

Import tree structure

Comparison to Claude Code's /memory (claude.md) approach

API reference

Best Practices

Troubleshooting

How to use Gemini CLI's tools

Sandboxing

Trusted folders

How to manage tools

Available tools

Under the hood

Next steps

Set up an MCP server

Agent Skills

Command reference

Quick start

Core concepts

Customizing Plan Mode Policies

Rule matching

Configuration

TOML rule schema

Default policies

General issues

Installation and updates

Platform-specific issues

Configuration

Google AI Pro/Ultra and subscription FAQs

Not seeing your question?

Overview

Free usage

Paid tier: Higher limits for a fixed cost

the Google One page

Pay as you go

Gemini for workspace plans

Check usage and limits

Tips to avoid high costs

Supported authentication methods

1. If you have signed in with your Google account to Gemini Code Assist

Gemini Code Assist for individuals Privacy Notice

Google Privacy Policy*

Google Cloud Privacy Notice

2. If you have signed in with a Gemini API key to the Gemini Developer API

Gemini API Terms of Service

Google Privacy Policy

3. If you have signed in with a Gemini API key to the Vertex AI GenAI API

Google Cloud Platform Service Terms

Google Cloud Privacy Notice

Usage statistics opt-out

Authentication or login errors

Common error messages and solutions

Exit codes

Debugging tips

Existing GitHub issues similar to yours or creating new issues

Method 1: Using npx

Method 2: Using npm (global install)

Method 3: Homebrew

Method 4: MacPorts

Prerequisites

Why headless mode?

How to use headless mode

How to pipe input to Gemini CLI

Use Gemini CLI output in scripts

Extract structured JSON data

Build your own custom AI tools

Next steps

Headless mode reference

Shell commands

Prerequisites

How to prepare your credentials

How to configure Gemini CLI

How to verify the connection

How to use the new tools

Troubleshooting

Next steps

MCP servers reference

official MCP server list

Prerequisites

Why manage context?

How to define project-wide rules (GEMINI.md)

How to teach the agent facts (Memory)

How to manage and inspect context

Best practices

Next steps

Session management

Command reference

Project context

Auto Memory

Prerequisites

Providing context by reading files

How to find files (Exploration)

How to modify code

Review and confirm changes

Verify the result

Advanced: Controlling what Gemini sees

Next steps

Manage context and memory

Execute shell commands

File system reference

Prerequisites

How to resume where you left off

How to manage your workspace

How to rewind time (Undo mistakes)

How to fork conversations

Next steps

Checkpointing

Task planning

Command reference

Prerequisites

Plan Mode

Model steering

Why combine Plan Mode and model steering?

Step 1: Start a complex task

Step 2: Steer the research phase

Step 3: Refine the design mid-turn

Step 4: Approve and implement

Tips for effective steering

Next steps

Agent Skills

Model steering reference

Prerequisites

How to run commands directly (!)

How to automate complex tasks

How to manage background processes

How to handle interactive commands

Safety features

Next steps

Sandboxing

Shell tool reference

Task planning

Create your first skill

Verify discovery

How to use the skill

Pro tip: Use the skill-creator

Manage skills

Next steps

Creating Agent Skills

Using Agent Skills

Skill best practices

Prerequisites

Why use task planning?

How to ask for a plan

How to review and iterate

How to execute the plan

How to monitor progress (Ctrl+T)

How to handle unexpected changes

Next steps

Session management

Todo tool reference

Memory management

Prerequisites

How to research new technologies

How to fetch deep context

How to apply knowledge to code

How to troubleshoot errors

Next steps

File management

Web search tool reference

Web fetch tool reference

## What is Gemini CLI Documentation's llms.txt?

Gemini CLI Documentation publishes an `/llms.txt` file that provides AI systems with a structured index of its documentation. It follows the [llms.txt specification](https://llmstxt.org), organizing links to guides, API references, and tutorials under section headings so that LLMs like ChatGPT, Claude, and Gemini can quickly understand what Gemini CLI Documentation offers and where to find details.

Issues

Spec

548

Sections

298

Links

919.6 KB

Size

~235.3k

Tokens

Sections: Guiding principle: Issues and pull requests · Detailed automation workflows · Current releases · Announcements: v0.50.0 - 2026-07-08 · Announcements: v0.45.0 - 2026-06-03 · Announcements: v0.44.0 - 2026-05-27 · and 542 more

## Add Gemini CLI Documentation Docs to Your AI Assistant

Select your tool to see how to add Gemini CLI Documentation's llms.txt as a documentation source.

Cursor

 Windsurf

 Claude Code

 ChatGPT

 Zed

 Copilot

1. 1

   Open any chat or composer panel
2. 2

   Type @Docs and select "Add new doc"
3. 3

   Paste the URL: https://geminicli.com/llms.txt
4. 4

   Wait for the green dot (indexing complete)
5. 5

   Reference @Docs in chat when asking about Gemini CLI Documentation

Cursor crawls the URL and indexes all subpages. Add a trailing slash to index child pages too.

## Spec Compliance 857 errors

## Frequently Asked Questions

Where is Gemini CLI Documentation's llms.txt file?

Gemini CLI Documentation publishes its llms.txt at https://geminicli.com/llms.txt. This file provides a structured, markdown-formatted index of Gemini CLI Documentation's documentation that AI systems can consume to understand the project's APIs, guides, and references.

How do I use Gemini CLI Documentation's llms.txt with AI coding assistants?

Copy the llms.txt content and paste it into your AI assistant (Cursor, Windsurf, Claude, ChatGPT) as context. This gives the AI an accurate map of Gemini CLI Documentation's documentation so it can provide better code suggestions and answers about Gemini CLI Documentation.

What does Gemini CLI Documentation's llms.txt contain?

Gemini CLI Documentation's llms.txt contains 548 sections and 298 documentation links in 919.6 KB (~235.3k tokens). Key sections include Guiding principle: Issues and pull requests, Detailed automation workflows, Current releases, Announcements: v0.50.0 - 2026-07-08, Announcements: v0.45.0 - 2026-06-03, Announcements: v0.44.0 - 2026-05-27.

How many tokens does Gemini CLI Documentation's llms.txt use?

The concise llms.txt index is approximately 235.3k tokens (919.6 KB). Most AI assistants can fit this within their context window. For the full expanded documentation, look for an llms-full.txt variant which embeds all content inline.

What is Gemini CLI Documentation?

[!NOTE]. Gemini CLI Documentation's llms.txt file helps AI systems understand this by providing a structured overview of its documentation, making it easier for developers to get accurate AI-assisted help when working with Gemini CLI Documentation.

Can I generate an llms.txt for my own project?

Yes. Use the free llms.txt generator at mdream.dev/tools/llms-txt/generator to crawl your site and produce a spec-compliant llms.txt file. You can also validate existing files with the llms.txt validator.

## Browse More llms.txt Files

[Ri Xu Online Change the life in a geek way](https://mdream.dev/llms-txt/gemini-cli/llms-txt/excelize) [Daytona Documentation v0.0.0-dev Secure and Elastic Infrastructure for Running Your Al-Generated Code.](https://mdream.dev/llms-txt/gemini-cli/llms-txt/daytona) [Documentation Automated auditing, performance metrics, and best practices for the web.](https://mdream.dev/llms-txt/gemini-cli/llms-txt/lighthouse) [Documentation Generated documentation](https://mdream.dev/llms-txt/gemini-cli/llms-txt/chat2db) [Kilo Code Documentation**Note:** Skip labels and required labels are also excluded from the set of labels the AI can apply. This keeps gating labels strictly under your control.](https://mdream.dev/llms-txt/gemini-cli/llms-txt/kilocode) [Twilio Documentation Reference documentation for all Twilio products. Code snippets, tutorials, and sample apps for common use cases and communications solutions.](https://mdream.dev/llms-txt/gemini-cli/llms-txt/twilio) [Apify Documentation The entire content of Apify documentation is available in a single Markdown file at https://docs.apify.com/llms-full.txt](https://mdream.dev/llms-txt/gemini-cli/llms-txt/apify) [learning](https://mdream.dev/llms-txt/gemini-cli/llms-txt/learning)

[View all 99 projects ](https://mdream.dev/llms-txt/gemini-cli/llms-txt)

## Related Tools

[<h3>llms.txt Generator</h3>Generate an llms.txt for your own project.](https://mdream.dev/llms-txt/gemini-cli/tools/llms-txt/generator) [<h3>llms.txt Validator</h3>Validate your llms.txt against the official spec.](https://mdream.dev/llms-txt/gemini-cli/tools/llms-txt/validator)

© 2026 [Harlan Wilton](https://github.com/harlan-zw) · [MIT](https://github.com/harlan-zw/mdream/blob/main/license)

[GitHub](https://github.com/harlan-zw/mdream) [Discord](https://discord.com/invite/275MBUBvgP)