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.
Here is a list of all the available settings, grouped by category and ordered as
they appear in the UI.
| UI Label | Setting | Description | Default |
|---|
| Preview Features (e.g., models) | general.previewFeatures | Enable preview features (e.g., preview models). | false |
| Vim Mode | general.vimMode | Enable Vim keybindings. | false |
| Disable Auto Update | general.disableAutoUpdate | Disable automatic updates. | false |
| Enable Prompt Completion | general.enablePromptCompletion | Enable AI-powered prompt completion suggestions while typing. | false |
| Debug Keystroke Logging | general.debugKeystrokeLogging | Enable debug logging of keystrokes to the console. | false |
| Session Retention | general.sessionRetention | Settings for automatic session cleanup. This feature is disabled by default. | undefined |
| Enable Session Cleanup | general.sessionRetention.enabled | Enable automatic session cleanup. | false |
| UI Label | Setting | Description | Default |
|---|
| Output Format | output.format | The format of the CLI output. Can be text or json. | text |
| UI Label | Setting | Description | Default |
|---|
| Hide Window Title | ui.hideWindowTitle | Hide the window title bar. | false |
| Show Status in Title | ui.showStatusInTitle | Show Gemini CLI status and thoughts in the terminal window title. | false |
| Hide Tips | ui.hideTips | Hide helpful tips in the UI. | false |
| Hide Banner | ui.hideBanner | Hide the application banner. | false |
| Hide Context Summary | ui.hideContextSummary | Hide the context summary (GEMINI.md, MCP servers) above the input. | false |
| Hide CWD | ui.footer.hideCWD | Hide the current working directory path in the footer. | false |
| Hide Sandbox Status | ui.footer.hideSandboxStatus | Hide the sandbox status indicator in the footer. | false |
| Hide Model Info | ui.footer.hideModelInfo | Hide the model name and context usage in the footer. | false |
| Hide Context Window Percentage | ui.footer.hideContextPercentage | Hides the context window remaining percentage. | true |
| Hide Footer | ui.hideFooter | Hide the footer from the UI. | false |
| Show Memory Usage | ui.showMemoryUsage | Display memory usage information in the UI. | false |
| Show Line Numbers | ui.showLineNumbers | Show line numbers in the chat. | false |
| Show Citations | ui.showCitations | Show citations for generated text in the chat. | false |
| Use Full Width | ui.useFullWidth | Use the entire width of the terminal for output. | true |
| Use Alternate Screen Buffer | ui.useAlternateBuffer | Use an alternate screen buffer for the UI, preserving shell history. | true |
| Disable Loading Phrases | ui.accessibility.disableLoadingPhrases | Disable loading phrases for accessibility. | false |
| Screen Reader Mode | ui.accessibility.screenReader | Render output in plain-text to be more screen reader accessible. | false |
| UI Label | Setting | Description | Default |
|---|
| IDE Mode | ide.enabled | Enable IDE integration mode. | false |
| UI Label | Setting | Description | Default |
|---|
| Max Session Turns | model.maxSessionTurns | Maximum number of user/model/tool turns to keep in a session. -1 means unlimited. | -1 |
| Compression Threshold | model.compressionThreshold | The fraction of context usage at which to trigger context compression (e.g. 0.2, 0.3). | 0.2 |
| Skip Next Speaker Check | model.skipNextSpeakerCheck | Skip the next speaker check. | true |
| UI Label | Setting | Description | Default |
|---|
| Memory Discovery Max Dirs | context.discoveryMaxDirs | Maximum number of directories to search for memory. | 200 |
| Load Memory From Include Directories | context.loadMemoryFromIncludeDirectories | Controls how /memory refresh loads GEMINI.md files. When true, include directories are scanned; when false, only the current directory is used. | false |
| Respect .gitignore | context.fileFiltering.respectGitIgnore | Respect .gitignore files when searching. | true |
| Respect .geminiignore | context.fileFiltering.respectGeminiIgnore | Respect .geminiignore files when searching. | true |
| Enable Recursive File Search | context.fileFiltering.enableRecursiveFileSearch | Enable recursive file search functionality when completing @ references in the prompt. | true |
| Disable Fuzzy Search | context.fileFiltering.disableFuzzySearch | Disable fuzzy search when searching for files. | false |
| UI Label | Setting | Description | Default |
|---|
| Enable Interactive Shell | tools.shell.enableInteractiveShell | Use node-pty for an interactive shell experience. Fallback to child_process still applies. | true |
| Show Color | tools.shell.showColor | Show color in shell output. | false |
| Auto Accept | tools.autoAccept | Automatically accept and execute tool calls that are considered safe (e.g., read-only operations). | false |
| Use Ripgrep | tools.useRipgrep | Use ripgrep for file content search instead of the fallback implementation. Provides faster search performance. | true |
| Enable Tool Output Truncation | tools.enableToolOutputTruncation | Enable truncation of large tool outputs. | true |
| Tool Output Truncation Threshold | tools.truncateToolOutputThreshold | Truncate tool output if it is larger than this many characters. Set to -1 to disable. | 10000 |
| Tool Output Truncation Lines | tools.truncateToolOutputLines | The number of lines to keep when truncating tool output. | 100 |
| Enable Message Bus Integration | tools.enableMessageBusIntegration | Enable policy-based tool confirmation via message bus integration. | false |
| UI Label | Setting | Description | Default |
|---|
| Disable YOLO Mode | security.disableYoloMode | Disable YOLO mode, even if enabled by a flag. | false |
| Blocks extensions from Git | security.blockGitExtensions | Blocks installing and loading extensions from Git. | false |
| Folder Trust | security.folderTrust.enabled | Setting to track whether Folder trust is enabled. | false |
| UI Label | Setting | Description | Default |
|---|
| Enable Codebase Investigator | experimental.codebaseInvestigatorSettings.enabled | Enable the Codebase Investigator agent. | true |
| Codebase Investigator Max Num Turns | experimental.codebaseInvestigatorSettings.maxNumTurns | Maximum number of turns for the Codebase Investigator agent. | 10 |
