llms.txt Guiding principle: Issues and pull requests
Detailed automation workflows
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
pic 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 Level 1: Automated gates (must pass)
Level 2: Manual verification and dogfooding
Level 3: Telemetry and data review
What's Changed
#25466 #24454 #22759 #24437 #24456 #24286 #24439 #24453 #24342 #24479 #24460 #24485 #24474 #24487 #24274 #23937 #24490 #24449 #24504 #24498 #24469 #23799 #24463 #24523 #24502 #24483 #24445 #24514 #24540 #22423 #24542 #24545 #21960 #24464 #23257 #24559 #22987 #19739 #24206 #24558 #24568 #24145 #24565 #24573 #24512 #24575 #24571 #24590 #24582 #24210 #24476 #24609 #24613 #24510 #24620 #24480 #24577 #21992 #24621 #24650 #24640 #24638 #24646 #24655 #24376 #24649 #24659 #24623 #24756 #24759 #22326 #24635 #24652 #24753 #24777 #24762 #24767 #24566 #24457 #24771 #24688 #24793 #24786 #24837 #24645 #24616 #24784 #24846 #24823 #24843 #24839 #24852 #24550 #24275 #24261 #24857 #24801 #24287 #24848 #24774 #24859 #24870 #24873 #24861 #24794 #24844 What's Changed
#24849 #24876 #24544 #24939 #24763 #24934 #24938 #22128 #24940 #24946 #24951 #21447 #21897 #24834 #24974 #24903 #24972 #24980 #24941 #24667 #24984 #24677 #25000 #24985 #25035 #24489 #19775 #24773 #22621 #24567 #24292 #25037 #25053 #25057 #25048 #24297 #23749 #24968 #25040 #24983 #25066 #25055 #23341 #22755 #25088 #25049 #15816 #25061 #25094 #25092 #25125 #25101 #25062 #25113 #21679 #25114 #22624 #25059 #25079 #25140 #25077 #25143 #21636 #25153 #25142 #24945 #25089 #25121 #23087 #25148 #25073 #25304 #24959 #25305 #24447 #25297 #25134 #25320 #24770 #25296 #25317 #24896 #25333 #24752 #25325 #25381 #25058 #25307 #25398 #25392 #24630 #25282 #25389 #25413 #25336 Admin Controls vs. System Settings
Agent Client Protocol (ACP)
Architecture and protocol basics
Capabilities and supported methods
How to enable Auto Memory
How to review extracted skills
How to disable Auto Memory
Next steps
Agent Skills memory management tutorial Settings Getting started: The skill-creator skill
Local testing and validation: Changes to the packaging and publishing process
Using the /restore command
File locations and precedence
Example: A "Pure Function" refactoring command
Code contribution process
GEMINI.md Documentation contribution process
FAQ an issue Running a specific set of tests
Performance regression tests
Centralized configuration: The system settings file
User isolation in shared environments
Managing custom tools (MCP servers)
Enforcing sandboxing for security
Controlling network access via proxy
Putting it all together: example system settings.json
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 How to enable Git worktrees
How to exit a Git worktree session
Resuming work in a Git worktree
Managing Git worktrees manually
Next steps
Automation tutorial CLI reference 2. Configuration Primitives
4. Configuration Reference
How to use the /model command
Best practices for model selection
Next steps
Plan Mode settings Next steps
Plan Mode Agent Skills Tool Restrictions
glob get_internal_docs cli_help ask_user MCP resource tools custom plans directory save_memory activate_skill Customization and best practices
Planning workflows
enter_plan_mode ask_user custom plan directory and policies exit_plan_mode exit_plan_mode custom policies Non-interactive execution
YOLO mode Related documentation
Configuration Commands Troubleshooting Parallel sessions with Git worktrees
Next steps
Memory tool Checkpoint CLI reference Export the default prompt (recommended)
Best practices: SYSTEM.md vs GEMINI.md
OpenTelemetry integration
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 Logs, metrics, and traces
Custom color themes
configuration precedence How it works: The trust dialog
Understanding folder contents: The discovery phase
Why trust matters: The impact of an untrusted workspace
Managing your trust settings
The trust check process (advanced)
Configuration
ADK Samples (Python) ADK Python Contributing Samples Defining remote subagents
Creating custom subagents
Subagent tool isolation
Policy Engine Remote subagents (Agent2Agent)
Extension format
geminicli.com/extensions settings.json file List your extension in the gallery
Release through a Git repository
Release through GitHub Releases
Migrating an Extension Repository
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 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 How to get started with Gemini 3 on Gemini CLI
How to enable Gemini 3 with Gemini CLI on Gemini Code Assist
Recommended system specifications
Gemini Code Assist supported locations Slash commands (/)
Gemini CLI Extensions Checkpointing documentation Session Management settings documentation Shell mode and passthrough commands (!)
Quickstart: Install, authenticate, configure, and use Gemini CLI
Next steps
File management Shell commands Tool hooks
Tools Reference VS Code companion extension
VS Code Marketplace Open VSX Registry Agent Client Protocol (ACP)
I. The communication interface
II. The context interface
III. The diffing interface
IV. The lifecycle interface
Complete example: Smart Development Workflow Assistant
Packaging as an extension
Settings files
Custom sandbox profiles Environment variables and .env files
Context files (hierarchical instructional context)
Memory Import Processor documentation Additional context-specific shortcuts
collaboratively edit or comment Limitations
Windows Terminal Terminal Comparison to Claude Code's /memory (claude.md) approach
Core concepts
Customizing Plan Mode Policies Configuration
TOML rule schema How to use Gemini CLI's tools
Sandboxing Trusted folders Next steps
Set up an MCP server Agent Skills Command reference Google AI Pro/Ultra and subscription FAQs
Not seeing your question?
Paid tier: Higher limits for a fixed cost
the Google One page Gemini for workspace plans
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 Method 2: Using npm (global install)
Authentication or login errors
Common error messages and solutions
Existing GitHub issues similar to yours or creating new issues
Next steps
Use Agent Skills Creating Agent Skills Next steps
File management tutorial Trusted folders Next steps
Command reference Configuration guide Core integration architecture
Working with MCP resources
How to set up your MCP server
Discovery process deep dive
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
1. enter_plan_mode (EnterPlanMode)
2. exit_plan_mode (ExitPlanMode)
1. list_mcp_resources (ListMcpResources)
2. read_mcp_resource (ReadMcpResource)
Next steps
Memory management guide Project context (GEMINI.md) Command restrictions
Policy Engine Next steps
Shell commands tutorial Sandboxing Next steps
Task planning tutorial Session management Technical behavior
Plan Mode Next steps
Web tools guide Web search tool reference Next steps
Web tools guide Web fetch tool reference 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 Providing context by reading files
How to find files (Exploration)
Review and confirm changes
Advanced: Controlling what Gemini sees
Next steps
Manage context and memory Execute shell commands File system 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 How to define project-wide rules (GEMINI.md)
How to teach the agent facts (Memory)
How to manage and inspect context
Next steps
Session management Command reference Project context Auto Memory How to run commands directly (!)
How to automate complex tasks
How to manage background processes
How to handle interactive commands
Next steps
Sandboxing Shell tool reference Task planning 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 How to prepare your credentials
How to configure Gemini CLI
How to verify the connection
Next steps
MCP servers reference official MCP server list Next steps
Agent Skills Authoring Guide Extensions How to review and iterate
How to monitor progress (Ctrl+T)
How to handle unexpected changes
Next steps
Session management Todo tool reference Memory management 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