PageSourceSearch

https://geminicli.com/docs/

html geminicli.com collected 2026-09-24 08:55:18 UTC 111,124 bytes, 313 lines download raw bytes

1<!DOCTYPE html><html lang="en" dir="ltr" data-theme="dark" data-has-toc data-has-sidebar class="astro-bguv2lll"> <head><meta charset="utf-8"/><meta name="viewport" content="width=device-width, initial-scale=1"/><title>Gemini CLI documentation | Gemini CLI</title><link rel="canonical" href="https://geminicli.com/docs/"/><link rel="sitemap" href="/sitemap-index.xml"/><link href="https://fonts.gstatic.com" rel="preconnect" crossorigin="true"/><link href="https://fonts.googleapis.com/css2?family=Google+Sans:wght@400;500;700&display=block" rel="stylesheet"/><link href="https://fonts.googleapis.com/css2?family=Google+Sans+Text:wght@400;500&display=block" rel="stylesheet"/><link href="https://fonts.googleapis.com/css2?family=Google+Sans+Mono:wght@400;500&display=block" rel="stylesheet"/><link href="https://fonts.googleapis.com/css2?family=Google+Symbols&family=Material+Symbols+Outlined:opsz,wght,FILL,[email protected],100..700,0..1,-50..200&display=block" rel="stylesheet"/><link rel="icon" href="/favicon.ico" sizes="32x32"/>
vendor: 63 bytes, line 1
1<script async src="https://www.googletagmanager.com/gtag/js?id=
1G-66QE907DJT
vendor: 11 bytes, line 1
1"></script>
1<script>
vendor: 142 bytes, lines 1-6
1window.dataLayer = window.dataLayer || [];
2  function gtag() {
3    dataLayer.push(arguments);
4  }
5  gtag("js", new Date());
6  gtag("config", "
6G-66QE907DJT
vendor: 3 bytes, line 6
6");
6</script>
6<link rel="shortcut icon" href="/icon.png" type="image/png"/><meta name="generator" content="Astro v5.16.16"/><meta name="generator" content="Starlight v0.36.1"/><meta property="og:title" content="Gemini CLI documentation"/><meta property="og:type" content="article"/><meta property="og:url" content="https://geminicli.com/docs/"/><meta property="og:locale" content="en"/><meta property="og:description"/><meta property="og:site_name" content="Gemini CLI"/><meta name="twitter:card" content="summary_large_image"/><meta property="og:image" content="https://geminicli.com/assets/social-poster.png"/><meta name="twitter:image" content="https://geminicli.com/assets/social-poster.png"/>
6<script>
7	window.StarlightThemeProvider = (() => {
8		const storedTheme =
9			typeof localStorage !== 'undefined' && localStorage.getItem('starlight-theme');
10		const theme =
11			storedTheme ||
12			(window.matchMedia('(prefers-color-scheme: light)').matches ? 'light' : 'dark');
13		document.documentElement.dataset.theme = theme === 'light' ? 'light' : 'dark';
14		return {
15			updatePickers(theme = storedTheme || 'auto') {
16				document.querySelectorAll('starlight-theme-select').forEach((picker) => {
17					const select = picker.querySelector('select');
18					if (select) select.value = theme;
19					/** @type {HTMLTemplateElement | null} */
20					const tmpl = document.querySelector(`#theme-icons`);
21					const newIcon = tmpl && tmpl.content.querySelector('.' + theme);
22					if (newIcon) {
23						const oldIcon = picker.querySelector('svg.label-icon');
24						if (oldIcon) {
25							oldIcon.replaceChildren(...newIcon.cloneNode(true).childNodes);
26						}
27					}
28				});
29			},
30		};
31	})();
32</script>
32<template id="theme-icons"><svg aria-hidden="true" class="light astro-c6vsoqas" width="16" height="16" viewBox="0 0 24 24" fill="currentColor" style="--sl-icon-size: 1em;"><path d="M5 12a1 1 0 0 0-1-1H3a1 1 0 0 0 0 2h1a1 1 0 0 0 1-1Zm.64 5-.71.71a1 1 0 0 0 0 1.41 1 1 0 0 0 1.41 0l.71-.71A1 1 0 0 0 5.64 17ZM12 5a1 1 0 0 0 1-1V3a1 1 0 0 0-2 0v1a1 1 0 0 0 1 1Zm5.66 2.34a1 1 0 0 0 .7-.29l.71-.71a1 1 0 1 0-1.41-1.41l-.66.71a1 1 0 0 0 0 1.41 1 1 0 0 0 .66.29Zm-12-.29a1 1 0 0 0 1.41 0 1 1 0 0 0 0-1.41l-.71-.71a1.004 1.004 0 1 0-1.43 1.41l.73.71ZM21 11h-1a1 1 0 0 0 0 2h1a1 1 0 0 0 0-2Zm-2.64 6A1 1 0 0 0 17 18.36l.71.71a1 1 0 0 0 1.41 0 1 1 0 0 0 0-1.41l-.76-.66ZM12 6.5a5.5 5.5 0 1 0 5.5 5.5A5.51 5.51 0 0 0 12 6.5Zm0 9a3.5 3.5 0 1 1 0-7 3.5 3.5 0 0 1 0 7Zm0 3.5a1 1 0 0 0-1 1v1a1 1 0 0 0 2 0v-1a1 1 0 0 0-1-1Z"/></svg><svg aria-hidden="true" class="dark astro-c6vsoqas" width="16" height="16" viewBox="0 0 24 24" fill="currentColor" style="--sl-icon-size: 1em;"><path d="M21.64 13a1 1 0 0 0-1.05-.14 8.049 8.049 0 0 1-3.37.73 8.15 8.15 0 0 1-8.14-8.1 8.59 8.59 0 0 1 .25-2A1 1 0 0 0 8 2.36a10.14 10.14 0 1 0 14 11.69 1 1 0 0 0-.36-1.05Zm-9.5 6.69A8.14 8.14 0 0 1 7.08 5.22v.27a10.15 10.15 0 0 0 10.14 10.14 9.784 9.784 0 0 0 2.1-.22 8.11 8.11 0 0 1-7.18 4.32v-.04Z"/></svg><svg aria-hidden="true" class="auto astro-c6vsoqas" width="16" height="16" viewBox="0 0 24 24" fill="currentColor" style="--sl-icon-size: 1em;"><path d="M21 14h-1V7a3 3 0 0 0-3-3H7a3 3 0 0 0-3 3v7H3a1 1 0 0 0-1 1v2a3 3 0 0 0 3 3h14a3 3 0 0 0 3-3v-2a1 1 0 0 0-1-1ZM6 7a1 1 0 0 1 1-1h10a1 1 0 0 1 1 1v7H6V7Zm14 10a1 1 0 0 1-1 1H5a1 1 0 0 1-1-1v-1h16v1Z"/></svg></template><link rel="stylesheet" href="/_astro/print.DNXP8c50.css" media="print"><link rel="stylesheet" href="/_astro/brand-kit.BB_IM0Gj.css">
33<style>@layer starlight.components{:root{--sl-badge-default-border: var(--sl-color-accent);--sl-badge-default-bg: var(--sl-color-accent-low);--sl-badge-default-text: #fff;--sl-badge-note-border: var(--sl-color-blue);--sl-badge-note-bg: var(--sl-color-blue-low);--sl-badge-note-text: #fff;--sl-badge-danger-border: var(--sl-color-red);--sl-badge-danger-bg: var(--sl-color-red-low);--sl-badge-danger-text: #fff;--sl-badge-success-border: var(--sl-color-green);--sl-badge-success-bg: var(--sl-color-green-low);--sl-badge-success-text: #fff;--sl-badge-caution-border: var(--sl-color-orange);--sl-badge-caution-bg: var(--sl-color-orange-low);--sl-badge-caution-text: #fff;--sl-badge-tip-border: var(--sl-color-purple);--sl-badge-tip-bg: var(--sl-color-purple-low);--sl-badge-tip-text: #fff}[data-theme=light]:root{--sl-badge-default-bg: var(--sl-color-accent-high);--sl-badge-note-bg: var(--sl-color-blue-high);--sl-badge-danger-bg: var(--sl-color-red-high);--sl-badge-success-bg: var(--sl-color-green-high);--sl-badge-caution-bg: var(--sl-color-orange-high);--sl-badge-tip-bg: var(--sl-color-purple-high)}.sl-badge:where(.astro-avdet4wd){display:inline-block;border:1px solid var(--sl-color-border-badge);border-radius:.25rem;font-family:var(--sl-font-system-mono);line-height:normal;color:var(--sl-color-text-badge);background-color:var(--sl-color-bg-badge);overflow-wrap:anywhere}.sidebar-content .sl-badge:where(.astro-avdet4wd){line-height:1;font-size:var(--sl-text-xs);padding:.125rem .375rem}.sidebar-content a[aria-current=page]>.sl-badge:where(.astro-avdet4wd){--sl-color-bg-badge: transparent;--sl-color-border-badge: currentColor;color:inherit}.default:where(.astro-avdet4wd){--sl-color-bg-badge: var(--sl-badge-default-bg);--sl-color-border-badge: var(--sl-badge-default-border);--sl-color-text-badge: var(--sl-badge-default-text)}.note:where(.astro-avdet4wd){--sl-color-bg-badge: var(--sl-badge-note-bg);--sl-color-border-badge: var(--sl-badge-note-border);--sl-color-text-badge: var(--sl-badge-note-text)}.danger:where(.astro-avdet4wd){--sl-color-bg-badge: var(--sl-badge-danger-bg);--sl-color-border-badge: var(--sl-badge-danger-border);--sl-color-text-badge: var(--sl-badge-danger-text)}.success:where(.astro-avdet4wd){--sl-color-bg-badge: var(--sl-badge-success-bg);--sl-color-border-badge: var(--sl-badge-success-border);--sl-color-text-badge: var(--sl-badge-success-text)}.tip:where(.astro-avdet4wd){--sl-color-bg-badge: var(--sl-badge-tip-bg);--sl-color-border-badge: var(--sl-badge-tip-border);--sl-color-text-badge: var(--sl-badge-tip-text)}.caution:where(.astro-avdet4wd){--sl-color-bg-badge: var(--sl-badge-caution-bg);--sl-color-border-badge: var(--sl-badge-caution-border);--sl-color-text-badge: var(--sl-badge-caution-text)}.small:where(.astro-avdet4wd){font-size:var(--sl-text-xs);padding:.125rem .25rem}.medium:where(.astro-avdet4wd){font-size:var(--sl-text-sm);padding:.175rem .35rem}.large:where(.astro-avdet4wd){font-size:var(--sl-text-base);padding:.225rem .45rem}.sl-markdown-content :is(h1,h2,h3,h4,h5,h6) .sl-badge:where(.astro-avdet4wd){vertical-align:middle}}
34@layer starlight.components{svg:where(.astro-c6vsoqas){color:var(--sl-icon-color);font-size:var(--sl-icon-size, 1em);width:1em;height:1em}}
35@layer starlight.components{starlight-tabs:where(.astro-esqgolmp){display:block}.tablist-wrapper:where(.astro-esqgolmp){overflow-x:auto}:where(.astro-esqgolmp)[role=tablist]{display:flex;list-style:none;border-bottom:2px solid var(--sl-color-gray-5);padding:0}.tab:where(.astro-esqgolmp){display:flex;margin-bottom:-2px}.tab:where(.astro-esqgolmp)>:where(.astro-esqgolmp)[role=tab]{display:flex;align-items:center;gap:.5rem;line-height:var(--sl-line-height-headings);padding:.275rem 1.25rem;text-decoration:none;border-bottom:2px solid var(--sl-color-gray-5);color:var(--sl-color-gray-3);outline-offset:var(--sl-outline-offset-inside);overflow-wrap:initial}.tab:where(.astro-esqgolmp) :where(.astro-esqgolmp)[role=tab][aria-selected=true]{color:var(--sl-color-white);border-color:var(--sl-color-text-accent);font-weight:600}.tablist-wrapper:where(.astro-esqgolmp)~[role=tabpanel]{margin-top:1rem}}
36@layer starlight.components{.sl-steps{--bullet-size: calc(var(--sl-line-height) * 1rem);--bullet-margin: .375rem;list-style:none;counter-reset:steps-counter var(--sl-steps-start, 0);padding-inline-start:0}.sl-steps>li{counter-increment:steps-counter;position:relative;padding-inline-start:calc(var(--bullet-size) + 1rem);padding-bottom:1px;min-height:calc(var(--bullet-size) + var(--bullet-margin))}.sl-steps>li+li{margin-top:0}.sl-steps>li:before{content:counter(steps-counter);position:absolute;top:0;inset-inline-start:0;width:var(--bullet-size);height:var(--bullet-size);line-height:var(--bullet-size);font-size:var(--sl-text-xs);font-weight:600;text-align:center;color:var(--sl-color-white);background-color:var(--sl-color-gray-6);border-radius:99rem;box-shadow:inset 0 0 0 1px var(--sl-color-gray-5)}.sl-steps>li:after{--guide-width: 1px;content:"";position:absolute;top:calc(var(--bullet-size) + var(--bullet-margin));bottom:var(--bullet-margin);inset-inline-start:calc((var(--bullet-size) - var(--guide-width)) / 2);width:var(--guide-width);background-color:var(--sl-color-hairline-light)}}@layer starlight.content{.sl-steps>li>:first-child{--lh: calc(1em * var(--sl-line-height));--shift-y: calc(.5 * (var(--bullet-size) - var(--lh)));
36transform:translateY(var(--shift-y));margin-bottom:var(--shift-y)}.sl-steps>li>:first-child:where(h1,h2,h3,h4,h5,h6){--lh: calc(1em * var(--sl-line-height-headings))}@supports (--prop: 1lh){.sl-steps>li>:first-child{--lh: 1lh}}}
37</style>
37<script type="module" src="/_astro/page.B1D-nYk3.js"></script>
37</head> <body class="astro-bguv2lll"> <a href="#_top" class="astro-7q3lir66">Skip to content</a>  <div class="page sl-flex astro-yriad4ts"> <div class="announcement-banner astro-yriad4ts">
38Unpaid tier and Google One users: Gemini CLI was replaced by Antigravity
39    CLI on June 18th, 2026. To learn more, see our <a href="https://developers.googleblog.com/an-important-update-transitioning-gemini-cli-to-antigravity-cli" class="astro-yriad4ts">blog post</a>.
40</div> <header class="header astro-yriad4ts"><div id="page-header" class="header astro-3ef6ksr2"> <div class="title-wrapper sl-flex items-center gap-4 astro-3ef6ksr2"> <div class="mobile-only mobile-menu-wrapper astro-3ef6ksr2"> <starlight-menu-button class="print:hidden astro-jif73yzw"> <button aria-expanded="false" aria-label="Menu" aria-controls="starlight__sidebar" class="sl-flex md:sl-hidden astro-jif73yzw"> <svg aria-hidden="true" class="open-menu astro-jif73yzw astro-c6vsoqas" width="16" height="16" viewBox="0 0 24 24" fill="currentColor" style="--sl-icon-size: 1em;"><path d="M3 8h18a1 1 0 1 0 0-2H3a1 1 0 0 0 0 2Zm18 8H3a1 1 0 0 0 0 2h18a1 1 0 0 0 0-2Zm0-5H3a1 1 0 0 0 0 2h18a1 1 0 0 0 0-2Z"/></svg> <svg aria-hidden="true" class="close-menu astro-jif73yzw astro-c6vsoqas" width="16" height="16" viewBox="0 0 24 24" fill="currentColor" style="--sl-icon-size: 1em;"><path d="m13.41 12 6.3-6.29a1.004 1.004 0 1 0-1.42-1.42L12 10.59l-6.29-6.3a1.004 1.004 0 0 0-1.42 1.42l6.3 6.29-6.3 6.29a1 1 0 0 0 0 1.42.998.998 0 0 0 1.42 0l6.29-6.3 6.29 6.3a.999.999 0 0 0 1.42 0 1 1 0 0 0 0-1.42L13.41 12Z"/></svg> </button> </starlight-menu-button> 
40<script type="module">class s extends HTMLElement{constructor(){super(),this.btn=this.querySelector("button"),this.btn.addEventListener("click",()=>this.toggleExpanded());const t=this.closest("nav");t&&t.addEventListener("keyup",e=>this.closeOnEscape(e))}setExpanded(t){this.setAttribute("aria-expanded",String(t)),document.body.toggleAttribute("data-mobile-menu-expanded",t)}toggleExpanded(){this.setExpanded(this.getAttribute("aria-expanded")!=="true")}closeOnEscape(t){t.code==="Escape"&&(this.setExpanded(!1),this.btn.focus())}}customElements.define("starlight-menu-button",s);</script>
40   </div> 
40<script type="module">function u(){document.querySelectorAll(".has-submenu").forEach(t=>{const e=t.querySelector("details");if(!e)return;const n=window.matchMedia("(min-width: 1150px)");function s(){n.matches&&e&&e.setAttribute("open","true")}function o(){n.matches&&e&&e.removeAttribute("open")}t.addEventListener("mouseenter",s),t.addEventListener("mouseleave",o),document.addEventListener("keydown",i=>{i.key==="Escape"&&e.hasAttribute("open")&&o()})})}u();document.addEventListener("astro:page-load",u);</script>
40 <a href="/" class="site-title sl-flex astro-m46x6ez3">  <img class="astro-m46x6ez3" alt="Gemini CLI Icon" src="/_astro/icon.Bo4M5sF3.png" width="1645" height="1645">  <span class="astro-m46x6ez3" translate="no"> Gemini CLI </span> </a>  <div class="mobile-hide astro-3ef6ksr2"> <ul class="global-nav-list astro-jvd4jwbq"> <li class="mobile-only astro-jvd4jwbq"> <a href="/" class="no-underline astro-jvd4jwbq"> <span class="astro-jvd4jwbq">Home</span> </a> </li><li class=" astro-jvd4jwbq"> <a href="/plans/" class="no-underline astro-jvd4jwbq"> <span class="astro-jvd4jwbq">Plans</span> </a> </li><li class="has-submenu astro-jvd4jwbq"> <details class="astro-jvd4jwbq"> <summary class="astro-jvd4jwbq"> <span class="astro-jvd4jwbq">Extensions</span> <svg viewBox="0 0 24 24" width="20" height="20" class="caret astro-jvd4jwbq" fill="currentColor"> <path d="m14.83 11.29-4.24-4.24a1 1 0 1 0-1.42 1.41L12.71 12l-3.54 3.54a1 1 0 0 0 0 1.41 1 1 0 0 0 .71.29 1 1 0 0 0 .71-.29l4.24-4.24a1.002 1.002 0 0 0 0-1.42Z" class="astro-jvd4jwbq"></path> </svg> </summary> <ul class="submenu astro-jvd4jwbq"> <li class="astro-jvd4jwbq"> <a href="/extensions/" class="no-underline astro-jvd4jwbq"> <span class="astro-jvd4jwbq">Browse extensions</span> </a> </li><li class="astro-jvd4jwbq"> <a href="/extensions/about" class="no-underline astro-jvd4jwbq"> <span class="astro-jvd4jwbq">About Extensions</span> </a> </li> </ul> </details> </li><li class=" astro-jvd4jwbq"> <a href="/docs/" class="no-underline is-active astro-jvd4jwbq"> <span class="astro-jvd4jwbq">Docs</span> </a> </li><li class=" astro-jvd4jwbq"> <a href="/docs/reference/commands" class="no-underline astro-jvd4jwbq"> <span class="astro-jvd4jwbq">Reference</span> </a> </li><li class=" astro-jvd4jwbq"> <a href="/docs/resources/quota-and-pricing" class="no-underline astro-jvd4jwbq"> <span class="astro-jvd4jwbq">Resources</span> </a> </li><li class=" astro-jvd4jwbq"> <a href="/docs/changelogs/" class="no-underline astro-jvd4jwbq"> <span class="astro-jvd4jwbq">Changelog</span> </a> </li> </ul>   </div>  </div> <div class="sl-flex items-center gap-4 search-and-icons astro-3ef6ksr2"> <div class="sl-flex justify-end print:hidden search astro-3ef6ksr2"> <site-search class="astro-3ef6ksr2 astro-v37mnknz" data-translations="{&#34;placeholder&#34;:&#34;Search&#34;}"> <button data-open-modal disabled aria-label="Search" aria-keyshortcuts="Control+K" class="astro-v37mnknz"> <svg aria-hidden="true" class="astro-v37mnknz astro-c6vsoqas" width="16" height="16" viewBox="0 0 24 24" fill="currentColor" style="--sl-icon-size: 1em;"><path d="M21.71 20.29 18 16.61A9 9 0 1 0 16.61 18l3.68 3.68a.999.999 0 0 0 1.42 0 1 1 0 0 0 0-1.39ZM11 18a7 7 0 1 1 0-14 7 7 0 0 1 0 14Z"/></svg> <span class="sl-hidden md:sl-block astro-v37mnknz" aria-hidden="true">Search</span> <kbd class="sl-hidden md:sl-flex astro-v37mnknz" style="display: none;"> <kbd class="astro-v37mnknz">Ctrl</kbd><kbd class="astro-v37mnknz">K</kbd> </kbd> </button> <dialog style="padding:0" aria-label="Search" class="astro-v37mnknz"> <div class="dialog-frame sl-flex astro-v37mnknz">  <button data-close-modal class="sl-flex md:sl-hidden astro-v37mnknz"> Cancel </button> <div class="search-container astro-v37mnknz"> <div id="starlight__search" class="astro-v37mnknz"></div> </div> </div> </dialog> </site-search>  
40<script>
41	(() => {
42		const openBtn = document.querySelector('button[data-open-modal]');
43		const shortcut = openBtn?.querySelector('kbd');
44		if (!openBtn || !(shortcut instanceof HTMLElement)) return;
45		const platformKey = shortcut.querySelector('kbd');
46		if (platformKey && /(Mac|iPhone|iPod|iPad)/i.test(navigator.platform)) {
47			platformKey.textContent = '⌘';
48			openBtn.setAttribute('aria-keyshortcuts', 'Meta+K');
49		}
50		shortcut.style.display = '';
51	})();
52</script>
52 
52<script type="module" src="/_astro/Search.astro_astro_type_script_index_0_lang.cjYDvRdi.js"></script>
52   </div> <div class="sl-flex print:hidden right-group astro-3ef6ksr2"> <div class="sl-flex social-icons links astro-3ef6ksr2"> <a href="https://github.com/google-gemini/gemini-cli/issues/new?template=website_issue.yml&url=https%3A%2F%2Fgeminicli.com%2Fdocs%2F" target="_blank" rel="noopener noreferrer" class="feedback-link astro-3ef6ksr2"><svg xmlns="http://www.w3.org/2000/svg" height="24px" viewBox="0 0 24 24" width="24px" fill="currentColor" class="feedback-icon astro-3ef6ksr2" aria-hidden="true"> <path d="M0 0h24v24H0V0z" fill="none" class="astro-3ef6ksr2"></path> <path d="M20 2H4c-1.1 0-2 .9-2 2v18l4-4h14c1.1 0 2-.9 2-2V4c0-1.1-.9-2-2-2zm0 14H6l-2 2V4h16v12z" class="astro-3ef6ksr2"></path> <path d="M11 5h2v6h-2zm0 8h2v2h-2z" class="astro-3ef6ksr2"></path> </svg> <span class="feedback-label astro-3ef6ksr2">Feedback</span></a> <a href="https://github.com/google-gemini/gemini-cli" target="_blank" rel="noopener noreferrer" class="github-link astro-3ef6ksr2"> <span class="sr-only astro-3ef6ksr2">GitHub</span> <svg aria-hidden="true" width="16" height="16" viewBox="0 0 24 24" fill="currentColor" class="astro-3ef6ksr2"> <path d="M12 .3a12 12 0 0 0-3.8 23.38c.6.12.83-.26.83-.57L9 21.07c-3.34.72-4.04-1.61-4.04-1.61-.55-1.39-1.34-1.76-1.34-1.76-1.08-.74.09-.73.09-.73 1.2.09 1.83 1.24 1.83 1.24 1.08 1.83 2.81 1.3 3.5 1 .1-.78.42-1.31.76-1.61-2.67-.3-5.47-1.33-5.47-5.93 0-1.31.47-2.38 1.24-3.22-.14-.3-.54-1.52.1-3.18 0 0 1-.32 3.3 1.23a11.5 11.5 0 0 1 6 0c2.28-1.55 3.29-1.23 3.29-1.23.64 1.66.24 2.88.12 3.18a4.65 4.65 0 0 1 1.23 3.22c0 4.61-2.8 5.63-5.48 5.92.42.36.81 1.1.81 2.22l-.01 3.29c0 .31.2.69.82.57A12 12 0 0 0 12 .3Z" class="astro-3ef6ksr2"></path> </svg> <span class="github-label astro-3ef6ksr2">GitHub</span> </a> </div> <div class="select-group astro-3ef6ksr2"> <starlight-theme-select>  <label style="--sl-select-width: 6.25em" class="astro-4yphtoen"> <span class="sr-only astro-4yphtoen">Select theme</span> <svg aria-hidden="true" class="icon label-icon astro-4yphtoen astro-c6vsoqas" width="16" height="16" viewBox="0 0 24 24" fill="currentColor" style="--sl-icon-size: 1em;"><path d="M21 14h-1V7a3 3 0 0 0-3-3H7a3 3 0 0 0-3 3v7H3a1 1 0 0 0-1 1v2a3 3 0 0 0 3 3h14a3 3 0 0 0 3-3v-2a1 1 0 0 0-1-1ZM6 7a1 1 0 0 1 1-1h10a1 1 0 0 1 1 1v7H6V7Zm14 10a1 1 0 0 1-1 1H5a1 1 0 0 1-1-1v-1h16v1Z"/></svg> <select autocomplete="off" class="astro-4yphtoen"> <option value="dark" class="astro-4yphtoen">Dark</option><option value="light" class="astro-4yphtoen">Light</option><option value="auto" selected class="astro-4yphtoen">Auto</option> </select> <svg aria-hidden="true" class="icon caret astro-4yphtoen astro-c6vsoqas" width="16" height="16" viewBox="0 0 24 24" fill="currentColor" style="--sl-icon-size: 1em;"><path d="M17 9.17a1 1 0 0 0-1.41 0L12 12.71 8.46 9.17a1 1 0 1 0-1.41 1.42l4.24 4.24a1.002 1.002 0 0 0 1.42 0L17 10.59a1.002 1.002 0 0 0 0-1.42Z"/></svg> </label>  </starlight-theme-select>  
52<script>
53	StarlightThemeProvider.updatePickers();
54</script>
54 
54<script type="module">const r="starlight-theme",o=e=>e==="auto"||e==="dark"||e==="light"?e:"auto",c=()=>o(typeof localStorage<"u"&&localStorage.getItem(r));function n(e){typeof localStorage<"u"&&localStorage.setItem(r,e==="light"||e==="dark"?e:"")}const l=()=>matchMedia("(prefers-color-scheme: light)").matches?"light":"dark";function t(e){StarlightThemeProvider.updatePickers(e),document.documentElement.dataset.theme=e==="auto"?l():e,n(e)}matchMedia("(prefers-color-scheme: light)").addEventListener("change",()=>{c()==="auto"&&t("auto")});class s extends HTMLElement{constructor(){super(),t(c()),this.querySelector("select")?.addEventListener("change",a=>{a.currentTarget instanceof HTMLSelectElement&&t(o(a.currentTarget.value))})}}customElements.define("starlight-theme-select",s);</script>
54 
54<script type="module">class s extends HTMLElement{constructor(){super();const e=this.querySelector("select");e&&(e.addEventListener("change",t=>{t.currentTarget instanceof HTMLSelectElement&&(window.location.pathname=t.currentTarget.value)}),window.addEventListener("pageshow",t=>{if(!t.persisted)return;const n=e.querySelector("option[selected]")?.index;n!==e.selectedIndex&&(e.selectedIndex=n??0)}))}}customElements.define("starlight-lang-select",s);</script>
54 </div> </div> </div> </div> 
54<script type="module">const t=document.querySelector("[role=button].links-and-menu.is-home");t?.addEventListener("click",e=>{const{matches:s}=window.matchMedia("(max-width: 1150px)");if(!s)return;const i=e.target;if(i.closest("summary"))return;if(t.querySelector(".nav-items")?.contains(i)){t.classList.remove("is-active");return}e.preventDefault(),t.classList.toggle("is-active")});document.addEventListener("click",e=>{const{matches:s}=window.matchMedia("(max-width: 1150px)");s&&t?.classList.contains("is-active")&&!t.contains(e.target)&&t.classList.remove("is-active")});</script>
54  </header> <nav class="sidebar print:hidden astro-yriad4ts" aria-label="Main"> <div id="starlight__sidebar" class="sidebar-pane astro-yriad4ts"> <div class="sidebar-content sl-flex astro-yriad4ts"> <div class="mobile-only w-full astro-yriad4ts"> <ul class="top-level astro-3ii7xxms"> <li class="astro-3ii7xxms"> <a href="/" aria-current="false" class="large astro-3ii7xxms"> <span class="astro-3ii7xxms">Home</span>  </a> </li><li class="astro-3ii7xxms"> <a href="/plans/" aria-current="false" class="large astro-3ii7xxms"> <span class="astro-3ii7xxms">Plans</span>  </a> </li><li class="astro-3ii7xxms"> <details class="astro-3ii7xxms"> <summary class="astro-3ii7xxms"> <span class="group-label astro-3ii7xxms"> <span class="large astro-3ii7xxms">Extensions</span>  </span> <svg aria-hidden="true" class="caret astro-3ii7xxms astro-c6vsoqas" width="16" height="16" viewBox="0 0 24 24" fill="currentColor" style="--sl-icon-size: 1.25rem;"><path d="m14.83 11.29-4.24-4.24a1 1 0 1 0-1.42 1.41L12.71 12l-3.54 3.54a1 1 0 0 0 0 1.41 1 1 0 0 0 .71.29 1 1 0 0 0 .71-.29l4.24-4.24a1.002 1.002 0 0 0 0-1.42Z"/></svg> </summary> <sl-sidebar-restore data-index="13"></sl-sidebar-restore> <ul class="astro-3ii7xxms"> <li class="astro-3ii7xxms"> <a href="/extensions/" aria-current="false" class="astro-3ii7xxms"> <span class="astro-3ii7xxms">Browse extensions</span>  </a> </li><li class="astro-3ii7xxms"> <a href="/extensions/about" aria-current="false" class="astro-3ii7xxms"> <span class="astro-3ii7xxms">About Extensions</span>  </a> </li> </ul>  </details> </li><li class="astro-3ii7xxms"> <details open class="astro-3ii7xxms"> <summary class="astro-3ii7xxms"> <span class="group-label astro-3ii7xxms"> <span class="large astro-3ii7xxms">Docs</span>  </span> <svg aria-hidden="true" class="caret astro-3ii7xxms astro-c6vsoqas" width="16" height="16" viewBox="0 0 24 24" fill="currentColor" style="--sl-icon-size: 1.25rem;"><path d="m14.83 11.29-4.24-4.24a1 1 0 1 0-1.42 1.41L12.71 12l-3.54 3.54a1 1 0 0 0 0 1.41 1 1 0 0 0 .71.29 1 1 0 0 0 .71-.29l4.24-4.24a1.002 1.002 0 0 0 0-1.42Z"/></svg> </summary> <sl-sidebar-restore data-index="14"></sl-sidebar-restore> <ul class="astro-3ii7xxms"> <li class="astro-3ii7xxms"> <details open class="astro-3ii7xxms"> <summary class="astro-3ii7xxms"> <span class="group-label astro-3ii7xxms"> <span class="large astro-3ii7xxms">Get started</span>  </span> <svg aria-hidden="true" class="caret astro-3ii7xxms astro-c6vsoqas" width="16" height="16" viewBox="0 0 24 24" fill="currentColor" style="--sl-icon-size: 1.25rem;"><path d="m14.83 11.29-4.24-4.24a1 1 0 1 0-1.42 1.41L12.71 12l-3.54 3.54a1 1 0 0 0 0 1.41 1 1 0 0 0 .71.29 1 1 0 0 0 .71-.29l4.24-4.24a1.002 1.002 0 0 0 0-1.42Z"/></svg> </summary> <sl-sidebar-restore data-index="15"></sl-sidebar-restore> <ul class="astro-3ii7xxms"> <li class="astro-3ii7xxms"> <a href="/docs/" aria-current="page" class="astro-3ii7xxms"> <span class="astro-3ii7xxms">Overview</span>  </a> </li><li class="astro-3ii7xxms"> <a href="/docs/get-started/" aria-current="false" class="astro-3ii7xxms"> <span class="astro-3ii7xxms">Quickstart</span>  </a> </li><li class="astro-3ii7xxms"> <a href="/docs/get-started/installation/" aria-current="false" class="astro-3ii7xxms"> <span class="astro-3ii7xxms">Installation</span>  </a> </li><li class="astro-3ii7xxms"> <a href="/docs/get-started/authentication/" aria-current="false" class="astro-3ii7xxms"> <span class="astro-3ii7xxms">Authentication</span>  </a> </li><li class="astro-3ii7xxms"> <a href="/docs/cli/cli-reference/" aria-current="false" class="astro-3ii7xxms"> <span class="astro-3ii7xxms">CLI cheatsheet</span>  </a> </li><li class="astro-3ii7xxms"> <a href="/docs/get-started/gemini-3/" aria-current="false" class="astro-3ii7xxms"> <span class="astro-3ii7xxms">Gemini 3 on Gemini CLI</span>  </a> </li> </ul>  </details> </li><li class="astro-3ii7xxms"> <details open class="astro-3ii7xxms"> <summary class="astro-3ii7xxms"> <span class="group-label astro-3ii7xxms"> <span class="large astro-3ii7xxms">Use Gemini CLI</span>  </span> <svg aria-hidden="true" class="caret astro-3ii7xxms astro-c6vsoqas" width="16" height="16" viewB
54ox="0 0 24 24" fill="currentColor" style="--sl-icon-size: 1.25rem;"><path d="m14.83 11.29-4.24-4.24a1 1 0 1 0-1.42 1.41L12.71 12l-3.54 3.54a1 1 0 0 0 0 1.41 1 1 0 0 0 .71.29 1 1 0 0 0 .71-.29l4.24-4.24a1.002 1.002 0 0 0 0-1.42Z"/></svg> </summary> <sl-sidebar-restore data-index="16"></sl-sidebar-restore> <ul class="astro-3ii7xxms"> <li class="astro-3ii7xxms"> <a href="/docs/cli/tutorials/file-management/" aria-current="false" class="astro-3ii7xxms"> <span class="astro-3ii7xxms">File management</span>  </a> </li><li class="astro-3ii7xxms"> <a href="/docs/cli/tutorials/skills-getting-started/" aria-current="false" class="astro-3ii7xxms"> <span class="astro-3ii7xxms">Get started with Agent Skills</span>  </a> </li><li class="astro-3ii7xxms"> <a href="/docs/cli/tutorials/memory-management/" aria-current="false" class="astro-3ii7xxms"> <span class="astro-3ii7xxms">Manage context and memory</span>  </a> </li><li class="astro-3ii7xxms"> <a href="/docs/cli/tutorials/shell-commands/" aria-current="false" class="astro-3ii7xxms"> <span class="astro-3ii7xxms">Execute shell commands</span>  </a> </li><li class="astro-3ii7xxms"> <a href="/docs/cli/tutorials/session-management/" aria-current="false" class="astro-3ii7xxms"> <span class="astro-3ii7xxms">Manage sessions and history</span>  </a> </li><li class="astro-3ii7xxms"> <a href="/docs/cli/tutorials/task-planning/" aria-current="false" class="astro-3ii7xxms"> <span class="astro-3ii7xxms">Plan tasks with todos</span>  </a> </li><li class="astro-3ii7xxms"> <a href="/docs/cli/tutorials/plan-mode-steering/" aria-current="false" class="astro-3ii7xxms"> <span class="astro-3ii7xxms">Use Plan Mode with model steering</span> <span class="sl-badge default small  astro-3ii7xxms astro-avdet4wd">🔬</span> </a> </li><li class="astro-3ii7xxms"> <a href="/docs/cli/tutorials/web-tools/" aria-current="false" class="astro-3ii7xxms"> <span class="astro-3ii7xxms">Web search and fetch</span>  </a> </li><li class="astro-3ii7xxms"> <a href="/docs/cli/tutorials/mcp-setup/" aria-current="false" class="astro-3ii7xxms"> <span class="astro-3ii7xxms">Set up an MCP server</span>  </a> </li><li class="astro-3ii7xxms"> <a href="/docs/cli/tutorials/automation/" aria-current="false" class="astro-3ii7xxms"> <span class="astro-3ii7xxms">Automate tasks</span>  </a> </li> </ul>  </details> </li><li class="astro-3ii7xxms"> <details open class="astro-3ii7xxms"> <summary class="astro-3ii7xxms"> <span class="group-label astro-3ii7xxms"> <span class="large astro-3ii7xxms">Features</span>  </span> <svg aria-hidden="true" class="caret astro-3ii7xxms astro-c6vsoqas" width="16" height="16" viewBox="0 0 24 24" fill="currentColor" style="--sl-icon-size: 1.25rem;"><path d="m14.83 11.29-4.24-4.24a1 1 0 1 0-1.42 1.41L12.71 12l-3.54 3.54a1 1 0 0 0 0 1.41 1 1 0 0 0 .71.29 1 1 0 0 0 .71-.29l4.24-4.24a1.002 1.002 0 0 0 0-1.42Z"/></svg> </summary> <sl-sidebar-restore data-index="17"></sl-sidebar-restore> <ul class="astro-3ii7xxms"> <li class="astro-3ii7xxms"> <details class="astro-3ii7xxms"> <summary class="astro-3ii7xxms"> <span class="group-label astro-3ii7xxms"> <span class="large astro-3ii7xxms">Extensions</span>  </span> <svg aria-hidden="true" class="caret astro-3ii7xxms astro-c6vsoqas" width="16" height="16" viewBox="0 0 24 24" fill="currentColor" style="--sl-icon-size: 1.25rem;"><path d="m14.83 11.29-4.24-4.24a1 1 0 1 0-1.42 1.41L12.71 12l-3.54 3.54a1 1 0 0 0 0 1.41 1 1 0 0 0 .71.29 1 1 0 0 0 .71-.29l4.24-4.24a1.002 1.002 0 0 0 0-1.42Z"/></svg> </summary> <sl-sidebar-restore data-index="18"></sl-sidebar-restore> <ul class="astro-3ii7xxms"> <li class="astro-3ii7xxms"> <a href="/docs/extensions/" aria-current="false" class="astro-3ii7xxms"> <span class="astro-3ii7xxms">Overview</span>  </a> </li><li class="astro-3ii7xxms"> <a href="/docs/extensions/#manage-extensions" aria-current="false" class="astro-3ii7xxms"> <span class="astro-3ii7xxms">User guide: Install and manage</span>  </a> </li><li class="astro-3ii7xxms"> <a href="/docs/extensions/writing-extensions/" aria-current="false" class="astro-3ii7xxms"> <span class="astro-3ii7xxms">Developer guide: Build extensions</span>  </a> </li><li class="astro-3ii7xxms"> <a href="/docs/extensions/best-practices/" aria-current="false" class="astro-3ii7xxms"> <span class="astro-3ii7xxms">Developer guide: Best practices</span>  </a> </li><li class="astro-3ii7xxms"> <a href="/docs/extensions/releasing/" aria-current="false" class="astro-3ii7xxms"> <span class="astro-3ii7xxms">Developer guide: Releasing</span>  </a> </li><li class="astro-3ii7xxms"> <a href="/docs/extensions/reference/" aria-current="false" class="astro-3ii7xxms"> <span class="astro-3ii7xxms">Developer guide: Reference</span>  </a> </li> </ul>  </details> </li><li class="astro-3ii7xxms"> <details class="astro-3ii7xxms"> <summary class="astro-3ii7xxms"> <span class="group-label astro-3ii7xxms"> <span class="large astro-3ii7xxms">Agent Skills</span>  </span> <svg aria-hidden="true" class="caret astro-3ii7xxms astro-c6vsoqas" width="16" height="16" viewB
54ox="0 0 24 24" fill="currentColor" style="--sl-icon-size: 1.25rem;"><path d="m14.83 11.29-4.24-4.24a1 1 0 1 0-1.42 1.41L12.71 12l-3.54 3.54a1 1 0 0 0 0 1.41 1 1 0 0 0 .71.29 1 1 0 0 0 .71-.29l4.24-4.24a1.002 1.002 0 0 0 0-1.42Z"/></svg> </summary> <sl-sidebar-restore data-index="19"></sl-sidebar-restore> <ul class="astro-3ii7xxms"> <li class="astro-3ii7xxms"> <a href="/docs/cli/skills/" aria-current="false" class="astro-3ii7xxms"> <span class="astro-3ii7xxms">Overview</span>  </a> </li><li class="astro-3ii7xxms"> <a href="/docs/cli/tutorials/skills-getting-started/" aria-current="false" class="astro-3ii7xxms"> <span class="astro-3ii7xxms">Get started with Agent Skills</span>  </a> </li><li class="astro-3ii7xxms"> <a href="/docs/cli/creating-skills/" aria-current="false" class="astro-3ii7xxms"> <span class="astro-3ii7xxms">Creating Agent Skills</span>  </a> </li><li class="astro-3ii7xxms"> <a href="/docs/cli/using-agent-skills/" aria-current="false" class="astro-3ii7xxms"> <span class="astro-3ii7xxms">Using Agent Skills</span>  </a> </li><li class="astro-3ii7xxms"> <a href="/docs/cli/skills-best-practices/" aria-current="false" class="astro-3ii7xxms"> <span class="astro-3ii7xxms">Developer guide: Best practices</span>  </a> </li> </ul>  </details> </li><li class="astro-3ii7xxms"> <a href="/docs/cli/auto-memory/" aria-current="false" class="astro-3ii7xxms"> <span class="astro-3ii7xxms">Auto Memory</span> <span class="sl-badge default small  astro-3ii7xxms astro-avdet4wd">🔬</span> </a> </li><li class="astro-3ii7xxms"> <a href="/docs/cli/checkpointing/" aria-current="false" class="astro-3ii7xxms"> <span class="astro-3ii7xxms">Checkpointing</span>  </a> </li><li class="astro-3ii7xxms"> <a href="/docs/cli/headless/" aria-current="false" class="astro-3ii7xxms"> <span class="astro-3ii7xxms">Headless mode</span>  </a> </li><li class="astro-3ii7xxms"> <a href="/docs/cli/git-worktrees/" aria-current="false" class="astro-3ii7xxms"> <span class="astro-3ii7xxms">Git worktrees</span> <span class="sl-badge default small  astro-3ii7xxms astro-avdet4wd">🔬</span> </a> </li><li class="astro-3ii7xxms"> <details class="astro-3ii7xxms"> <summary class="astro-3ii7xxms"> <span class="group-label astro-3ii7xxms"> <span class="large astro-3ii7xxms">Hooks</span>  </span> <svg aria-hidden="true" class="caret astro-3ii7xxms astro-c6vsoqas" width="16" height="16" viewBox="0 0 24 24" fill="currentColor" style="--sl-icon-size: 1.25rem;"><path d="m14.83 11.29-4.24-4.24a1 1 0 1 0-1.42 1.41L12.71 12l-3.54 3.54a1 1 0 0 0 0 1.41 1 1 0 0 0 .71.29 1 1 0 0 0 .71-.29l4.24-4.24a1.002 1.002 0 0 0 0-1.42Z"/></svg> </summary> <sl-sidebar-restore data-index="20"></sl-sidebar-restore> <ul class="astro-3ii7xxms"> <li class="astro-3ii7xxms"> <a href="/docs/hooks/" aria-current="false" class="astro-3ii7xxms"> <span class="astro-3ii7xxms">Overview</span>  </a> </li><li class="astro-3ii7xxms"> <a href="/docs/hooks/reference/" aria-current="false" class="astro-3ii7xxms"> <span class="astro-3ii7xxms">Reference</span>  </a> </li> </ul>  </details> </li><li class="astro-3ii7xxms"> <details class="astro-3ii7xxms"> <summary class="astro-3ii7xxms"> <span class="group-label astro-3ii7xxms"> <span class="large astro-3ii7xxms">IDE integration</span>  </span> <svg aria-hidden="true" class="caret astro-3ii7xxms astro-c6vsoqas" width="16" height="16" viewBox="0 0 24 24" fill="currentColor" style="--sl-icon-size: 1.25rem;"><path d="m14.83 11.29-4.24-4.24a1 1 0 1 0-1.42 1.41L12.71 12l-3.54 3.54a1 1 0 0 0 0 1.41 1 1 0 0 0 .71.29 1 1 0 0 0 .71-.29l4.24-4.24a1.002 1.002 0 0 0 0-1.42Z"/></svg> </summary> <sl-sidebar-restore data-index="21"></sl-sidebar-restore> <ul class="astro-3ii7xxms"> <li class="astro-3ii7xxms"> <a href="/docs/ide-integration/" aria-current="false" class="astro-3ii7xxms"> <span class="astro-3ii7xxms">Overview</span>  </a> </li><li class="astro-3ii7xxms"> <a href="/docs/cli/acp-mode/" aria-current="false" class="astro-3ii7xxms"> <span class="astro-3ii7xxms">Developer guide: ACP mode</span>  </a> </li> </ul>  </details> </li><li class="astro-3ii7xxms"> <details class="astro-3ii7xxms"> <summary class="astro-3ii7xxms"> <span class="group-label astro-3ii7xxms"> <span class="large astro-3ii7xxms">MCP servers</span>  </span> <svg aria-hidden="true" class="caret astro-3ii7xxms astro-c6vsoqas" width="16" height="16" viewB
54ox="0 0 24 24" fill="currentColor" style="--sl-icon-size: 1.25rem;"><path d="m14.83 11.29-4.24-4.24a1 1 0 1 0-1.42 1.41L12.71 12l-3.54 3.54a1 1 0 0 0 0 1.41 1 1 0 0 0 .71.29 1 1 0 0 0 .71-.29l4.24-4.24a1.002 1.002 0 0 0 0-1.42Z"/></svg> </summary> <sl-sidebar-restore data-index="22"></sl-sidebar-restore> <ul class="astro-3ii7xxms"> <li class="astro-3ii7xxms"> <a href="/docs/tools/mcp-server/" aria-current="false" class="astro-3ii7xxms"> <span class="astro-3ii7xxms">Overview</span>  </a> </li><li class="astro-3ii7xxms"> <a href="/docs/tools/mcp-resources/" aria-current="false" class="astro-3ii7xxms"> <span class="astro-3ii7xxms">Resource tools</span>  </a> </li> </ul>  </details> </li><li class="astro-3ii7xxms"> <a href="/docs/cli/model-routing/" aria-current="false" class="astro-3ii7xxms"> <span class="astro-3ii7xxms">Model routing</span>  </a> </li><li class="astro-3ii7xxms"> <a href="/docs/cli/model/" aria-current="false" class="astro-3ii7xxms"> <span class="astro-3ii7xxms">Model selection</span>  </a> </li><li class="astro-3ii7xxms"> <a href="/docs/cli/model-steering/" aria-current="false" class="astro-3ii7xxms"> <span class="astro-3ii7xxms">Model steering</span> <span class="sl-badge default small  astro-3ii7xxms astro-avdet4wd">🔬</span> </a> </li><li class="astro-3ii7xxms"> <a href="/docs/cli/notifications/" aria-current="false" class="astro-3ii7xxms"> <span class="astro-3ii7xxms">Notifications</span> <span class="sl-badge default small  astro-3ii7xxms astro-avdet4wd">🔬</span> </a> </li><li class="astro-3ii7xxms"> <a href="/docs/cli/plan-mode/" aria-current="false" class="astro-3ii7xxms"> <span class="astro-3ii7xxms">Plan mode</span>  </a> </li><li class="astro-3ii7xxms"> <a href="/docs/core/subagents/" aria-current="false" class="astro-3ii7xxms"> <span class="astro-3ii7xxms">Subagents</span>  </a> </li><li class="astro-3ii7xxms"> <a href="/docs/core/remote-agents/" aria-current="false" class="astro-3ii7xxms"> <span class="astro-3ii7xxms">Remote subagents</span>  </a> </li><li class="astro-3ii7xxms"> <a href="/docs/cli/rewind/" aria-current="false" class="astro-3ii7xxms"> <span class="astro-3ii7xxms">Rewind</span>  </a> </li><li class="astro-3ii7xxms"> <a href="/docs/cli/sandbox/" aria-current="false" class="astro-3ii7xxms"> <span class="astro-3ii7xxms">Sandboxing</span>  </a> </li><li class="astro-3ii7xxms"> <a href="/docs/cli/settings/" aria-current="false" class="astro-3ii7xxms"> <span class="astro-3ii7xxms">Settings</span>  </a> </li><li class="astro-3ii7xxms"> <a href="/docs/cli/telemetry/" aria-current="false" class="astro-3ii7xxms"> <span class="astro-3ii7xxms">Telemetry</span>  </a> </li><li class="astro-3ii7xxms"> <a href="/docs/cli/token-caching/" aria-current="false" class="astro-3ii7xxms"> <span class="astro-3ii7xxms">Token caching</span>  </a> </li> </ul>  </details> </li><li class="astro-3ii7xxms"> <details open class="astro-3ii7xxms"> <summary class="astro-3ii7xxms"> <span class="group-label astro-3ii7xxms"> <span class="large astro-3ii7xxms">Configuration</span>  </span> <svg aria-hidden="true" class="caret astro-3ii7xxms astro-c6vsoqas" width="16" height="16" viewBox="0 0 24 24" fill="currentColor" style="--sl-icon-size: 1.25rem;"><path d="m14.83 11.29-4.24-4.24a1 1 0 1 0-1.42 1.41L12.71 12l-3.54 3.54a1 1 0 0 0 0 1.41 1 1 0 0 0 .71.29 1 1 0 0 0 .71-.29l4.24-4.24a1.002 1.002 0 0 0 0-1.42Z"/></svg> </summary> <sl-sidebar-restore data-index="23"></sl-sidebar-restore> <ul class="astro-3ii7xxms"> <li class="astro-3ii7xxms"> <a href="/docs/cli/custom-commands/" aria-current="false" class="astro-3ii7xxms"> <span class="astro-3ii7xxms">Custom commands</span>  </a> </li><li class="astro-3ii7xxms"> <a href="/docs/cli/enterprise/" aria-current="false" class="astro-3ii7xxms"> <span class="astro-3ii7xxms">Enterprise configuration</span>  </a> </li><li class="astro-3ii7xxms"> <a href="/docs/cli/gemini-ignore/" aria-current="false" class="astro-3ii7xxms"> <span class="astro-3ii7xxms">Ignore files (.geminiignore)</span>  </a> </li><li class="astro-3ii7xxms"> <a href="/docs/cli/generation-settings/" aria-current="false" class="astro-3ii7xxms"> <span class="astro-3ii7xxms">Model configuration</span>  </a> </li><li class="astro-3ii7xxms"> <a href="/docs/cli/gemini-md/" aria-current="false" class="astro-3ii7xxms"> <span class="astro-3ii7xxms">Project context (GEMINI.md)</span>  </a> </li><li class="astro-3ii7xxms"> <a href="/docs/cli/settings/" aria-current="false" class="astro-3ii7xxms"> <span class="astro-3ii7xxms">Settings</span>  </a> </li><li class="astro-3ii7xxms"> <a href="/docs/cli/system-prompt/" aria-current="false" class="astro-3ii7xxms"> <span class="astro-3ii7xxms">
54System prompt override</span>  </a> </li><li class="astro-3ii7xxms"> <a href="/docs/cli/themes/" aria-current="false" class="astro-3ii7xxms"> <span class="astro-3ii7xxms">Themes</span>  </a> </li><li class="astro-3ii7xxms"> <a href="/docs/cli/trusted-folders/" aria-current="false" class="astro-3ii7xxms"> <span class="astro-3ii7xxms">Trusted folders</span>  </a> </li> </ul>  </details> </li><li class="astro-3ii7xxms"> <details open class="astro-3ii7xxms"> <summary class="astro-3ii7xxms"> <span class="group-label astro-3ii7xxms"> <span class="large astro-3ii7xxms">Development</span>  </span> <svg aria-hidden="true" class="caret astro-3ii7xxms astro-c6vsoqas" width="16" height="16" viewBox="0 0 24 24" fill="currentColor" style="--sl-icon-size: 1.25rem;"><path d="m14.83 11.29-4.24-4.24a1 1 0 1 0-1.42 1.41L12.71 12l-3.54 3.54a1 1 0 0 0 0 1.41 1 1 0 0 0 .71.29 1 1 0 0 0 .71-.29l4.24-4.24a1.002 1.002 0 0 0 0-1.42Z"/></svg> </summary> <sl-sidebar-restore data-index="24"></sl-sidebar-restore> <ul class="astro-3ii7xxms"> <li class="astro-3ii7xxms"> <a href="/docs/behavioral-evals/" aria-current="false" class="astro-3ii7xxms"> <span class="astro-3ii7xxms">Behavioral evaluations</span>  </a> </li><li class="astro-3ii7xxms"> <a href="/docs/contributing/" aria-current="false" class="astro-3ii7xxms"> <span class="astro-3ii7xxms">Contribution guide</span>  </a> </li><li class="astro-3ii7xxms"> <a href="/docs/integration-tests/" aria-current="false" class="astro-3ii7xxms"> <span class="astro-3ii7xxms">Integration testing</span>  </a> </li><li class="astro-3ii7xxms"> <a href="/docs/issue-and-pr-automation/" aria-current="false" class="astro-3ii7xxms"> <span class="astro-3ii7xxms">Issue and PR automation</span>  </a> </li><li class="astro-3ii7xxms"> <a href="/docs/local-development/" aria-current="false" class="astro-3ii7xxms"> <span class="astro-3ii7xxms">Local development</span>  </a> </li><li class="astro-3ii7xxms"> <a href="/docs/npm/" aria-current="false" class="astro-3ii7xxms"> <span class="astro-3ii7xxms">NPM package structure</span>  </a> </li> </ul>  </details> </li> </ul>  </details> </li><li class="astro-3ii7xxms"> <details class="astro-3ii7xxms"> <summary class="astro-3ii7xxms"> <span class="group-label astro-3ii7xxms"> <span class="large astro-3ii7xxms">Reference</span>  </span> <svg aria-hidden="true" class="caret astro-3ii7xxms astro-c6vsoqas" width="16" height="16" viewBox="0 0 24 24" fill="currentColor" style="--sl-icon-size: 1.25rem;"><path d="m14.83 11.29-4.24-4.24a1 1 0 1 0-1.42 1.41L12.71 12l-3.54 3.54a1 1 0 0 0 0 1.41 1 1 0 0 0 .71.29 1 1 0 0 0 .71-.29l4.24-4.24a1.002 1.002 0 0 0 0-1.42Z"/></svg> </summary> <sl-sidebar-restore data-index="25"></sl-sidebar-restore> <ul class="astro-3ii7xxms"> <li class="astro-3ii7xxms"> <a href="/docs/reference/commands/" aria-current="false" class="astro-3ii7xxms"> <span class="astro-3ii7xxms">Command reference</span>  </a> </li><li class="astro-3ii7xxms"> <a href="/docs/reference/configuration/" aria-current="false" class="astro-3ii7xxms"> <span class="astro-3ii7xxms">Configuration reference</span>  </a> </li><li class="astro-3ii7xxms"> <a href="/docs/reference/keyboard-shortcuts/" aria-current="false" class="astro-3ii7xxms"> <span class="astro-3ii7xxms">Keyboard shortcuts</span>  </a> </li><li class="astro-3ii7xxms"> <a href="/docs/reference/memport/" aria-current="false" class="astro-3ii7xxms"> <span class="astro-3ii7xxms">Memory import processor</span>  </a> </li><li class="astro-3ii7xxms"> <a href="/docs/reference/policy-engine/" aria-current="false" class="astro-3ii7xxms"> <span class="astro-3ii7xxms">Policy engine</span>  </a> </li><li class="astro-3ii7xxms"> <a href="/docs/reference/tools/" aria-current="false" class="astro-3ii7xxms"> <span class="astro-3ii7xxms">Tools reference</span>  </a> </li> </ul>  </details> </li><li class="astro-3ii7xxms"> <details class="astro-3ii7xxms"> <summary class="astro-3ii7xxms"> <span class="group-label astro-3ii7xxms"> <span class="large astro-3ii7xxms">Resources</span>  </span> <svg aria-hidden="true" class="caret astro-3ii7xxms astro-c6vsoqas" width="16" height="16" viewB
54ox="0 0 24 24" fill="currentColor" style="--sl-icon-size: 1.25rem;"><path d="m14.83 11.29-4.24-4.24a1 1 0 1 0-1.42 1.41L12.71 12l-3.54 3.54a1 1 0 0 0 0 1.41 1 1 0 0 0 .71.29 1 1 0 0 0 .71-.29l4.24-4.24a1.002 1.002 0 0 0 0-1.42Z"/></svg> </summary> <sl-sidebar-restore data-index="26"></sl-sidebar-restore> <ul class="astro-3ii7xxms"> <li class="astro-3ii7xxms"> <a href="/docs/resources/faq/" aria-current="false" class="astro-3ii7xxms"> <span class="astro-3ii7xxms">FAQ</span>  </a> </li><li class="astro-3ii7xxms"> <a href="/docs/resources/quota-and-pricing/" aria-current="false" class="astro-3ii7xxms"> <span class="astro-3ii7xxms">Quota and pricing</span>  </a> </li><li class="astro-3ii7xxms"> <a href="/docs/resources/tos-privacy/" aria-current="false" class="astro-3ii7xxms"> <span class="astro-3ii7xxms">Terms and privacy</span>  </a> </li><li class="astro-3ii7xxms"> <a href="/docs/resources/troubleshooting/" aria-current="false" class="astro-3ii7xxms"> <span class="astro-3ii7xxms">Troubleshooting</span>  </a> </li><li class="astro-3ii7xxms"> <a href="/docs/resources/uninstall/" aria-current="false" class="astro-3ii7xxms"> <span class="astro-3ii7xxms">Uninstall</span>  </a> </li> </ul>  </details> </li><li class="astro-3ii7xxms"> <details class="astro-3ii7xxms"> <summary class="astro-3ii7xxms"> <span class="group-label astro-3ii7xxms"> <span class="large astro-3ii7xxms">Changelog</span>  </span> <svg aria-hidden="true" class="caret astro-3ii7xxms astro-c6vsoqas" width="16" height="16" viewBox="0 0 24 24" fill="currentColor" style="--sl-icon-size: 1.25rem;"><path d="m14.83 11.29-4.24-4.24a1 1 0 1 0-1.42 1.41L12.71 12l-3.54 3.54a1 1 0 0 0 0 1.41 1 1 0 0 0 .71.29 1 1 0 0 0 .71-.29l4.24-4.24a1.002 1.002 0 0 0 0-1.42Z"/></svg> </summary> <sl-sidebar-restore data-index="27"></sl-sidebar-restore> <ul class="astro-3ii7xxms"> <li class="astro-3ii7xxms"> <a href="/docs/changelogs/" aria-current="false" class="astro-3ii7xxms"> <span class="astro-3ii7xxms">Release notes</span>  </a> </li><li class="astro-3ii7xxms"> <a href="/docs/changelogs/latest/" aria-current="false" class="astro-3ii7xxms"> <span class="astro-3ii7xxms">Stable release</span>  </a> </li><li class="astro-3ii7xxms"> <a href="/docs/changelogs/preview/" aria-current="false" class="astro-3ii7xxms"> <span class="astro-3ii7xxms">Preview release</span>  </a> </li> </ul>  </details> </li> </ul>  </div> <div class="w-full hide-native-sidebar-on-mobile astro-yriad4ts"> <div data-starlight-multi-sidebar-label="docs_tab"><sl-sidebar-state-persist data-hash="0gdtu4p" class="astro-kku4brbg"> 
54<script aria-hidden="true">
55		(() => {
56			try {
57				if (!matchMedia('(min-width: 50em)').matches) return;
58				/** @type {HTMLElement | null} */
59				const target = document.querySelector('sl-sidebar-state-persist');
60				const state = JSON.parse(sessionStorage.getItem('sl-sidebar-state') || '0');
61				if (!target || !state || target.dataset.hash !== state.hash) return;
62				window._starlightScrollRestore = state.scroll;
63				customElements.define(
64					'sl-sidebar-restore',
65					class SidebarRestore extends HTMLElement {
66						connectedCallback() {
67							try {
68								const idx = parseInt(this.dataset.index || '');
69								const details = this.closest('details');
70								if (details && typeof state.open[idx] === 'boolean') details.open = state.open[idx];
71							} catch {}
72						}
73					}
74				);
75			} catch {}
76		})();
77	</script>
77  <ul class="top-level astro-3ii7xxms"> <li class="astro-3ii7xxms"> <details open class="astro-3ii7xxms"> <summary class="astro-3ii7xxms"> <span class="group-label astro-3ii7xxms"> <span class="large astro-3ii7xxms">Get started</span>  </span> <svg aria-hidden="true" class="caret astro-3ii7xxms astro-c6vsoqas" width="16" height="16" viewBox="0 0 24 24" fill="currentColor" style="--sl-icon-size: 1.25rem;"><path d="m14.83 11.29-4.24-4.24a1 1 0 1 0-1.42 1.41L12.71 12l-3.54 3.54a1 1 0 0 0 0 1.41 1 1 0 0 0 .71.29 1 1 0 0 0 .71-.29l4.24-4.24a1.002 1.002 0 0 0 0-1.42Z"/></svg> </summary> <sl-sidebar-restore data-index="0"></sl-sidebar-restore> <ul class="astro-3ii7xxms"> <li class="astro-3ii7xxms"> <a href="/docs/" aria-current="page" class="astro-3ii7xxms"> <span class="astro-3ii7xxms">Overview</span>  </a> </li><li class="astro-3ii7xxms"> <a href="/docs/get-started/" aria-current="false" class="astro-3ii7xxms"> <span class="astro-3ii7xxms">Quickstart</span>  </a> </li><li class="astro-3ii7xxms"> <a href="/docs/get-started/installation/" aria-current="false" class="astro-3ii7xxms"> <span class="astro-3ii7xxms">Installation</span>  </a> </li><li class="astro-3ii7xxms"> <a href="/docs/get-started/authentication/" aria-current="false" class="astro-3ii7xxms"> <span class="astro-3ii7xxms">Authentication</span>  </a> </li><li class="astro-3ii7xxms"> <a href="/docs/cli/cli-reference/" aria-current="false" class="astro-3ii7xxms"> <span class="astro-3ii7xxms">CLI cheatsheet</span>  </a> </li><li class="astro-3ii7xxms"> <a href="/docs/get-started/gemini-3/" aria-current="false" class="astro-3ii7xxms"> <span class="astro-3ii7xxms">Gemini 3 on Gemini CLI</span>  </a> </li> </ul>  </details> </li><li class="astro-3ii7xxms"> <details open class="astro-3ii7xxms"> <summary class="astro-3ii7xxms"> <span class="group-label astro-3ii7xxms"> <span class="large astro-3ii7xxms">Use Gemini CLI</span>  </span> <svg aria-hidden="true" class="caret astro-3ii7xxms astro-c6vsoqas" width="16" height="16" viewBox="0 0 24 24" fill="currentColor" style="--sl-icon-size: 1.25rem;"><path d="m14.83 11.29-4.24-4.24a1 1 0 1 0-1.42 1.41L12.71 12l-3.54 3.54a1 1 0 0 0 0 1.41 1 1 0 0 0 .71.29 1 1 0 0 0 .71-.29l4.24-4.24a1.002 1.002 0 0 0 0-1.42Z"/></svg> </summary> <sl-sidebar-restore data-index="1"></sl-sidebar-restore> <ul class="astro-3ii7xxms"> <li class="astro-3ii7xxms"> <a href="/docs/cli/tutorials/file-management/" aria-current="false" class="astro-3ii7xxms"> <span class="astro-3ii7xxms">File management</span>  </a> </li><li class="astro-3ii7xxms"> <a href="/docs/cli/tutorials/skills-getting-started/" aria-current="false" class="astro-3ii7xxms"> <span class="astro-3ii7xxms">Get started with Agent Skills</span>  </a> </li><li class="astro-3ii7xxms"> <a href="/docs/cli/tutorials/memory-management/" aria-current="false" class="astro-3ii7xxms"> <span class="astro-3ii7xxms">Manage context and memory</span>  </a> </li><li class="astro-3ii7xxms"> <a href="/docs/cli/tutorials/shell-commands/" aria-current="false" class="astro-3ii7xxms"> <span class="astro-3ii7xxms">Execute shell commands</span>  </a> </li><li class="astro-3ii7xxms"> <a href="/docs/cli/tutorials/session-management/" aria-current="false" class="astro-3ii7xxms"> <span class="astro-3ii7xxms">Manage sessions and history</span>  </a> </li><li class="astro-3ii7xxms"> <a href="/docs/cli/tutorials/task-planning/" aria-current="false" class="astro-3ii7xxms"> <span class="astro-3ii7xxms">Plan tasks with todos</span>  </a> </li><li class="astro-3ii7xxms"> <a href="/docs/cli/tutorials/plan-mode-steering/" aria-current="false" class="astro-3ii7xxms"> <span class="astro-3ii7xxms">Use Plan Mode with model steering</span> <span class="sl-badge default small  astro-3ii7xxms astro-avdet4wd">🔬</span> </a> </li><li class="astro-3ii7xxms"> <a href="/docs/cli/tutorials/web-tools/" aria-current="false" class="astro-3ii7xxms"> <span class="astro-3ii7xxms">Web search and fetch</span>  </a> </li><li class="astro-3ii7xxms"> <a href="/docs/cli/tutorials/mcp-setup/" aria-current="false" class="astro-3ii7xxms"> <span class="astro-3ii7xxms">Set up an MCP server</span>  </a> </li><li class="astro-3ii7xxms"> <a href="/docs/cli/tutorials/automation/" aria-current="false" class="astro-3ii7xxms"> <span class="astro-3ii7xxms">Automate tasks</span>  </a> </li> </ul>  </details> </li><li class="astro-3ii7xxms"> <details open class="astro-3ii7xxms"> <summary class="astro-3ii7xxms"> <span class="group-label astro-3ii7xxms"> <span class="large astro-3ii7xxms">Features</span>  </span> <svg aria-hidden="true" class="caret astro-3ii7xxms astro-c6vsoqas" width="16" height="16" viewB
77ox="0 0 24 24" fill="currentColor" style="--sl-icon-size: 1.25rem;"><path d="m14.83 11.29-4.24-4.24a1 1 0 1 0-1.42 1.41L12.71 12l-3.54 3.54a1 1 0 0 0 0 1.41 1 1 0 0 0 .71.29 1 1 0 0 0 .71-.29l4.24-4.24a1.002 1.002 0 0 0 0-1.42Z"/></svg> </summary> <sl-sidebar-restore data-index="2"></sl-sidebar-restore> <ul class="astro-3ii7xxms"> <li class="astro-3ii7xxms"> <details class="astro-3ii7xxms"> <summary class="astro-3ii7xxms"> <span class="group-label astro-3ii7xxms"> <span class="large astro-3ii7xxms">Extensions</span>  </span> <svg aria-hidden="true" class="caret astro-3ii7xxms astro-c6vsoqas" width="16" height="16" viewBox="0 0 24 24" fill="currentColor" style="--sl-icon-size: 1.25rem;"><path d="m14.83 11.29-4.24-4.24a1 1 0 1 0-1.42 1.41L12.71 12l-3.54 3.54a1 1 0 0 0 0 1.41 1 1 0 0 0 .71.29 1 1 0 0 0 .71-.29l4.24-4.24a1.002 1.002 0 0 0 0-1.42Z"/></svg> </summary> <sl-sidebar-restore data-index="3"></sl-sidebar-restore> <ul class="astro-3ii7xxms"> <li class="astro-3ii7xxms"> <a href="/docs/extensions/" aria-current="false" class="astro-3ii7xxms"> <span class="astro-3ii7xxms">Overview</span>  </a> </li><li class="astro-3ii7xxms"> <a href="/docs/extensions/#manage-extensions" aria-current="false" class="astro-3ii7xxms"> <span class="astro-3ii7xxms">User guide: Install and manage</span>  </a> </li><li class="astro-3ii7xxms"> <a href="/docs/extensions/writing-extensions/" aria-current="false" class="astro-3ii7xxms"> <span class="astro-3ii7xxms">Developer guide: Build extensions</span>  </a> </li><li class="astro-3ii7xxms"> <a href="/docs/extensions/best-practices/" aria-current="false" class="astro-3ii7xxms"> <span class="astro-3ii7xxms">Developer guide: Best practices</span>  </a> </li><li class="astro-3ii7xxms"> <a href="/docs/extensions/releasing/" aria-current="false" class="astro-3ii7xxms"> <span class="astro-3ii7xxms">Developer guide: Releasing</span>  </a> </li><li class="astro-3ii7xxms"> <a href="/docs/extensions/reference/" aria-current="false" class="astro-3ii7xxms"> <span class="astro-3ii7xxms">Developer guide: Reference</span>  </a> </li> </ul>  </details> </li><li class="astro-3ii7xxms"> <details class="astro-3ii7xxms"> <summary class="astro-3ii7xxms"> <span class="group-label astro-3ii7xxms"> <span class="large astro-3ii7xxms">Agent Skills</span>  </span> <svg aria-hidden="true" class="caret astro-3ii7xxms astro-c6vsoqas" width="16" height="16" viewBox="0 0 24 24" fill="currentColor" style="--sl-icon-size: 1.25rem;"><path d="m14.83 11.29-4.24-4.24a1 1 0 1 0-1.42 1.41L12.71 12l-3.54 3.54a1 1 0 0 0 0 1.41 1 1 0 0 0 .71.29 1 1 0 0 0 .71-.29l4.24-4.24a1.002 1.002 0 0 0 0-1.42Z"/></svg> </summary> <sl-sidebar-restore data-index="4"></sl-sidebar-restore> <ul class="astro-3ii7xxms"> <li class="astro-3ii7xxms"> <a href="/docs/cli/skills/" aria-current="false" class="astro-3ii7xxms"> <span class="astro-3ii7xxms">Overview</span>  </a> </li><li class="astro-3ii7xxms"> <a href="/docs/cli/tutorials/skills-getting-started/" aria-current="false" class="astro-3ii7xxms"> <span class="astro-3ii7xxms">Get started with Agent Skills</span>  </a> </li><li class="astro-3ii7xxms"> <a href="/docs/cli/creating-skills/" aria-current="false" class="astro-3ii7xxms"> <span class="astro-3ii7xxms">Creating Agent Skills</span>  </a> </li><li class="astro-3ii7xxms"> <a href="/docs/cli/using-agent-skills/" aria-current="false" class="astro-3ii7xxms"> <span class="astro-3ii7xxms">Using Agent Skills</span>  </a> </li><li class="astro-3ii7xxms"> <a href="/docs/cli/skills-best-practices/" aria-current="false" class="astro-3ii7xxms"> <span class="astro-3ii7xxms">Developer guide: Best practices</span>  </a> </li> </ul>  </details> </li><li class="astro-3ii7xxms"> <a href="/docs/cli/auto-memory/" aria-current="false" class="astro-3ii7xxms"> <span class="astro-3ii7xxms">Auto Memory</span> <span class="sl-badge default small  astro-3ii7xxms astro-avdet4wd">🔬</span> </a> </li><li class="astro-3ii7xxms"> <a href="/docs/cli/checkpointing/" aria-current="false" class="astro-3ii7xxms"> <span class="astro-3ii7xxms">Checkpointing</span>  </a> </li><li class="astro-3ii7xxms"> <a href="/docs/cli/headless/" aria-current="false" class="astro-3ii7xxms"> <span class="astro-3ii7xxms">Headless mode</span>  </a> </li><li class="astro-3ii7xxms"> <a href="/docs/cli/git-worktrees/" aria-current="false" class="astro-3ii7xxms"> <span class="astro-3ii7xxms">Git worktrees</span> <span class="sl-badge default small  astro-3ii7xxms astro-avdet4wd">
77🔬</span> </a> </li><li class="astro-3ii7xxms"> <details class="astro-3ii7xxms"> <summary class="astro-3ii7xxms"> <span class="group-label astro-3ii7xxms"> <span class="large astro-3ii7xxms">Hooks</span>  </span> <svg aria-hidden="true" class="caret astro-3ii7xxms astro-c6vsoqas" width="16" height="16" viewBox="0 0 24 24" fill="currentColor" style="--sl-icon-size: 1.25rem;"><path d="m14.83 11.29-4.24-4.24a1 1 0 1 0-1.42 1.41L12.71 12l-3.54 3.54a1 1 0 0 0 0 1.41 1 1 0 0 0 .71.29 1 1 0 0 0 .71-.29l4.24-4.24a1.002 1.002 0 0 0 0-1.42Z"/></svg> </summary> <sl-sidebar-restore data-index="5"></sl-sidebar-restore> <ul class="astro-3ii7xxms"> <li class="astro-3ii7xxms"> <a href="/docs/hooks/" aria-current="false" class="astro-3ii7xxms"> <span class="astro-3ii7xxms">Overview</span>  </a> </li><li class="astro-3ii7xxms"> <a href="/docs/hooks/reference/" aria-current="false" class="astro-3ii7xxms"> <span class="astro-3ii7xxms">Reference</span>  </a> </li> </ul>  </details> </li><li class="astro-3ii7xxms"> <details class="astro-3ii7xxms"> <summary class="astro-3ii7xxms"> <span class="group-label astro-3ii7xxms"> <span class="large astro-3ii7xxms">IDE integration</span>  </span> <svg aria-hidden="true" class="caret astro-3ii7xxms astro-c6vsoqas" width="16" height="16" viewBox="0 0 24 24" fill="currentColor" style="--sl-icon-size: 1.25rem;"><path d="m14.83 11.29-4.24-4.24a1 1 0 1 0-1.42 1.41L12.71 12l-3.54 3.54a1 1 0 0 0 0 1.41 1 1 0 0 0 .71.29 1 1 0 0 0 .71-.29l4.24-4.24a1.002 1.002 0 0 0 0-1.42Z"/></svg> </summary> <sl-sidebar-restore data-index="6"></sl-sidebar-restore> <ul class="astro-3ii7xxms"> <li class="astro-3ii7xxms"> <a href="/docs/ide-integration/" aria-current="false" class="astro-3ii7xxms"> <span class="astro-3ii7xxms">Overview</span>  </a> </li><li class="astro-3ii7xxms"> <a href="/docs/cli/acp-mode/" aria-current="false" class="astro-3ii7xxms"> <span class="astro-3ii7xxms">Developer guide: ACP mode</span>  </a> </li> </ul>  </details> </li><li class="astro-3ii7xxms"> <details class="astro-3ii7xxms"> <summary class="astro-3ii7xxms"> <span class="group-label astro-3ii7xxms"> <span class="large astro-3ii7xxms">MCP servers</span>  </span> <svg aria-hidden="true" class="caret astro-3ii7xxms astro-c6vsoqas" width="16" height="16" viewBox="0 0 24 24" fill="currentColor" style="--sl-icon-size: 1.25rem;"><path d="m14.83 11.29-4.24-4.24a1 1 0 1 0-1.42 1.41L12.71 12l-3.54 3.54a1 1 0 0 0 0 1.41 1 1 0 0 0 .71.29 1 1 0 0 0 .71-.29l4.24-4.24a1.002 1.002 0 0 0 0-1.42Z"/></svg> </summary> <sl-sidebar-restore data-index="7"></sl-sidebar-restore> <ul class="astro-3ii7xxms"> <li class="astro-3ii7xxms"> <a href="/docs/tools/mcp-server/" aria-current="false" class="astro-3ii7xxms"> <span class="astro-3ii7xxms">Overview</span>  </a> </li><li class="astro-3ii7xxms"> <a href="/docs/tools/mcp-resources/" aria-current="false" class="astro-3ii7xxms"> <span class="astro-3ii7xxms">Resource tools</span>  </a> </li> </ul>  </details> </li><li class="astro-3ii7xxms"> <a href="/docs/cli/model-routing/" aria-current="false" class="astro-3ii7xxms"> <span class="astro-3ii7xxms">Model routing</span>  </a> </li><li class="astro-3ii7xxms"> <a href="/docs/cli/model/" aria-current="false" class="astro-3ii7xxms"> <span class="astro-3ii7xxms">Model selection</span>  </a> </li><li class="astro-3ii7xxms"> <a href="/docs/cli/model-steering/" aria-current="false" class="astro-3ii7xxms"> <span class="astro-3ii7xxms">Model steering</span> <span class="sl-badge default small  astro-3ii7xxms astro-avdet4wd">🔬</span> </a> </li><li class="astro-3ii7xxms"> <a href="/docs/cli/notifications/" aria-current="false" class="astro-3ii7xxms"> <span class="astro-3ii7xxms">Notifications</span> <span class="sl-badge default small  astro-3ii7xxms astro-avdet4wd">🔬</span> </a> </li><li class="astro-3ii7xxms"> <a href="/docs/cli/plan-mode/" aria-current="false" class="astro-3ii7xxms"> <span class="astro-3ii7xxms">Plan mode</span>  </a> </li><li class="astro-3ii7xxms"> <a href="/docs/core/subagents/" aria-current="false" class="astro-3ii7xxms"> <span class="astro-3ii7xxms">Subagents</span>  </a> </li><li class="astro-3ii7xxms"> <a href="/docs/core/remote-agents/" aria-current="false" class="astro-3ii7xxms"> <span class="astro-3ii7xxms">Remote subagents</span>  </a> </li><li class="astro-3ii7xxms"> <a href="/docs/cli/rewind/" aria-current="false" class="astro-3ii7xxms"> <span class="astro-3ii7xxms">Rewind</span>  </a> </li><li class="astro-3ii7xxms"> <a href="/docs/cli/sandbox/" aria-current="false" class="astro-3ii7xxms"> <span class="astro-3ii7xxms">Sandboxing</span>  </a> </li><li class="astro-3ii7xxms"> <a href="/docs/cli/settings/" aria-current="false" class="astro-3ii7xxms"> <span class="astro-3ii7xxms">Settings</span>  </a> </li><li class="astro-3ii7xxms"> <a href="/docs/cli/telemetry/" aria-current="false" class="astro-3ii7xxms"> <span class="astro-3ii7xxms">Telemetry</span>  </a> </li><li class="astro-3ii7xxms"> <a href="/docs/cli/token-caching/" aria-current="false" class="astro-3ii7xxms"> <span class="astro-3ii7xxms">Token caching</span>  </a> </li> </ul>  </details> </li><li class="astro-3ii7xxms"> <details open class="astro-3ii7xxms"> <summary class="astro-3ii7xxms"> <span class="group-label astro-3ii7xxms"> <span class="large astro-3ii7xxms">Configuration</span>  </span> <svg aria-hidden="true" class="caret astro-3ii7xxms astro-c6vsoqas" width="16" height="16" viewB
77ox="0 0 24 24" fill="currentColor" style="--sl-icon-size: 1.25rem;"><path d="m14.83 11.29-4.24-4.24a1 1 0 1 0-1.42 1.41L12.71 12l-3.54 3.54a1 1 0 0 0 0 1.41 1 1 0 0 0 .71.29 1 1 0 0 0 .71-.29l4.24-4.24a1.002 1.002 0 0 0 0-1.42Z"/></svg> </summary> <sl-sidebar-restore data-index="8"></sl-sidebar-restore> <ul class="astro-3ii7xxms"> <li class="astro-3ii7xxms"> <a href="/docs/cli/custom-commands/" aria-current="false" class="astro-3ii7xxms"> <span class="astro-3ii7xxms">Custom commands</span>  </a> </li><li class="astro-3ii7xxms"> <a href="/docs/cli/enterprise/" aria-current="false" class="astro-3ii7xxms"> <span class="astro-3ii7xxms">Enterprise configuration</span>  </a> </li><li class="astro-3ii7xxms"> <a href="/docs/cli/gemini-ignore/" aria-current="false" class="astro-3ii7xxms"> <span class="astro-3ii7xxms">Ignore files (.geminiignore)</span>  </a> </li><li class="astro-3ii7xxms"> <a href="/docs/cli/generation-settings/" aria-current="false" class="astro-3ii7xxms"> <span class="astro-3ii7xxms">Model configuration</span>  </a> </li><li class="astro-3ii7xxms"> <a href="/docs/cli/gemini-md/" aria-current="false" class="astro-3ii7xxms"> <span class="astro-3ii7xxms">Project context (GEMINI.md)</span>  </a> </li><li class="astro-3ii7xxms"> <a href="/docs/cli/settings/" aria-current="false" class="astro-3ii7xxms"> <span class="astro-3ii7xxms">Settings</span>  </a> </li><li class="astro-3ii7xxms"> <a href="/docs/cli/system-prompt/" aria-current="false" class="astro-3ii7xxms"> <span class="astro-3ii7xxms">
77System prompt override</span>  </a> </li><li class="astro-3ii7xxms"> <a href="/docs/cli/themes/" aria-current="false" class="astro-3ii7xxms"> <span class="astro-3ii7xxms">Themes</span>  </a> </li><li class="astro-3ii7xxms"> <a href="/docs/cli/trusted-folders/" aria-current="false" class="astro-3ii7xxms"> <span class="astro-3ii7xxms">Trusted folders</span>  </a> </li> </ul>  </details> </li><li class="astro-3ii7xxms"> <details open class="astro-3ii7xxms"> <summary class="astro-3ii7xxms"> <span class="group-label astro-3ii7xxms"> <span class="large astro-3ii7xxms">Development</span>  </span> <svg aria-hidden="true" class="caret astro-3ii7xxms astro-c6vsoqas" width="16" height="16" viewBox="0 0 24 24" fill="currentColor" style="--sl-icon-size: 1.25rem;"><path d="m14.83 11.29-4.24-4.24a1 1 0 1 0-1.42 1.41L12.71 12l-3.54 3.54a1 1 0 0 0 0 1.41 1 1 0 0 0 .71.29 1 1 0 0 0 .71-.29l4.24-4.24a1.002 1.002 0 0 0 0-1.42Z"/></svg> </summary> <sl-sidebar-restore data-index="9"></sl-sidebar-restore> <ul class="astro-3ii7xxms"> <li class="astro-3ii7xxms"> <a href="/docs/behavioral-evals/" aria-current="false" class="astro-3ii7xxms"> <span class="astro-3ii7xxms">Behavioral evaluations</span>  </a> </li><li class="astro-3ii7xxms"> <a href="/docs/contributing/" aria-current="false" class="astro-3ii7xxms"> <span class="astro-3ii7xxms">Contribution guide</span>  </a> </li><li class="astro-3ii7xxms"> <a href="/docs/integration-tests/" aria-current="false" class="astro-3ii7xxms"> <span class="astro-3ii7xxms">Integration testing</span>  </a> </li><li class="astro-3ii7xxms"> <a href="/docs/issue-and-pr-automation/" aria-current="false" class="astro-3ii7xxms"> <span class="astro-3ii7xxms">Issue and PR automation</span>  </a> </li><li class="astro-3ii7xxms"> <a href="/docs/local-development/" aria-current="false" class="astro-3ii7xxms"> <span class="astro-3ii7xxms">Local development</span>  </a> </li><li class="astro-3ii7xxms"> <a href="/docs/npm/" aria-current="false" class="astro-3ii7xxms"> <span class="astro-3ii7xxms">NPM package structure</span>  </a> </li> </ul>  </details> </li> </ul>   
77<script aria-hidden="true">
78		(() => {
79			const scroller = document.getElementById('starlight__sidebar');
80			if (!window._starlightScrollRestore || !scroller) return;
81			scroller.scrollTop = window._starlightScrollRestore;
82			delete window._starlightScrollRestore;
83		})();
84	</script>
84 </sl-sidebar-state-persist>  <div class="md:sl-hidden"> <div class="mobile-preferences sl-flex astro-wu23bvmt"> <div class="social-icons astro-wu23bvmt"> <a href="https://github.com/google-gemini/gemini-cli" rel="me" class="sl-flex astro-wy4te6ga"><span class="sr-only astro-wy4te6ga">GitHub</span><svg aria-hidden="true" class="astro-wy4te6ga astro-c6vsoqas" width="16" height="16" viewBox="0 0 24 24" fill="currentColor" style="--sl-icon-size: 1em;"><path d="M12 .3a12 12 0 0 0-3.8 23.38c.6.12.83-.26.83-.57L9 21.07c-3.34.72-4.04-1.61-4.04-1.61-.55-1.39-1.34-1.76-1.34-1.76-1.08-.74.09-.73.09-.73 1.2.09 1.83 1.24 1.83 1.24 1.08 1.83 2.81 1.3 3.5 1 .1-.78.42-1.31.76-1.61-2.67-.3-5.47-1.33-5.47-5.93 0-1.31.47-2.38 1.24-3.22-.14-.3-.54-1.52.1-3.18 0 0 1-.32 3.3 1.23a11.5 11.5 0 0 1 6 0c2.28-1.55 3.29-1.23 3.29-1.23.64 1.66.24 2.88.12 3.18a4.65 4.65 0 0 1 1.23 3.22c0 4.61-2.8 5.63-5.48 5.92.42.36.81 1.1.81 2.22l-.01 3.29c0 .31.2.69.82.57A12 12 0 0 0 12 .3Z"/></svg></a> </div> <starlight-theme-select>  <label style="--sl-select-width: 6.25em" class="astro-4yphtoen"> <span class="sr-only astro-4yphtoen">Select theme</span> <svg aria-hidden="true" class="icon label-icon astro-4yphtoen astro-c6vsoqas" width="16" height="16" viewBox="0 0 24 24" fill="currentColor" style="--sl-icon-size: 1em;"><path d="M21 14h-1V7a3 3 0 0 0-3-3H7a3 3 0 0 0-3 3v7H3a1 1 0 0 0-1 1v2a3 3 0 0 0 3 3h14a3 3 0 0 0 3-3v-2a1 1 0 0 0-1-1ZM6 7a1 1 0 0 1 1-1h10a1 1 0 0 1 1 1v7H6V7Zm14 10a1 1 0 0 1-1 1H5a1 1 0 0 1-1-1v-1h16v1Z"/></svg> <select autocomplete="off" class="astro-4yphtoen"> <option value="dark" class="astro-4yphtoen">Dark</option><option value="light" class="astro-4yphtoen">Light</option><option value="auto" selected class="astro-4yphtoen">Auto</option> </select> <svg aria-hidden="true" class="icon caret astro-4yphtoen astro-c6vsoqas" width="16" height="16" viewBox="0 0 24 24" fill="currentColor" style="--sl-icon-size: 1em;"><path d="M17 9.17a1 1 0 0 0-1.41 0L12 12.71 8.46 9.17a1 1 0 1 0-1.41 1.42l4.24 4.24a1.002 1.002 0 0 0 1.42 0L17 10.59a1.002 1.002 0 0 0 0-1.42Z"/></svg> </label>  </starlight-theme-select>  
84<script>
85	StarlightThemeProvider.updatePickers();
86</script>
86   </div>  </div></div><div hidden data-starlight-multi-sidebar-label="reference_tab"><sl-sidebar-state-persist data-hash="02o8ixh" class="astro-kku4brbg"> 
86<script aria-hidden="true">
87		(() => {
88			try {
89				if (!matchMedia('(min-width: 50em)').matches) return;
90				/** @type {HTMLElement | null} */
91				const target = document.querySelector('sl-sidebar-state-persist');
92				const state = JSON.parse(sessionStorage.getItem('sl-sidebar-state') || '0');
93				if (!target || !state || target.dataset.hash !== state.hash) return;
94				window._starlightScrollRestore = state.scroll;
95				customElements.define(
96					'sl-sidebar-restore',
97					class SidebarRestore extends HTMLElement {
98						connectedCallback() {
99							try {
100								const idx = parseInt(this.dataset.index || '');
101								const details = this.closest('details');
102								if (details && typeof state.open[idx] === 'boolean') details.open = state.open[idx];
103							} catch {}
104						}
105					}
106				);
107			} catch {}
108		})();
109	</script>
109  <ul class="top-level astro-3ii7xxms"> <li class="astro-3ii7xxms"> <details open class="astro-3ii7xxms"> <summary class="astro-3ii7xxms"> <span class="group-label astro-3ii7xxms"> <span class="large astro-3ii7xxms">Reference</span>  </span> <svg aria-hidden="true" class="caret astro-3ii7xxms astro-c6vsoqas" width="16" height="16" viewBox="0 0 24 24" fill="currentColor" style="--sl-icon-size: 1.25rem;"><path d="m14.83 11.29-4.24-4.24a1 1 0 1 0-1.42 1.41L12.71 12l-3.54 3.54a1 1 0 0 0 0 1.41 1 1 0 0 0 .71.29 1 1 0 0 0 .71-.29l4.24-4.24a1.002 1.002 0 0 0 0-1.42Z"/></svg> </summary> <sl-sidebar-restore data-index="10"></sl-sidebar-restore> <ul class="astro-3ii7xxms"> <li class="astro-3ii7xxms"> <a href="/docs/reference/commands/" aria-current="false" class="astro-3ii7xxms"> <span class="astro-3ii7xxms">Command reference</span>  </a> </li><li class="astro-3ii7xxms"> <a href="/docs/reference/configuration/" aria-current="false" class="astro-3ii7xxms"> <span class="astro-3ii7xxms">Configuration reference</span>  </a> </li><li class="astro-3ii7xxms"> <a href="/docs/reference/keyboard-shortcuts/" aria-current="false" class="astro-3ii7xxms"> <span class="astro-3ii7xxms">Keyboard shortcuts</span>  </a> </li><li class="astro-3ii7xxms"> <a href="/docs/reference/memport/" aria-current="false" class="astro-3ii7xxms"> <span class="astro-3ii7xxms">Memory import processor</span>  </a> </li><li class="astro-3ii7xxms"> <a href="/docs/reference/policy-engine/" aria-current="false" class="astro-3ii7xxms"> <span class="astro-3ii7xxms">Policy engine</span>  </a> </li><li class="astro-3ii7xxms"> <a href="/docs/reference/tools/" aria-current="false" class="astro-3ii7xxms"> <span class="astro-3ii7xxms">Tools reference</span>  </a> </li> </ul>  </details> </li> </ul>   
109<script aria-hidden="true">
110		(() => {
111			const scroller = document.getElementById('starlight__sidebar');
112			if (!window._starlightScrollRestore || !scroller) return;
113			scroller.scrollTop = window._starlightScrollRestore;
114			delete window._starlightScrollRestore;
115		})();
116	</script>
116 </sl-sidebar-state-persist>  <div class="md:sl-hidden"> <div class="mobile-preferences sl-flex astro-wu23bvmt"> <div class="social-icons astro-wu23bvmt"> <a href="https://github.com/google-gemini/gemini-cli" rel="me" class="sl-flex astro-wy4te6ga"><span class="sr-only astro-wy4te6ga">GitHub</span><svg aria-hidden="true" class="astro-wy4te6ga astro-c6vsoqas" width="16" height="16" viewBox="0 0 24 24" fill="currentColor" style="--sl-icon-size: 1em;"><path d="M12 .3a12 12 0 0 0-3.8 23.38c.6.12.83-.26.83-.57L9 21.07c-3.34.72-4.04-1.61-4.04-1.61-.55-1.39-1.34-1.76-1.34-1.76-1.08-.74.09-.73.09-.73 1.2.09 1.83 1.24 1.83 1.24 1.08 1.83 2.81 1.3 3.5 1 .1-.78.42-1.31.76-1.61-2.67-.3-5.47-1.33-5.47-5.93 0-1.31.47-2.38 1.24-3.22-.14-.3-.54-1.52.1-3.18 0 0 1-.32 3.3 1.23a11.5 11.5 0 0 1 6 0c2.28-1.55 3.29-1.23 3.29-1.23.64 1.66.24 2.88.12 3.18a4.65 4.65 0 0 1 1.23 3.22c0 4.61-2.8 5.63-5.48 5.92.42.36.81 1.1.81 2.22l-.01 3.29c0 .31.2.69.82.57A12 12 0 0 0 12 .3Z"/></svg></a> </div> <starlight-theme-select>  <label style="--sl-select-width: 6.25em" class="astro-4yphtoen"> <span class="sr-only astro-4yphtoen">Select theme</span> <svg aria-hidden="true" class="icon label-icon astro-4yphtoen astro-c6vsoqas" width="16" height="16" viewBox="0 0 24 24" fill="currentColor" style="--sl-icon-size: 1em;"><path d="M21 14h-1V7a3 3 0 0 0-3-3H7a3 3 0 0 0-3 3v7H3a1 1 0 0 0-1 1v2a3 3 0 0 0 3 3h14a3 3 0 0 0 3-3v-2a1 1 0 0 0-1-1ZM6 7a1 1 0 0 1 1-1h10a1 1 0 0 1 1 1v7H6V7Zm14 10a1 1 0 0 1-1 1H5a1 1 0 0 1-1-1v-1h16v1Z"/></svg> <select autocomplete="off" class="astro-4yphtoen"> <option value="dark" class="astro-4yphtoen">Dark</option><option value="light" class="astro-4yphtoen">Light</option><option value="auto" selected class="astro-4yphtoen">Auto</option> </select> <svg aria-hidden="true" class="icon caret astro-4yphtoen astro-c6vsoqas" width="16" height="16" viewBox="0 0 24 24" fill="currentColor" style="--sl-icon-size: 1em;"><path d="M17 9.17a1 1 0 0 0-1.41 0L12 12.71 8.46 9.17a1 1 0 1 0-1.41 1.42l4.24 4.24a1.002 1.002 0 0 0 1.42 0L17 10.59a1.002 1.002 0 0 0 0-1.42Z"/></svg> </label>  </starlight-theme-select>  
116<script>
117	StarlightThemeProvider.updatePickers();
118</script>
118   </div>  </div></div><div hidden data-starlight-multi-sidebar-label="resources_tab"><sl-sidebar-state-persist data-hash="0xaq66q" class="astro-kku4brbg"> 
118<script aria-hidden="true">
119		(() => {
120			try {
121				if (!matchMedia('(min-width: 50em)').matches) return;
122				/** @type {HTMLElement | null} */
123				const target = document.querySelector('sl-sidebar-state-persist');
124				const state = JSON.parse(sessionStorage.getItem('sl-sidebar-state') || '0');
125				if (!target || !state || target.dataset.hash !== state.hash) return;
126				window._starlightScrollRestore = state.scroll;
127				customElements.define(
128					'sl-sidebar-restore',
129					class SidebarRestore extends HTMLElement {
130						connectedCallback() {
131							try {
132								const idx = parseInt(this.dataset.index || '');
133								const details = this.closest('details');
134								if (details && typeof state.open[idx] === 'boolean') details.open = state.open[idx];
135							} catch {}
136						}
137					}
138				);
139			} catch {}
140		})();
141	</script>
141  <ul class="top-level astro-3ii7xxms"> <li class="astro-3ii7xxms"> <details open class="astro-3ii7xxms"> <summary class="astro-3ii7xxms"> <span class="group-label astro-3ii7xxms"> <span class="large astro-3ii7xxms">Resources</span>  </span> <svg aria-hidden="true" class="caret astro-3ii7xxms astro-c6vsoqas" width="16" height="16" viewBox="0 0 24 24" fill="currentColor" style="--sl-icon-size: 1.25rem;"><path d="m14.83 11.29-4.24-4.24a1 1 0 1 0-1.42 1.41L12.71 12l-3.54 3.54a1 1 0 0 0 0 1.41 1 1 0 0 0 .71.29 1 1 0 0 0 .71-.29l4.24-4.24a1.002 1.002 0 0 0 0-1.42Z"/></svg> </summary> <sl-sidebar-restore data-index="11"></sl-sidebar-restore> <ul class="astro-3ii7xxms"> <li class="astro-3ii7xxms"> <a href="/docs/resources/faq/" aria-current="false" class="astro-3ii7xxms"> <span class="astro-3ii7xxms">FAQ</span>  </a> </li><li class="astro-3ii7xxms"> <a href="/docs/resources/quota-and-pricing/" aria-current="false" class="astro-3ii7xxms"> <span class="astro-3ii7xxms">Quota and pricing</span>  </a> </li><li class="astro-3ii7xxms"> <a href="/docs/resources/tos-privacy/" aria-current="false" class="astro-3ii7xxms"> <span class="astro-3ii7xxms">Terms and privacy</span>  </a> </li><li class="astro-3ii7xxms"> <a href="/docs/resources/troubleshooting/" aria-current="false" class="astro-3ii7xxms"> <span class="astro-3ii7xxms">Troubleshooting</span>  </a> </li><li class="astro-3ii7xxms"> <a href="/docs/resources/uninstall/" aria-current="false" class="astro-3ii7xxms"> <span class="astro-3ii7xxms">Uninstall</span>  </a> </li> </ul>  </details> </li> </ul>   
141<script aria-hidden="true">
142		(() => {
143			const scroller = document.getElementById('starlight__sidebar');
144			if (!window._starlightScrollRestore || !scroller) return;
145			scroller.scrollTop = window._starlightScrollRestore;
146			delete window._starlightScrollRestore;
147		})();
148	</script>
148 </sl-sidebar-state-persist>  <div class="md:sl-hidden"> <div class="mobile-preferences sl-flex astro-wu23bvmt"> <div class="social-icons astro-wu23bvmt"> <a href="https://github.com/google-gemini/gemini-cli" rel="me" class="sl-flex astro-wy4te6ga"><span class="sr-only astro-wy4te6ga">GitHub</span><svg aria-hidden="true" class="astro-wy4te6ga astro-c6vsoqas" width="16" height="16" viewBox="0 0 24 24" fill="currentColor" style="--sl-icon-size: 1em;"><path d="M12 .3a12 12 0 0 0-3.8 23.38c.6.12.83-.26.83-.57L9 21.07c-3.34.72-4.04-1.61-4.04-1.61-.55-1.39-1.34-1.76-1.34-1.76-1.08-.74.09-.73.09-.73 1.2.09 1.83 1.24 1.83 1.24 1.08 1.83 2.81 1.3 3.5 1 .1-.78.42-1.31.76-1.61-2.67-.3-5.47-1.33-5.47-5.93 0-1.31.47-2.38 1.24-3.22-.14-.3-.54-1.52.1-3.18 0 0 1-.32 3.3 1.23a11.5 11.5 0 0 1 6 0c2.28-1.55 3.29-1.23 3.29-1.23.64 1.66.24 2.88.12 3.18a4.65 4.65 0 0 1 1.23 3.22c0 4.61-2.8 5.63-5.48 5.92.42.36.81 1.1.81 2.22l-.01 3.29c0 .31.2.69.82.57A12 12 0 0 0 12 .3Z"/></svg></a> </div> <starlight-theme-select>  <label style="--sl-select-width: 6.25em" class="astro-4yphtoen"> <span class="sr-only astro-4yphtoen">Select theme</span> <svg aria-hidden="true" class="icon label-icon astro-4yphtoen astro-c6vsoqas" width="16" height="16" viewBox="0 0 24 24" fill="currentColor" style="--sl-icon-size: 1em;"><path d="M21 14h-1V7a3 3 0 0 0-3-3H7a3 3 0 0 0-3 3v7H3a1 1 0 0 0-1 1v2a3 3 0 0 0 3 3h14a3 3 0 0 0 3-3v-2a1 1 0 0 0-1-1ZM6 7a1 1 0 0 1 1-1h10a1 1 0 0 1 1 1v7H6V7Zm14 10a1 1 0 0 1-1 1H5a1 1 0 0 1-1-1v-1h16v1Z"/></svg> <select autocomplete="off" class="astro-4yphtoen"> <option value="dark" class="astro-4yphtoen">Dark</option><option value="light" class="astro-4yphtoen">Light</option><option value="auto" selected class="astro-4yphtoen">Auto</option> </select> <svg aria-hidden="true" class="icon caret astro-4yphtoen astro-c6vsoqas" width="16" height="16" viewBox="0 0 24 24" fill="currentColor" style="--sl-icon-size: 1em;"><path d="M17 9.17a1 1 0 0 0-1.41 0L12 12.71 8.46 9.17a1 1 0 1 0-1.41 1.42l4.24 4.24a1.002 1.002 0 0 0 1.42 0L17 10.59a1.002 1.002 0 0 0 0-1.42Z"/></svg> </label>  </starlight-theme-select>  
148<script>
149	StarlightThemeProvider.updatePickers();
150</script>
150   </div>  </div></div><div hidden data-starlight-multi-sidebar-label="releases_tab"><sl-sidebar-state-persist data-hash="19ufy8h" class="astro-kku4brbg"> 
150<script aria-hidden="true">
151		(() => {
152			try {
153				if (!matchMedia('(min-width: 50em)').matches) return;
154				/** @type {HTMLElement | null} */
155				const target = document.querySelector('sl-sidebar-state-persist');
156				const state = JSON.parse(sessionStorage.getItem('sl-sidebar-state') || '0');
157				if (!target || !state || target.dataset.hash !== state.hash) return;
158				window._starlightScrollRestore = state.scroll;
159				customElements.define(
160					'sl-sidebar-restore',
161					class SidebarRestore extends HTMLElement {
162						connectedCallback() {
163							try {
164								const idx = parseInt(this.dataset.index || '');
165								const details = this.closest('details');
166								if (details && typeof state.open[idx] === 'boolean') details.open = state.open[idx];
167							} catch {}
168						}
169					}
170				);
171			} catch {}
172		})();
173	</script>
173  <ul class="top-level astro-3ii7xxms"> <li class="astro-3ii7xxms"> <details open class="astro-3ii7xxms"> <summary class="astro-3ii7xxms"> <span class="group-label astro-3ii7xxms"> <span class="large astro-3ii7xxms">Releases</span>  </span> <svg aria-hidden="true" class="caret astro-3ii7xxms astro-c6vsoqas" width="16" height="16" viewBox="0 0 24 24" fill="currentColor" style="--sl-icon-size: 1.25rem;"><path d="m14.83 11.29-4.24-4.24a1 1 0 1 0-1.42 1.41L12.71 12l-3.54 3.54a1 1 0 0 0 0 1.41 1 1 0 0 0 .71.29 1 1 0 0 0 .71-.29l4.24-4.24a1.002 1.002 0 0 0 0-1.42Z"/></svg> </summary> <sl-sidebar-restore data-index="12"></sl-sidebar-restore> <ul class="astro-3ii7xxms"> <li class="astro-3ii7xxms"> <a href="/docs/changelogs/" aria-current="false" class="astro-3ii7xxms"> <span class="astro-3ii7xxms">Release notes</span>  </a> </li><li class="astro-3ii7xxms"> <a href="/docs/changelogs/latest/" aria-current="false" class="astro-3ii7xxms"> <span class="astro-3ii7xxms">Stable release</span>  </a> </li><li class="astro-3ii7xxms"> <a href="/docs/changelogs/preview/" aria-current="false" class="astro-3ii7xxms"> <span class="astro-3ii7xxms">Preview release</span>  </a> </li> </ul>  </details> </li> </ul>   
173<script aria-hidden="true">
174		(() => {
175			const scroller = document.getElementById('starlight__sidebar');
176			if (!window._starlightScrollRestore || !scroller) return;
177			scroller.scrollTop = window._starlightScrollRestore;
178			delete window._starlightScrollRestore;
179		})();
180	</script>
180 </sl-sidebar-state-persist>  <div class="md:sl-hidden"> <div class="mobile-preferences sl-flex astro-wu23bvmt"> <div class="social-icons astro-wu23bvmt"> <a href="https://github.com/google-gemini/gemini-cli" rel="me" class="sl-flex astro-wy4te6ga"><span class="sr-only astro-wy4te6ga">GitHub</span><svg aria-hidden="true" class="astro-wy4te6ga astro-c6vsoqas" width="16" height="16" viewBox="0 0 24 24" fill="currentColor" style="--sl-icon-size: 1em;"><path d="M12 .3a12 12 0 0 0-3.8 23.38c.6.12.83-.26.83-.57L9 21.07c-3.34.72-4.04-1.61-4.04-1.61-.55-1.39-1.34-1.76-1.34-1.76-1.08-.74.09-.73.09-.73 1.2.09 1.83 1.24 1.83 1.24 1.08 1.83 2.81 1.3 3.5 1 .1-.78.42-1.31.76-1.61-2.67-.3-5.47-1.33-5.47-5.93 0-1.31.47-2.38 1.24-3.22-.14-.3-.54-1.52.1-3.18 0 0 1-.32 3.3 1.23a11.5 11.5 0 0 1 6 0c2.28-1.55 3.29-1.23 3.29-1.23.64 1.66.24 2.88.12 3.18a4.65 4.65 0 0 1 1.23 3.22c0 4.61-2.8 5.63-5.48 5.92.42.36.81 1.1.81 2.22l-.01 3.29c0 .31.2.69.82.57A12 12 0 0 0 12 .3Z"/></svg></a> </div> <starlight-theme-select>  <label style="--sl-select-width: 6.25em" class="astro-4yphtoen"> <span class="sr-only astro-4yphtoen">Select theme</span> <svg aria-hidden="true" class="icon label-icon astro-4yphtoen astro-c6vsoqas" width="16" height="16" viewBox="0 0 24 24" fill="currentColor" style="--sl-icon-size: 1em;"><path d="M21 14h-1V7a3 3 0 0 0-3-3H7a3 3 0 0 0-3 3v7H3a1 1 0 0 0-1 1v2a3 3 0 0 0 3 3h14a3 3 0 0 0 3-3v-2a1 1 0 0 0-1-1ZM6 7a1 1 0 0 1 1-1h10a1 1 0 0 1 1 1v7H6V7Zm14 10a1 1 0 0 1-1 1H5a1 1 0 0 1-1-1v-1h16v1Z"/></svg> <select autocomplete="off" class="astro-4yphtoen"> <option value="dark" class="astro-4yphtoen">Dark</option><option value="light" class="astro-4yphtoen">Light</option><option value="auto" selected class="astro-4yphtoen">Auto</option> </select> <svg aria-hidden="true" class="icon caret astro-4yphtoen astro-c6vsoqas" width="16" height="16" viewBox="0 0 24 24" fill="currentColor" style="--sl-icon-size: 1em;"><path d="M17 9.17a1 1 0 0 0-1.41 0L12 12.71 8.46 9.17a1 1 0 1 0-1.41 1.42l4.24 4.24a1.002 1.002 0 0 0 1.42 0L17 10.59a1.002 1.002 0 0 0 0-1.42Z"/></svg> </label>  </starlight-theme-select>  
180<script>
181	StarlightThemeProvider.updatePickers();
182</script>
182   </div>  </div></div> </div> </div> </div> </nav> <!-- Main grows to push footer down --> <div class="main-frame astro-yriad4ts">   
182<script type="module">const a=document.getElementById("starlight__sidebar"),n=a?.querySelector("sl-sidebar-state-persist"),o="sl-sidebar-state",i=()=>{let t=[];const e=n?.dataset.hash||"";try{const s=sessionStorage.getItem(o),r=JSON.parse(s||"{}");Array.isArray(r.open)&&r.hash===e&&(t=r.open)}catch{}return{hash:e,open:t,scroll:a?.scrollTop||0}},c=t=>{try{sessionStorage.setItem(o,JSON.stringify(t))}catch{}},d=()=>c(i()),l=(t,e)=>{const s=i();s.open[e]=t,c(s)};n?.addEventListener("click",t=>{if(!(t.target instanceof Element))return;const e=t.target.closest("summary")?.closest("details");if(!e)return;const s=e.querySelector("sl-sidebar-restore"),r=parseInt(s?.dataset.index||"");isNaN(r)||l(!e.open,r)});addEventListener("visibilitychange",()=>{document.visibilityState==="hidden"&&d()});addEventListener("pageHide",d);</script>
182 <div class="lg:sl-flex astro-67yu43on"> <aside class="right-sidebar-container print:hidden astro-67yu43on"> <div class="right-sidebar astro-67yu43on"> 
182<script type="module" src="/_astro/MobileTableOfContents.astro_astro_type_script_index_0_lang.C181hMzK.js"></script>
182<script type="module" src="/_astro/TableOfContents.astro_astro_type_script_index_0_lang.CKWWgpjV.js"></script>
182<div class="lg:sl-hidden astro-pb3aqygn"><mobile-starlight-toc data-min-h="2" data-max-h="3" class="astro-doynk5tl"><nav aria-labelledby="starlight__on-this-page--mobile" class="astro-doynk5tl"><details id="starlight__mobile-toc" class="astro-doynk5tl"><summary id="starlight__on-this-page--mobile" class="sl-flex astro-doynk5tl"><span class="toggle sl-flex astro-doynk5tl">On this page<svg aria-hidden="true" class="caret astro-doynk5tl astro-c6vsoqas" width="16" height="16" viewBox="0 0 24 24" fill="currentColor" style="--sl-icon-size: 1rem;"><path d="m14.83 11.29-4.24-4.24a1 1 0 1 0-1.42 1.41L12.71 12l-3.54 3.54a1 1 0 0 0 0 1.41 1 1 0 0 0 .71.29 1 1 0 0 0 .71-.29l4.24-4.24a1.002 1.002 0 0 0 0-1.42Z"/></svg></span><span class="display-current astro-doynk5tl"></span></summary><div class="dropdown astro-doynk5tl"><ul class="isMobile astro-g2bywc46" style="--depth: 0;"> <li class="astro-g2bywc46" style="--depth: 0;"> <a href="#_top" class="astro-g2bywc46" style="--depth: 0;"> <span class="astro-g2bywc46" style="--depth: 0;">Introduction</span> </a>  </li><li class="astro-g2bywc46" style="--depth: 0;"> <a href="#install" class="astro-g2bywc46" style="--depth: 0;"> <span class="astro-g2bywc46" style="--depth: 0;">Install</span> </a>  </li><li class="astro-g2bywc46" style="--depth: 0;"> <a href="#get-started" class="astro-g2bywc46" style="--depth: 0;"> <span class="astro-g2bywc46" style="--depth: 0;">Get started</span> </a>  </li><li class="astro-g2bywc46" style="--depth: 0;"> <a href="#use-gemini-cli" class="astro-g2bywc46" style="--depth: 0;"> <span class="astro-g2bywc46" style="--depth: 0;">Use Gemini CLI</span> </a>  </li><li class="astro-g2bywc46" style="--depth: 0;"> <a href="#features" class="astro-g2bywc46" style="--depth: 0;"> <span class="astro-g2bywc46" style="--depth: 0;">Features</span> </a>  </li><li class="astro-g2bywc46" style="--depth: 0;"> <a href="#configuration" class="astro-g2bywc46" style="--depth: 0;"> <span class="astro-g2bywc46" style="--depth: 0;">Configuration</span> </a>  </li><li class="astro-g2bywc46" style="--depth: 0;"> <a href="#reference" class="astro-g2bywc46" style="--depth: 0;"> <span class="astro-g2bywc46" style="--depth: 0;">Reference</span> </a>  </li><li class="astro-g2bywc46" style="--depth: 0;"> <a href="#resources" class="astro-g2bywc46" style="--depth: 0;"> <span class="astro-g2bywc46" style="--depth: 0;">Resources</span> </a>  </li><li class="astro-g2bywc46" style="--depth: 0;"> <a href="#development" class="astro-g2bywc46" style="--depth: 0;"> <span class="astro-g2bywc46" style="--depth: 0;">Development</span> </a>  </li><li class="astro-g2bywc46" style="--depth: 0;"> <a href="#releases" class="astro-g2bywc46" style="--depth: 0;"> <span class="astro-g2bywc46" style="--depth: 0;">Releases</span> </a>  </li> </ul> </div></details></nav></mobile-starlight-toc></div><div class="right-sidebar-panel sl-hidden lg:sl-block astro-pb3aqygn"><div class="sl-container astro-pb3aqygn"><starlight-toc data-min-h="2" data-max-h="3"><nav aria-labelledby="starlight__on-this-page"><h2 id="starlight__on-this-page">On this page</h2><ul class="astro-g2bywc46" style="--depth: 0;"> <li class="astro-g2bywc46" style="--depth: 0;"> <a href="#_top" class="astro-g2bywc46" style="--depth: 0;"> <span class="astro-g2bywc46" style="--depth: 0;">Introduction</span> </a>  </li><li class="astro-g2bywc46" style="--depth: 0;"> <a href="#install" class="astro-g2bywc46" style="--depth: 0;"> <span class="astro-g2bywc46" style="--depth: 0;">Install</span> </a>  </li><li class="astro-g2bywc46" style="--depth: 0;"> <a href="#get-started" class="astro-g2bywc46" style="--depth: 0;"> <span class="astro-g2bywc46" style="--depth: 0;">Get started</span> </a>  </li><li class="astro-g2bywc46" style="--depth: 0;"> <a href="#use-gemini-cli" class="astro-g2bywc46" style="--depth: 0;"> <span class="astro-g2bywc46" style="--depth: 0;">Use Gemini CLI</span> </a>  </li><li class="astro-g2bywc46" style="--depth: 0;"> <a href="#features" class="astro-g2bywc46" style="--depth: 0;"> <span class="astro-g2bywc46" style="--depth: 0;">Features</span> </a>  </li><li class="astro-g2bywc46" style="--depth: 0;"> <a href="#configuration" class="astro-g2bywc46" style="--depth: 0;"> <span class="astro-g2bywc46" style="--depth: 0;">Configuration</span> </a>  </li><li class="astro-g2bywc46" style="--depth: 0;"> <a href="#reference" class="astro-g2bywc46" style="--depth: 0;"> <span class="astro-g2bywc46" style="--depth: 0;">Reference</span> </a>  </li><li class="astro-g2bywc46" style="--depth: 0;"> <a href="#resources" class="astro-g2bywc46" style="--depth: 0;"> <span class="astro-g2bywc46" style="--depth: 0;">Resources</span> </a>  </li><li class="astro-g2bywc46" style="--depth: 0;"> <a href="#development" class="astro-g2bywc46" style="--depth: 0;"> <span class="astro-g2bywc46" style="--depth: 0;">Development</span> </a>  </li><li class="astro-g2bywc46" style="--depth: 0;"> <a href="#releases" class="astro-g2bywc46" style="--depth: 0;"> <span class="astro-g2bywc46" style="--depth: 0;">Releases</span> </a>  </li> </ul> </nav></starlight-toc></div></div> </div> </aside> <div class="main-pane astro-67yu43on">
182  <main data-pagefind-body class="astro-bguv2lll" lang="en" dir="ltr">   
182<script type="module">class i{constructor(){this.init()}init(){document.readyState==="loading"?document.addEventListener("DOMContentLoaded",()=>this.setupEventListeners()):this.setupEventListeners()}setupEventListeners(){const t=document.getElementById("copy-markdown-btn");t&&t.addEventListener("click",()=>this.copyMarkdown())}async copyMarkdown(){const t=document.getElementById("copy-markdown-btn");if(t)try{this.setButtonState(t,"copying");const e=`${window.location.pathname.replace(/\/$/,"")}.md`,o=await fetch(e);if(!o.ok)throw new Error(`Failed to fetch markdown: ${o.status}`);const a=await o.text();await this.copyToClipboard(a),this.setButtonState(t,"success"),setTimeout(()=>{this.setButtonState(t,"default")},2e3)}catch(n){console.error("Failed to copy markdown:",n),this.setButtonState(t,"error"),setTimeout(()=>{this.setButtonState(t,"default")},2e3)}}getCurrentLanguage(){return document.documentElement.getAttribute("data-genkit-lang")||"js"}async copyToClipboard(t){if(navigator.clipboard&&window.isSecureContext)await navigator.clipboard.writeText(t);else throw new Error("Clipboard API not available.")}setButtonState(t,n){const s=t.querySelector(".button-text"),e=t.querySelector(".success-text");switch(t.classList.remove("copying","success","error"),n){case"copying":t.classList.add("copying"),s&&(s.style.display="none"),e&&(e.textContent="Copying...",e.style.display="inline");break;case"success":t.classList.add("success"),s&&(s.style.display="none"),e&&(e.textContent="Copied!",e.style.display="inline");break;case"error":t.classList.add("error"),s&&(s.style.display="none"),e&&(e.textContent="Error",e.style.display="inline");break;default:s&&(s.style.display="inline"),e&&(e.style.display="none");break}}}new i;</script>
182 <div class="content-panel astro-7nkwcw3z"> <div class="sl-container astro-7nkwcw3z"> <div class="flex items-center page-title astro-guvttfii"> <h1 id="_top" class="flex-1 astro-guvttfii"> Gemini CLI documentation </h1> <div class="mt-4 astro-guvttfii"> <button id="copy-markdown-btn" class="copy-markdown-button astro-guvttfii astro-ym2cbydy" type="button" aria-label="Copy page content as markdown for selected language" title="Copy as Markdown"> <svg width="16" height="16" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round" class="astro-ym2cbydy"> <rect width="14" height="14" x="8" y="8" rx="2" ry="2" class="astro-ym2cbydy"></rect> <path d="m4 16c-1.1 0-2-.9-2-2V4c0-1.1.9-2 2-2h10c1.1 0 2 .9 2 2" class="astro-ym2cbydy"></path> </svg> <span class="button-text astro-ym2cbydy">Copy as Markdown</span> <span class="success-text astro-ym2cbydy" style="display: none;">Copied!</span> </button>   </div> </div>  </div> </div>  <div class="content-panel astro-7nkwcw3z"> <div class="sl-container astro-7nkwcw3z"> <div class="sl-markdown-content"> <p>Gemini CLI brings the power of Gemini models directly into your terminal. Use it
183to understand code, automate tasks, and build workflows with your local project
184context.</p>
185<div class="sl-heading-wrapper level-h2"><h2 id="install">Install</h2><a class="sl-anchor-link" href="#install"><span aria-hidden="true" class="sl-anchor-icon"><svg width="16" height="16" viewBox="0 0 24 24"><path fill="currentcolor" d="m12.11 15.39-3.88 3.88a2.52 2.52 0 0 1-3.5 0 2.47 2.47 0 0 1 0-3.5l3.88-3.88a1 1 0 0 0-1.42-1.42l-3.88 3.89a4.48 4.48 0 0 0 6.33 6.33l3.89-3.88a1 1 0 1 0-1.42-1.42Zm8.58-12.08a4.49 4.49 0 0 0-6.33 0l-3.89 3.88a1 1 0 0 0 1.42 1.42l3.88-3.88a2.52 2.52 0 0 1 3.5 0 2.47 2.47 0 0 1 0 3.5l-3.88 3.88a1 1 0 1 0 1.42 1.42l3.88-3.89a4.49 4.49 0 0 0 0-6.33ZM8.83 15.17a1 1 0 0 0 1.1.22 1 1 0 0 0 .32-.22l4.92-4.92a1 1 0 0 0-1.42-1.42l-4.92 4.92a1 1 0 0 0 0 1.42Z"></path></svg></span><span class="sr-only">Section titled “Install”</span></a></div>
186<div class="expressive-code"><link rel="stylesheet" href="/_astro/ec.me98n.css">
186<script type="module" src="/_astro/ec.p1z7b.js"></script>
186<figure class="frame is-terminal not-content"><figcaption class="header"><span class="title"></span><span class="sr-only">Terminal window</span></figcaption><pre data-language="bash"><code><div class="ec-line"><div class="code"><span style="--0:#BD9CFE;--1:#6F4CDE">npm</span><span style="--0:#E1DFDF;--1:#292929"> </span><span style="--0:#77D5A3;--1:#007847">install</span><span style="--0:#E1DFDF;--1:#292929"> </span><span style="--0:#8DA8FF;--1:#3252B8">-g</span><span style="--0:#E1DFDF;--1:#292929"> </span><span style="--0:#77D5A3;--1:#007847">@google/gemini-cli</span></div></div></code></pre><div class="copy"><button title="Copy to clipboard" data-copied="Copied!" data-code="npm install -g @google/gemini-cli"><div></div></button></div></figure></div>
187<div class="sl-heading-wrapper level-h2"><h2 id="get-started">Get started</h2><a class="sl-anchor-link" href="#get-started"><span aria-hidden="true" class="sl-anchor-icon"><svg width="16" height="16" viewBox="0 0 24 24"><path fill="currentcolor" d="m12.11 15.39-3.88 3.88a2.52 2.52 0 0 1-3.5 0 2.47 2.47 0 0 1 0-3.5l3.88-3.88a1 1 0 0 0-1.42-1.42l-3.88 3.89a4.48 4.48 0 0 0 6.33 6.33l3.89-3.88a1 1 0 1 0-1.42-1.42Zm8.58-12.08a4.49 4.49 0 0 0-6.33 0l-3.89 3.88a1 1 0 0 0 1.42 1.42l3.88-3.88a2.52 2.52 0 0 1 3.5 0 2.47 2.47 0 0 1 0 3.5l-3.88 3.88a1 1 0 1 0 1.42 1.42l3.88-3.89a4.49 4.49 0 0 0 0-6.33ZM8.83 15.17a1 1 0 0 0 1.1.22 1 1 0 0 0 .32-.22l4.92-4.92a1 1 0 0 0-1.42-1.42l-4.92 4.92a1 1 0 0 0 0 1.42Z"></path></svg></span><span class="sr-only">Section titled “Get started”</span></a></div>
188<p>Jump in to Gemini CLI.</p>
189<ul>
190<li><strong><a href="/docs/get-started">Quickstart</a>:</strong> Your first session with Gemini CLI.</li>
191<li><strong><a href="/docs/get-started/installation">Installation</a>:</strong> How to install Gemini CLI
192on your system.</li>
193<li><strong><a href="/docs/get-started/authentication">Authentication</a>:</strong> Setup instructions for
194personal and enterprise accounts.</li>
195<li><strong><a href="/docs/cli/cli-reference">CLI cheatsheet</a>:</strong> A quick reference for common
196commands and options.</li>
197<li><strong><a href="/docs/get-started/gemini-3">Gemini 3 on Gemini CLI</a>:</strong> Learn about Gemini 3
198support in Gemini CLI.</li>
199</ul>
200<div class="sl-heading-wrapper level-h2"><h2 id="use-gemini-cli">Use Gemini CLI</h2><a class="sl-anchor-link" href="#use-gemini-cli"><span aria-hidden="true" class="sl-anchor-icon"><svg width="16" height="16" viewBox="0 0 24 24"><path fill="currentcolor" d="m12.11 15.39-3.88 3.88a2.52 2.52 0 0 1-3.5 0 2.47 2.47 0 0 1 0-3.5l3.88-3.88a1 1 0 0 0-1.42-1.42l-3.88 3.89a4.48 4.48 0 0 0 6.33 6.33l3.89-3.88a1 1 0 1 0-1.42-1.42Zm8.58-12.08a4.49 4.49 0 0 0-6.33 0l-3.89 3.88a1 1 0 0 0 1.42 1.42l3.88-3.88a2.52 2.52 0 0 1 3.5 0 2.47 2.47 0 0 1 0 3.5l-3.88 3.88a1 1 0 1 0 1.42 1.42l3.88-3.89a4.49 4.49 0 0 0 0-6.33ZM8.83 15.17a1 1 0 0 0 1.1.22 1 1 0 0 0 .32-.22l4.92-4.92a1 1 0 0 0-1.42-1.42l-4.92 4.92a1 1 0 0 0 0 1.42Z"></path></svg></span><span class="sr-only">Section titled “Use Gemini CLI”</span></a></div>
201<p>User-focused guides and tutorials for daily development workflows.</p>
202<ul>
203<li><strong><a href="/docs/cli/tutorials/file-management">File management</a>:</strong> How to work with
204local files and directories.</li>
205<li><strong><a href="/docs/cli/tutorials/skills-getting-started">Get started with Agent skills</a>:</strong>
206Getting started with specialized expertise.</li>
207<li><strong><a href="/docs/cli/tutorials/memory-management">Manage context and memory</a>:</strong>
208Managing persistent instructions and facts.</li>
209<li><strong><a href="/docs/cli/tutorials/shell-commands">Execute shell commands</a>:</strong> Executing
210system commands safely.</li>
211<li><strong><a href="/docs/cli/tutorials/session-management">Manage sessions and history</a>:</strong>
212Resuming, managing, and rewinding conversations.</li>
213<li><strong><a href="/docs/cli/tutorials/task-planning">Plan tasks with todos</a>:</strong> Using todos for
214complex workflows.</li>
215<li><strong><a href="/docs/cli/tutorials/web-tools">Web search and fetch</a>:</strong> Searching and
216fetching content from the web.</li>
217<li><strong><a href="/docs/cli/tutorials/mcp-setup">Set up an MCP server</a>:</strong> Set up an MCP
218server.</li>
219<li><strong><a href="/docs/cli/tutorials/automation">Automate tasks</a>:</strong> Automate tasks.</li>
220</ul>
221<div class="sl-heading-wrapper level-h2"><h2 id="features">Features</h2><a class="sl-anchor-link" href="#features"><span aria-hidden="true" class="sl-anchor-icon">
221<svg width="16" height="16" viewBox="0 0 24 24"><path fill="currentcolor" d="m12.11 15.39-3.88 3.88a2.52 2.52 0 0 1-3.5 0 2.47 2.47 0 0 1 0-3.5l3.88-3.88a1 1 0 0 0-1.42-1.42l-3.88 3.89a4.48 4.48 0 0 0 6.33 6.33l3.89-3.88a1 1 0 1 0-1.42-1.42Zm8.58-12.08a4.49 4.49 0 0 0-6.33 0l-3.89 3.88a1 1 0 0 0 1.42 1.42l3.88-3.88a2.52 2.52 0 0 1 3.5 0 2.47 2.47 0 0 1 0 3.5l-3.88 3.88a1 1 0 1 0 1.42 1.42l3.88-3.89a4.49 4.49 0 0 0 0-6.33ZM8.83 15.17a1 1 0 0 0 1.1.22 1 1 0 0 0 .32-.22l4.92-4.92a1 1 0 0 0-1.42-1.42l-4.92 4.92a1 1 0 0 0 0 1.42Z"></path></svg></span><span class="sr-only">Section titled “Features”</span></a></div>
222<p>Technical documentation for each capability of Gemini CLI.</p>
223<ul>
224<li><strong><a href="/docs/extensions">Extensions</a>:</strong> Extend Gemini CLI with new tools and
225capabilities.</li>
226<li><strong><a href="/docs/cli/skills">Agent Skills</a>:</strong> Use specialized agents for specific
227tasks.</li>
228<li><strong><a href="/docs/cli/checkpointing">Checkpointing</a>:</strong> Automatic session snapshots.</li>
229<li><strong><a href="/docs/cli/headless">Headless mode</a>:</strong> Programmatic and scripting interface.</li>
230<li><strong><a href="/docs/hooks">Hooks</a>:</strong> Customize Gemini CLI behavior with scripts.</li>
231<li><strong><a href="/docs/ide-integration">IDE integration</a>:</strong> Integrate Gemini CLI with
232your favorite IDE.</li>
233<li><strong><a href="/docs/tools/mcp-server">MCP servers</a>:</strong> Connect to and use remote agents.</li>
234<li><strong><a href="/docs/cli/model-routing">Model routing</a>:</strong> Automatic fallback resilience.</li>
235<li><strong><a href="/docs/cli/model">Model selection</a>:</strong> Choose the best model for your needs.</li>
236<li><strong><a href="/docs/cli/plan-mode">Plan mode 🔬</a>:</strong> Use a safe, read-only mode for
237planning complex changes.</li>
238<li><strong><a href="/docs/core/subagents">Subagents 🔬</a>:</strong> Using specialized agents for specific
239tasks.</li>
240<li><strong><a href="/docs/core/remote-agents">Remote subagents 🔬</a>:</strong> Connecting to and using
241remote agents.</li>
242<li><strong><a href="/docs/cli/rewind">Rewind</a>:</strong> Rewind and replay sessions.</li>
243<li><strong><a href="/docs/cli/sandbox">Sandboxing</a>:</strong> Isolate tool execution.</li>
244<li><strong><a href="/docs/cli/settings">Settings</a>:</strong> Full configuration reference.</li>
245<li><strong><a href="/docs/cli/telemetry">Telemetry</a>:</strong> Usage and performance metric details.</li>
246<li><strong><a href="/docs/cli/token-caching">Token caching</a>:</strong> Performance optimization.</li>
247</ul>
248<div class="sl-heading-wrapper level-h2"><h2 id="configuration">Configuration</h2><a class="sl-anchor-link" href="#configuration"><span aria-hidden="true" class="sl-anchor-icon"><svg width="16" height="16" viewBox="0 0 24 24"><path fill="currentcolor" d="m12.11 15.39-3.88 3.88a2.52 2.52 0 0 1-3.5 0 2.47 2.47 0 0 1 0-3.5l3.88-3.88a1 1 0 0 0-1.42-1.42l-3.88 3.89a4.48 4.48 0 0 0 6.33 6.33l3.89-3.88a1 1 0 1 0-1.42-1.42Zm8.58-12.08a4.49 4.49 0 0 0-6.33 0l-3.89 3.88a1 1 0 0 0 1.42 1.42l3.88-3.88a2.52 2.52 0 0 1 3.5 0 2.47 2.47 0 0 1 0 3.5l-3.88 3.88a1 1 0 1 0 1.42 1.42l3.88-3.89a4.49 4.49 0 0 0 0-6.33ZM8.83 15.17a1 1 0 0 0 1.1.22 1 1 0 0 0 .32-.22l4.92-4.92a1 1 0 0 0-1.42-1.42l-4.92 4.92a1 1 0 0 0 0 1.42Z"></path></svg></span><span class="sr-only">Section titled “Configuration”</span></a></div>
249<p>Settings and customization options for Gemini CLI.</p>
250<ul>
251<li><strong><a href="/docs/cli/custom-commands">Custom commands</a>:</strong> Personalized shortcuts.</li>
252<li><strong><a href="/docs/cli/enterprise">Enterprise configuration</a>:</strong> Professional environment
253controls.</li>
254<li><strong><a href="/docs/cli/gemini-ignore">Ignore files (.geminiignore)</a>:</strong> Exclusion pattern
255reference.</li>
256<li><strong><a href="/docs/cli/generation-settings">Model configuration</a>:</strong> Fine-tune generation
257parameters like temperature and thinking budget.</li>
258<li><strong><a href="/docs/cli/gemini-md">Project context (GEMINI.md)</a>:</strong> Technical hierarchy of
259context files.</li>
260<li><strong><a href="/docs/cli/system-prompt">System prompt override</a>:</strong>
260 Instruction replacement
261logic.</li>
262<li><strong><a href="/docs/cli/themes">Themes</a>:</strong> UI personalization technical guide.</li>
263<li><strong><a href="/docs/cli/trusted-folders">Trusted folders</a>:</strong> Security permission logic.</li>
264</ul>
265<div class="sl-heading-wrapper level-h2"><h2 id="reference">Reference</h2><a class="sl-anchor-link" href="#reference"><span aria-hidden="true" class="sl-anchor-icon"><svg width="16" height="16" viewBox="0 0 24 24"><path fill="currentcolor" d="m12.11 15.39-3.88 3.88a2.52 2.52 0 0 1-3.5 0 2.47 2.47 0 0 1 0-3.5l3.88-3.88a1 1 0 0 0-1.42-1.42l-3.88 3.89a4.48 4.48 0 0 0 6.33 6.33l3.89-3.88a1 1 0 1 0-1.42-1.42Zm8.58-12.08a4.49 4.49 0 0 0-6.33 0l-3.89 3.88a1 1 0 0 0 1.42 1.42l3.88-3.88a2.52 2.52 0 0 1 3.5 0 2.47 2.47 0 0 1 0 3.5l-3.88 3.88a1 1 0 1 0 1.42 1.42l3.88-3.89a4.49 4.49 0 0 0 0-6.33ZM8.83 15.17a1 1 0 0 0 1.1.22 1 1 0 0 0 .32-.22l4.92-4.92a1 1 0 0 0-1.42-1.42l-4.92 4.92a1 1 0 0 0 0 1.42Z"></path></svg></span><span class="sr-only">Section titled “Reference”</span></a></div>
266<p>Deep technical documentation and API specifications.</p>
267<ul>
268<li><strong><a href="/docs/reference/commands">Command reference</a>:</strong> Detailed slash command
269guide.</li>
270<li><strong><a href="/docs/reference/configuration">Configuration reference</a>:</strong> Settings and
271environment variables.</li>
272<li><strong><a href="/docs/reference/keyboard-shortcuts">Keyboard shortcuts</a>:</strong> Productivity
273tips.</li>
274<li><strong><a href="/docs/reference/memport">Memory import processor</a>:</strong> How Gemini CLI
275processes memory from various sources.</li>
276<li><strong><a href="/docs/reference/policy-engine">Policy engine</a>:</strong> Fine-grained execution
277control.</li>
278<li><strong><a href="/docs/reference/tools">Tools reference</a>:</strong> Information on how tools are
279defined, registered, and used.</li>
280</ul>
281<div class="sl-heading-wrapper level-h2"><h2 id="resources">Resources</h2><a class="sl-anchor-link" href="#resources"><span aria-hidden="true" class="sl-anchor-icon"><svg width="16" height="16" viewBox="0 0 24 24"><path fill="currentcolor" d="m12.11 15.39-3.88 3.88a2.52 2.52 0 0 1-3.5 0 2.47 2.47 0 0 1 0-3.5l3.88-3.88a1 1 0 0 0-1.42-1.42l-3.88 3.89a4.48 4.48 0 0 0 6.33 6.33l3.89-3.88a1 1 0 1 0-1.42-1.42Zm8.58-12.08a4.49 4.49 0 0 0-6.33 0l-3.89 3.88a1 1 0 0 0 1.42 1.42l3.88-3.88a2.52 2.52 0 0 1 3.5 0 2.47 2.47 0 0 1 0 3.5l-3.88 3.88a1 1 0 1 0 1.42 1.42l3.88-3.89a4.49 4.49 0 0 0 0-6.33ZM8.83 15.17a1 1 0 0 0 1.1.22 1 1 0 0 0 .32-.22l4.92-4.92a1 1 0 0 0-1.42-1.42l-4.92 4.92a1 1 0 0 0 0 1.42Z"></path></svg></span><span class="sr-only">Section titled “Resources”</span></a></div>
282<p>Support, release history, and legal information.</p>
283<ul>
284<li><strong><a href="/docs/resources/faq">FAQ</a>:</strong> Answers to frequently asked questions.</li>
285<li><strong><a href="/docs/resources/quota-and-pricing">Quota and pricing</a>:</strong> Limits and billing
286details.</li>
287<li><strong><a href="/docs/resources/tos-privacy">Terms and privacy</a>:</strong> Official notices and
288terms.</li>
289<li><strong><a href="/docs/resources/troubleshooting">Troubleshooting</a>:</strong> Common issues and
290solutions.</li>
291<li><strong><a href="/docs/resources/uninstall">Uninstall</a>:</strong> How to uninstall Gemini CLI.</li>
292</ul>
293<div class="sl-heading-wrapper level-h2"><h2 id="development">Development</h2><a class="sl-anchor-link" href="#development"><span aria-hidden="true" class="sl-anchor-icon"><svg width="16" height="16" viewBox="0 0 24 24"><path fill="currentcolor" d="m12.11 15.39-3.88 3.88a2.52 2.52 0 0 1-3.5 0 2.47 2.47 0 0 1 0-3.5l3.88-3.88a1 1 0 0 0-1.42-1.42l-3.88 3.89a4.48 4.48 0 0 0 6.33 6.33l3.89-3.88a1 1 0 1 0-1.42-1.42Zm8.58-12.08a4.49 4.49 0 0 0-6.33 0l-3.89 3.88a1 1 0 0 0 1.42 1.42l3.88-3.88a2.52 2.52 0 0 1 3.5 0 2.47 2.47 0 0 1 0 3.5l-3.88 3.88a1 1 0 1 0 1.42 1.42l3.88-3.89a4.49 4.49 0 0 0 0-6.33ZM8.83 15.17a1 1 0 0 0 1.1.22 1 1 0 0 0 .32-.22l4.92-4.92a1 1 0 0 0-1.42-1.42l-4.92 4.92a1 1 0 0 0 0 1.42Z"></path></svg></span><span class="sr-only">Section titled “Development”</span></a></div>
294<ul>
295<li><strong><a href="/docs/contributing">
295Contribution guide</a>:</strong> How to contribute to Gemini CLI.</li>
296<li><strong><a href="/docs/integration-tests">Integration testing</a>:</strong> Running integration tests.</li>
297<li><strong><a href="/docs/issue-and-pr-automation">Issue and PR automation</a>:</strong> Automation for
298issues and pull requests.</li>
299<li><strong><a href="/docs/local-development">Local development</a>:</strong> Setting up a local
300development environment.</li>
301<li><strong><a href="/docs/npm">NPM package structure</a>:</strong> The structure of the NPM packages.</li>
302</ul>
303<div class="sl-heading-wrapper level-h2"><h2 id="releases">Releases</h2><a class="sl-anchor-link" href="#releases"><span aria-hidden="true" class="sl-anchor-icon"><svg width="16" height="16" viewBox="0 0 24 24"><path fill="currentcolor" d="m12.11 15.39-3.88 3.88a2.52 2.52 0 0 1-3.5 0 2.47 2.47 0 0 1 0-3.5l3.88-3.88a1 1 0 0 0-1.42-1.42l-3.88 3.89a4.48 4.48 0 0 0 6.33 6.33l3.89-3.88a1 1 0 1 0-1.42-1.42Zm8.58-12.08a4.49 4.49 0 0 0-6.33 0l-3.89 3.88a1 1 0 0 0 1.42 1.42l3.88-3.88a2.52 2.52 0 0 1 3.5 0 2.47 2.47 0 0 1 0 3.5l-3.88 3.88a1 1 0 1 0 1.42 1.42l3.88-3.89a4.49 4.49 0 0 0 0-6.33ZM8.83 15.17a1 1 0 0 0 1.1.22 1 1 0 0 0 .32-.22l4.92-4.92a1 1 0 0 0-1.42-1.42l-4.92 4.92a1 1 0 0 0 0 1.42Z"></path></svg></span><span class="sr-only">Section titled “Releases”</span></a></div>
304<ul>
305<li><strong><a href="/docs/changelogs">Release notes</a>:</strong> Release notes for all versions.</li>
306<li><strong><a href="/docs/changelogs/latest">Stable release</a>:</strong> The latest stable release.</li>
307<li><strong><a href="/docs/changelogs/preview">Preview release</a>:</strong> The latest preview release.</li>
308</ul> </div> <div class="starlight-footer astro-nixdnp5i"> <div class="last-updated astro-asuirehi"><svg aria-hidden="true" width="16" height="16" viewBox="0 0 24 24" fill="currentColor" class="calendar-icon astro-asuirehi"><path d="M19 4h-1V2h-2v2H8V2H6v2H5c-1.11 0-1.99.9-1.99 2L3 20a2 2 0 0 0 2 2h14c1.1 0 2-.9 2-2V6c0-1.1-.9-2-2-2zm0 16H5V10h14v10zm0-12H5V6h14v2zm-7 5h5v5h-5v-5z" class="astro-asuirehi"></path></svg><span class="astro-asuirehi">Last updated: <time datetime="2026-04-17T18:07:07.000Z" class="astro-asuirehi">Apr 17, 2026</time></span></div> </div>  </div> </div>   </main> </div> </div>   </div> <div id="cookie-notice-wrapper" class="hidden astro-uz2wdcl7"> <div class="cookie-notice-container fixed bottom-0 left-0 right-0 flex justify-center z-50 astro-uz2wdcl7"> <div class="cookie-notice text-sm bg-[var(--sl-color-bg)]/50 backdrop-blur-sm m-2 p-3 rounded-lg flex max-sm:flex-col items-center border border-[var(--sl-color-white)]/20 astro-uz2wdcl7"> <div class="mr-2 astro-uz2wdcl7">
309This website uses <a href="https://policies.google.com/technologies/cookies" class="underline text-[var(--sl-color-white)]/70 astro-uz2wdcl7" target="_blank">cookies</a> from Google to deliver and enhance the quality of its services and to analyze
310        traffic.
311</div> <button id="cookie-ack-button" class="font-bold text-nowrap px-2 py-1 border rounded bg-[var(--sl-color-bg)]/80 text-[var(--sl-color-white)]/70 border-[var(--sl-color-white)]/30 astro-uz2wdcl7">
312I understand.
313</button> </div> </div> </div> 
313<script type="module">const e=document.getElementById("cookie-notice-wrapper"),t="__cookieAck";e&&localStorage.getItem(t)!=="true"&&e.classList.remove("hidden");const o=document.getElementById("cookie-ack-button");o?.addEventListener("click",()=>{localStorage.setItem(t,"true"),e&&(e.style.display="none")});</script>
313  <!-- Footer at bottom of .page flex container --> <footer class="site-footer astro-yriad4ts theme-aware astro-sz7xmlte"> <div class="footer-content astro-sz7xmlte"> <div class="logos astro-sz7xmlte"> <img class="logo-light astro-sz7xmlte" src="/assets/Google.svg" alt="Google logo" width="64.216" height="21"> <img class="logo-dark astro-sz7xmlte" src="/assets/Google-dark.svg" alt="Google logo" width="64.216" height="21"> <img class="logo-light fordev-logo astro-sz7xmlte" src="/assets/fordevelopers.svg" alt="For Developers logo" width="122.678" height="17.583"> <img class="logo-dark fordev-logo astro-sz7xmlte" src="/assets/fordevelopers-dark.svg" alt="For Developers logo" width="122.678" height="17.583"> </div> <div class="footer-links astro-sz7xmlte"> <a href="/terms" class="tos-link astro-sz7xmlte" target="_blank" rel="noopener noreferrer">Terms</a> <span class="divider astro-sz7xmlte">|</span> <a href="https://policies.google.com/privacy" class="tos-link astro-sz7xmlte" target="_blank" rel="noopener noreferrer">Privacy</a> </div> </div> </footer>  </div>  </body></html>

Line numbers count LF bytes from the start of the resource, as the search results do. Vendor segments are library code the classifier recognised; they are stored but not indexed. Bytes are shown as Latin1 characters, one per byte.