mirror of
https://github.com/google-gemini/gemini-cli.git
synced 2026-02-01 22:48:03 +00:00
12 KiB
12 KiB
Gemini CLI Settings (/settings Command)
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.
Settings reference
Here is a list of all the available settings, grouped by category and ordered as they appear in the UI.
General
| 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 |
Output
| UI Label | Setting | Description | Default |
|---|---|---|---|
| Output Format | output.format |
The format of the CLI output. Can be text or json. |
text |
UI
| 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 |
IDE
| UI Label | Setting | Description | Default |
|---|---|---|---|
| IDE Mode | ide.enabled |
Enable IDE integration mode. | false |
Model
| 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 |
Context
| 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 |
Tools
| 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 |
Security
| 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 |
Experimental
| 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 |