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="{"placeholder":"Search"}"> <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.