| title | Gemini CLI settings (`/settings` command) | |||||
|---|---|---|---|---|---|---|
| url | https://geminicli.com/docs/cli/settings | |||||
| source | crawler | |||||
| fetched_at | 2026-01-13 19:15:30 -0300 | |||||
| rendered_js | false | |||||
| word_count | 699 | |||||
| summary | This document details the configuration settings for the Gemini CLI, explaining how to manage UI preferences, keybindings, accessibility, and other features through the `/settings` command or by directly editing the `settings.json` file. | |||||
| tags |
|
|||||
| category | reference |
Control your Gemini CLI experience with the /settings command. The /settings command opens a dialog to view and edit all your Gemini CLI settings, including your UI experience, keybindings, and accessibility features.
Your Gemini CLI settings are stored in a settings.json file. In addition to using the /settings command, you can also edit them in one of the following locations:
- User settings:
~/.gemini/settings.json - Workspace settings:
your-project/.gemini/settings.json
Note: Workspace settings override user settings.
Section titled “Settings reference”
Here is a list of all the available settings, grouped by category and ordered as they appear in the UI.
UI LabelSettingDescriptionDefaultPreview Features (e.g., models)general.previewFeaturesEnable preview features (e.g., preview models).falseVim Modegeneral.vimModeEnable Vim keybindingsfalseDisable Auto Updategeneral.disableAutoUpdateDisable automatic updatesfalseEnable Prompt Completiongeneral.enablePromptCompletionEnable AI-powered prompt completion suggestions while typing.falseDebug Keystroke Logginggeneral.debugKeystrokeLoggingEnable debug logging of keystrokes to the console.falseEnable Session Cleanupgeneral.sessionRetention.enabledEnable automatic session cleanupfalse
UI LabelSettingDescriptionDefaultOutput Formatoutput.formatThe format of the CLI output. Can be text or json."text"
UI LabelSettingDescriptionDefaultHide Window Titleui.hideWindowTitleHide the window title barfalseShow Thoughts in Titleui.showStatusInTitleShow Gemini CLI model thoughts in the terminal window title during the working phasefalseDynamic Window Titleui.dynamicWindowTitleUpdate the terminal window title with current status icons (Ready: ◇, Action Required: ✋, Working: ✦)trueShow Home Directory Warningui.showHomeDirectoryWarningShow a warning when running Gemini CLI in the home directory.trueHide Tipsui.hideTipsHide helpful tips in the UIfalseHide Bannerui.hideBannerHide the application bannerfalseHide Context Summaryui.hideContextSummaryHide the context summary (GEMINI.md, MCP servers) above the input.falseHide CWDui.footer.hideCWDHide the current working directory path in the footer.falseHide Sandbox Statusui.footer.hideSandboxStatusHide the sandbox status indicator in the footer.falseHide Model Infoui.footer.hideModelInfoHide the model name and context usage in the footer.falseHide Context Window Percentageui.footer.hideContextPercentageHides the context window remaining percentage.trueHide Footerui.hideFooterHide the footer from the UIfalseShow Memory Usageui.showMemoryUsageDisplay memory usage information in the UIfalseShow Line Numbersui.showLineNumbersShow line numbers in the chat.trueShow Citationsui.showCitationsShow citations for generated text in the chat.falseShow Model Info In Chatui.showModelInfoInChatShow the model name in the chat for each model turn.falseUse Full Widthui.useFullWidthUse the entire width of the terminal for output.trueUse Alternate Screen Bufferui.useAlternateBufferUse an alternate screen buffer for the UI, preserving shell history.falseIncremental Renderingui.incrementalRenderingEnable incremental rendering for the UI. This option will reduce flickering but may cause rendering artifacts. Only supported when useAlternateBuffer is enabled.trueDisable Loading Phrasesui.accessibility.disableLoadingPhrasesDisable loading phrases for accessibilityfalseScreen Reader Modeui.accessibility.screenReaderRender output in plain-text to be more screen reader accessiblefalse
UI LabelSettingDescriptionDefaultIDE Modeide.enabledEnable IDE integration mode.false
UI LabelSettingDescriptionDefaultMax Session Turnsmodel.maxSessionTurnsMaximum number of user/model/tool turns to keep in a session. -1 means unlimited.-1Compression Thresholdmodel.compressionThresholdThe fraction of context usage at which to trigger context compression (e.g. 0.2, 0.3).0.5Skip Next Speaker Checkmodel.skipNextSpeakerCheckSkip the next speaker check.true
UI LabelSettingDescriptionDefaultMemory Discovery Max Dirscontext.discoveryMaxDirsMaximum number of directories to search for memory.200Load Memory From Include Directoriescontext.loadMemoryFromIncludeDirectoriesControls how /memory refresh loads GEMINI.md files. When true, include directories are scanned; when false, only the current directory is used.falseRespect .gitignorecontext.fileFiltering.respectGitIgnoreRespect .gitignore files when searching.trueRespect .geminiignorecontext.fileFiltering.respectGeminiIgnoreRespect .geminiignore files when searching.trueEnable Recursive File Searchcontext.fileFiltering.enableRecursiveFileSearchEnable recursive file search functionality when completing @ references in the prompt.trueDisable Fuzzy Searchcontext.fileFiltering.disableFuzzySearchDisable fuzzy search when searching for files.false
UI LabelSettingDescriptionDefaultEnable Interactive Shelltools.shell.enableInteractiveShellUse node-pty for an interactive shell experience. Fallback to child_process still applies.trueShow Colortools.shell.showColorShow color in shell output.falseAuto Accepttools.autoAcceptAutomatically accept and execute tool calls that are considered safe (e.g., read-only operations).falseUse Ripgreptools.useRipgrepUse ripgrep for file content search instead of the fallback implementation. Provides faster search performance.trueEnable Tool Output Truncationtools.enableToolOutputTruncationEnable truncation of large tool outputs.trueTool Output Truncation Thresholdtools.truncateToolOutputThresholdTruncate tool output if it is larger than this many characters. Set to -1 to disable.4000000Tool Output Truncation Linestools.truncateToolOutputLinesThe number of lines to keep when truncating tool output.1000Disable LLM Correctiontools.disableLLMCorrectionDisable LLM-based error correction for edit tools. When enabled, tools will fail immediately if exact string matches are not found, instead of attempting to self-correct.false
UI LabelSettingDescriptionDefaultDisable YOLO Modesecurity.disableYoloModeDisable YOLO mode, even if enabled by a flag.falseAllow Permanent Tool Approvalsecurity.enablePermanentToolApprovalEnable the “Allow for all future sessions” option in tool confirmation dialogs.falseBlocks extensions from Gitsecurity.blockGitExtensionsBlocks installing and loading extensions from Git.falseFolder Trustsecurity.folderTrust.enabledSetting to track whether Folder trust is enabled.falseEnable Environment Variable Redactionsecurity.environmentVariableRedaction.enabledEnable redaction of environment variables that may contain secrets.false
UI LabelSettingDescriptionDefaultAgent Skillsexperimental.skillsEnable Agent Skills (experimental).falseEnable Codebase Investigatorexperimental.codebaseInvestigatorSettings.enabledEnable the Codebase Investigator agent.trueCodebase Investigator Max Num Turnsexperimental.codebaseInvestigatorSettings.maxNumTurnsMaximum number of turns for the Codebase Investigator agent.10Use OSC 52 Pasteexperimental.useOSC52PasteUse OSC 52 sequence for pasting instead of clipboardy (useful for remote sessions).falseEnable CLI Help Agentexperimental.cliHelpAgentSettings.enabledEnable the CLI Help Agent.true
UI LabelSettingDescriptionDefaultHook Notificationshooks.notificationsShow visual indicators when hooks are executing.true