Gemini CLI settings
Configuration for Gemini CLI settings files
| Type | object |
|---|---|
| File match |
**/.gemini/settings.json
**/gemini-cli/settings.json
**/GeminiCli/settings.json
|
| Schema URL | https://catalog.lintel.tools/schemas/schemastore/gemini-cli-settings/latest.json |
| Source | https://raw.githubusercontent.com/google-gemini/gemini-cli/refs/heads/main/schemas/settings.schema.json |
Validate with Lintel
npx @lintel/lintel checkConfiguration file schema for Gemini CLI settings. This schema enables IDE completion for settings.json.
Properties
The URL of the JSON schema for this settings file. Used by editors for validation and autocompletion.
Configuration for MCP servers.
- Category:
Advanced - Requires restart:
yes - Default:
{}
{}Additional policy files or directories to load.
- Category:
Advanced - Requires restart:
yes - Default:
[]
[]Additional admin policy files or directories to load.
- Category:
Advanced - Requires restart:
yes - Default:
[]
[]General application settings.
- Category:
General - Requires restart:
no - Default:
{}
{}13 nested properties
The preferred editor to open files in.
- Category:
General - Requires restart:
no
Enable Vim keybindings
- Category:
General - Requires restart:
no - Default:
false
The default approval mode for tool execution. 'default' prompts for approval, 'auto_edit' auto-approves edit tools, and 'plan' is read-only mode. YOLO mode (auto-approve all actions) can only be enabled via command line (--yolo or --approval-mode=yolo).
- Category:
General - Requires restart:
no - Default:
default
Enable DevTools inspector on launch.
- Category:
General - Requires restart:
no - Default:
false
Enable automatic updates.
- Category:
General - Requires restart:
no - Default:
true
Enable update notification prompts.
- Category:
General - Requires restart:
no - Default:
true
Enable run-event notifications for action-required prompts and session completion.
- Category:
General - Requires restart:
no - Default:
false
Session checkpointing settings.
- Category:
General - Requires restart:
yes - Default:
{}
{}1 nested properties
Enable session checkpointing for recovery
- Category:
General - Requires restart:
yes - Default:
false
Planning features configuration.
- Category:
General - Requires restart:
yes - Default:
{}
{}3 nested properties
Enable Plan Mode for read-only safety during planning.
- Category:
General - Requires restart:
yes - Default:
true
The directory where planning artifacts are stored. If not specified, defaults to the system temporary directory. A custom directory requires a policy to allow write access in Plan Mode.
- Category:
General - Requires restart:
yes
Automatically switch between Pro and Flash models based on Plan Mode status. Uses Pro for the planning phase and Flash for the implementation phase.
- Category:
General - Requires restart:
no - Default:
true
Retry on "exception TypeError: fetch failed sending request" errors.
- Category:
General - Requires restart:
no - Default:
true
Maximum number of attempts for requests to the main chat model. Cannot exceed 10.
- Category:
General - Requires restart:
no - Default:
10
Enable debug logging of keystrokes to the console.
- Category:
General - Requires restart:
no - Default:
false
Settings for automatic session cleanup.
- Category:
General - Requires restart:
no
4 nested properties
Enable automatic session cleanup
- Category:
General - Requires restart:
no - Default:
true
Automatically delete chats older than this time period (e.g., "30d", "7d", "24h", "1w")
- Category:
General - Requires restart:
no - Default:
30d
Alternative: Maximum number of sessions to keep (most recent)
- Category:
General - Requires restart:
no
Minimum retention period (safety limit, defaults to "1d")
- Category:
General - Requires restart:
no - Default:
1d
Settings for the CLI output.
- Category:
General - Requires restart:
no - Default:
{}
{}1 nested properties
The format of the CLI output. Can be text or json.
- Category:
General - Requires restart:
no - Default:
text
User interface settings.
- Category:
UI - Requires restart:
no - Default:
{}
{}34 nested properties
The color theme for the UI. See the CLI themes guide for available options.
- Category:
UI - Requires restart:
no
Automatically switch between default light and dark themes based on terminal background color.
- Category:
UI - Requires restart:
no - Default:
true
Interval in seconds to poll the terminal background color.
- Category:
UI - Requires restart:
no - Default:
60
Custom theme definitions.
- Category:
UI - Requires restart:
no - Default:
{}
{}Hide the window title bar
- Category:
UI - Requires restart:
yes - Default:
false
Display model thinking inline: off or full.
- Category:
UI - Requires restart:
no - Default:
off
Show Gemini CLI model thoughts in the terminal window title during the working phase
- Category:
UI - Requires restart:
no - Default:
false
Update the terminal window title with current status icons (Ready: ◇, Action Required: ✋, Working: ✦)
- Category:
UI - Requires restart:
no - Default:
true
Show a warning when running Gemini CLI in the home directory.
- Category:
UI - Requires restart:
yes - Default:
true
Show warnings about terminal or OS compatibility issues.
- Category:
UI - Requires restart:
yes - Default:
true
Hide helpful tips in the UI
- Category:
UI - Requires restart:
no - Default:
false
When enabled, @ symbols in pasted text are escaped to prevent unintended @path expansion.
- Category:
UI - Requires restart:
no - Default:
false
Show the "? for shortcuts" hint above the input.
- Category:
UI - Requires restart:
no - Default:
true
Display tool outputs (like directory listings and file reads) in a compact, structured format.
- Category:
UI - Requires restart:
no - Default:
true
Hide the application banner
- Category:
UI - Requires restart:
no - Default:
false
Hide the context summary (GEMINI.md, MCP servers) above the input.
- Category:
UI - Requires restart:
no - Default:
false
Settings for the footer.
- Category:
UI - Requires restart:
no - Default:
{}
{}6 nested properties
List of item IDs to display in the footer. Rendered in order
- Category:
UI - Requires restart:
no
Display a second line above the footer items with descriptive headers (e.g., /model).
- Category:
UI - Requires restart:
no - Default:
true
Hide the current working directory in the footer.
- Category:
UI - Requires restart:
no - Default:
false
Hide the sandbox status indicator in the footer.
- Category:
UI - Requires restart:
no - Default:
false
Hide the model name and context usage in the footer.
- Category:
UI - Requires restart:
no - Default:
false
Hides the context window usage percentage.
- Category:
UI - Requires restart:
no - Default:
true
Hide the footer from the UI
- Category:
UI - Requires restart:
no - Default:
false
Whether to collapse the UI drawer when a tool is awaiting confirmation.
- Category:
UI - Requires restart:
no - Default:
true
Display memory usage information in the UI
- Category:
UI - Requires restart:
no - Default:
false
Show line numbers in the chat.
- Category:
UI - Requires restart:
no - Default:
true
Show citations for generated text in the chat.
- Category:
UI - Requires restart:
no - Default:
false
Show the model name in the chat for each model turn.
- Category:
UI - Requires restart:
no - Default:
false
Show the signed-in user's identity (e.g. email) in the UI.
- Category:
UI - Requires restart:
no - Default:
true
Use an alternate screen buffer for the UI, preserving shell history.
- Category:
UI - Requires restart:
yes - Default:
false
Enable Ink render process for the UI.
- Category:
UI - Requires restart:
yes - Default:
true
Use the new terminal buffer architecture for rendering.
- Category:
UI - Requires restart:
yes - Default:
true
Whether to use background colors in the UI.
- Category:
UI - Requires restart:
no - Default:
true
Enable incremental rendering for the UI. This option will reduce flickering but may cause rendering artifacts. Only supported when useAlternateBuffer is enabled.
- Category:
UI - Requires restart:
yes - Default:
true
Show the spinner during operations.
- Category:
UI - Requires restart:
no - Default:
true
What to show while the model is working: tips, witty comments, all, or off.
- Category:
UI - Requires restart:
no - Default:
off
Controls whether recoverable errors are hidden (low) or fully shown (full).
- Category:
UI - Requires restart:
no - Default:
low
Custom witty phrases to display during loading. When provided, the CLI cycles through these instead of the defaults.
- Category:
UI - Requires restart:
no - Default:
[]
[]Accessibility settings.
- Category:
UI - Requires restart:
yes - Default:
{}
{}2 nested properties
@deprecated Use ui.loadingPhrases instead. Enable loading phrases during operations.
- Category:
UI - Requires restart:
yes - Default:
true
Render output in plain-text to be more screen reader accessible
- Category:
UI - Requires restart:
yes - Default:
false
IDE integration settings.
- Category:
IDE - Requires restart:
yes - Default:
{}
{}2 nested properties
Enable IDE integration mode.
- Category:
IDE - Requires restart:
yes - Default:
false
Whether the user has seen the IDE integration nudge.
- Category:
IDE - Requires restart:
no - Default:
false
Privacy-related settings.
- Category:
Privacy - Requires restart:
yes - Default:
{}
{}1 nested properties
Enable collection of usage statistics
- Category:
Privacy - Requires restart:
yes - Default:
true
Telemetry configuration for Gemini CLI.
8 nested properties
Enables telemetry emission.
Telemetry destination (for example stderr, stdout, or otlp).
Endpoint for OTLP exporters.
Protocol for OTLP exporters.
Whether prompts are logged in telemetry payloads.
File path for writing telemetry output.
Whether to forward telemetry to an OTLP collector.
Whether to use CLI authentication for telemetry (only for in-process exporters).
Billing and AI credits settings.
- Category:
Advanced - Requires restart:
no - Default:
{}
{}1 nested properties
How to handle quota exhaustion when AI credits are available. 'ask' prompts each time, 'always' automatically uses credits, 'never' disables credit usage.
- Category:
Advanced - Requires restart:
no - Default:
ask
Settings related to the generative model.
- Category:
Model - Requires restart:
no - Default:
{}
{}6 nested properties
The Gemini model to use for conversations.
- Category:
Model - Requires restart:
no
Maximum number of user/model/tool turns to keep in a session. -1 means unlimited.
- Category:
Model - Requires restart:
no - Default:
-1
Enables or disables summarization of tool output. Configure per-tool token budgets (for example {"run_shell_command": {"tokenBudget": 2000}}). Currently only the run_shell_command tool supports summarization.
- Category:
Model - Requires restart:
no
The fraction of context usage at which to trigger context compression (e.g. 0.2, 0.3).
- Category:
Model - Requires restart:
yes - Default:
0.5
Disable automatic detection and prevention of infinite loops.
- Category:
Model - Requires restart:
yes - Default:
false
Skip the next speaker check.
- Category:
Model - Requires restart:
no - Default:
true
Model configurations.
- Category:
Model - Requires restart:
no - Default:
{ "aliases": { "base": { "modelConfig": { "generateContentConfig": { "temperature": 0, "topP": 1 } } }, "chat-base": { "extends": "base", "modelConfig": { "generateContentConfig": { "thinkingConfig": { "includeThoughts": true }, "temperature": 1, "topP": 0.95, "topK": 64 } } }, "chat-base-2.5": { "extends": "chat-base", "modelConfig": { "generateContentConfig": { "thinkingConfig": { "thinkingBudget": 8192 } } } }, "chat-base-3": { "extends": "chat-base", "modelConfig": { "generateContentConfig": { "thinkingConfig": { "thinkingLevel": "HIGH" } } } }, "gemini-3-pro-preview": { "extends": "chat-base-3", "modelConfig": { "model": "gemini-3-pro-preview" } }, "gemini-3-flash-preview": { "extends": "chat-base-3", "modelConfig": { "model": "gemini-3-flash-preview" } }, "gemini-2.5-pro": { "extends": "chat-base-2.5", "modelConfig": { "model": "gemini-2.5-pro" } }, "gemini-2.5-flash": { "extends": "chat-base-2.5", "modelConfig": { "model": "gemini-2.5-flash" } }, "gemini-2.5-flash-lite": { "extends": "chat-base-2.5", "modelConfig": { "model": "gemini-2.5-flash-lite" } }, "gemini-2.5-flash-base": { "extends": "base", "modelConfig": { "model": "gemini-2.5-flash" } }, "gemini-3-flash-base": { "extends": "base", "modelConfig": { "model": "gemini-3-flash-preview" } }, "classifier": { "extends": "base", "modelConfig": { "model": "gemini-2.5-flash-lite", "generateContentConfig": { "maxOutputTokens": 1024, "thinkingConfig": { "thinkingBudget": 512 } } } }, "prompt-completion": { "extends": "base", "modelConfig": { "model": "gemini-2.5-flash-lite", "generateContentConfig": { "temperature": 0.3, "maxOutputTokens": 16000, "thinkingConfig": { "thinkingBudget": 0 } } } }, "fast-ack-helper": { "extends": "base", "modelConfig": { "model": "gemini-2.5-flash-lite", "generateContentConfig": { "temperature": 0.2, "maxOutputTokens": 120, "thinkingConfig": { "thinkingBudget": 0 } } } }, "edit-corrector": { "extends": "base", "modelConfig": { "model": "gemini-2.5-flash-lite", "generateContentConfig": { "thinkingConfig": { "thinkingBudget": 0 } } } }, "summarizer-default": { "extends": "base", "modelConfig": { "model": "gemini-2.5-flash-lite", "generateContentConfig": { "maxOutputTokens": 2000 } } }, "summarizer-shell": { "extends": "base", "modelConfig": { "model": "gemini-2.5-flash-lite", "generateContentConfig": { "maxOutputTokens": 2000 } } }, "web-search": { "extends": "gemini-3-flash-base", "modelConfig": { "generateContentConfig": { "tools": [ { "googleSearch": {} } ] } } }, "web-fetch": { "extends": "gemini-3-flash-base", "modelConfig": { "generateContentConfig": { "tools": [ { "urlContext": {} } ] } } }, "web-fetch-fallback": { "extends": "gemini-3-flash-base", "modelConfig": {} }, "loop-detection": { "extends": "gemini-3-flash-base", "modelConfig": {} }, "loop-detection-double-check": { "extends": "base", "modelConfig": { "model": "gemini-3-pro-preview" } }, "llm-edit-fixer": { "extends": "gemini-3-flash-base", "modelConfig": {} }, "next-speaker-checker": { "extends": "gemini-3-flash-base", "modelConfig": {} }, "chat-compression-3-pro": { "modelConfig": { "model": "gemini-3-pro-preview" } }, "chat-compression-3-flash": { "modelConfig": { "model": "gemini-3-flash-preview" } }, "chat-compression-3.1-flash-lite": { "modelConfig": { "model": "gemini-3.1-flash-lite-preview" } }, "chat-compression-2.5-pro": { "modelConfig": { "model": "gemini-2.5-pro" } }, "chat-compression-2.5-flash": { "modelConfig": { "model": "gemini-2.5-flash" } }, "chat-compression-2.5-flash-lite": { "modelConfig": { "model": "gemini-2.5-flash-lite" } }, "chat-compression-default": { "modelConfig": { "model": "gemini-3-pro-preview" } }, "agent-history-provider-summarizer": { "modelConfig": { "model": "gemini-3-flash-preview" } } }, "overrides": [ { "match": { "model": "chat-base", "isRetry": true }, "modelConfig": { "generateContentConfig": { "temperature": 1 } } } ], "modelDefinitions": { "gemini-3.1-flash-lite-preview": { "tier": "flash-lite", "family": "gemini-3", "isPreview": true, "isVisible": true, "features": { "thinking": false, "multimodalToolUse": true } }, "gemini-3.1-pro-preview": { "tier": "pro", "family": "gemini-3", "isPreview": true, "isVisible": true, "features": { "thinking": true, "multimodalToolUse": true } }, "gemini-3.1-pro-preview-customtools": { "tier": "pro", "family": "gemini-3", "isPreview": true, "isVisible": false, "features": { "thinking": true, "multimodalToolUse": true } }, "gemini-3-pro-preview": { "tier": "pro", "family": "gemini-3", "isPreview": true, "isVisible": true, "features": { "thinking": true, "multimodalToolUse": true } }, "gemini-3-flash-preview": { "tier": "flash", "family": "gemini-3", "isPreview": true, "isVisible": true, "features": { "thinking": false, "multimodalToolUse": true } }, "gemini-2.5-pro": { "tier": "pro", "family": "gemini-2.5", "isPreview": false, "isVisible": true, "features": { "thinking": false, "multimodalToolUse": false } }, "gemini-2.5-flash": { "tier": "flash", "family": "gemini-2.5", "isPreview": false, "isVisible": true, "features": { "thinking": false, "multimodalToolUse": false } }, "gemini-2.5-flash-lite": { "tier": "flash-lite", "family": "gemini-2.5", "isPreview": false, "isVisible": true, "features": { "thinking": false, "multimodalToolUse": false } }, "auto": { "tier": "auto", "isPreview": true, "isVisible": false, "features": { "thinking": true, "multimodalToolUse": false } }, "pro": { "tier": "pro", "isPreview": false, "isVisible": false, "features": { "thinking": true, "multimodalToolUse": false } }, "flash": { "tier": "flash", "isPreview": false, "isVisible": false, "features": { "thinking": false, "multimodalToolUse": false } }, "flash-lite": { "tier": "flash-lite", "isPreview": false, "isVisible": false, "features": { "thinking": false, "multimodalToolUse": false } }, "auto-gemini-3": { "displayName": "Auto (Gemini 3)", "tier": "auto", "isPreview": true, "isVisible": true, "dialogDescription": "Let Gemini CLI decide the best model for the task: gemini-3-pro, gemini-3-flash", "features": { "thinking": true, "multimodalToolUse": false } }, "auto-gemini-2.5": { "displayName": "Auto (Gemini 2.5)", "tier": "auto", "isPreview": false, "isVisible": true, "dialogDescription": "Let Gemini CLI decide the best model for the task: gemini-2.5-pro, gemini-2.5-flash", "features": { "thinking": false, "multimodalToolUse": false } } }, "modelIdResolutions": { "gemini-3.1-pro-preview": { "default": "gemini-3.1-pro-preview", "contexts": [ { "condition": { "hasAccessToPreview": false }, "target": "gemini-2.5-pro" }, { "condition": { "useCustomTools": true }, "target": "gemini-3.1-pro-preview-customtools" } ] }, "gemini-3.1-pro-preview-customtools": { "default": "gemini-3.1-pro-preview-customtools", "contexts": [ { "condition": { "hasAccessToPreview": false }, "target": "gemini-2.5-pro" } ] }, "gemini-3-flash-preview": { "default": "gemini-3-flash-preview", "contexts": [ { "condition": { "hasAccessToPreview": false }, "target": "gemini-2.5-flash" } ] }, "gemini-3-pro-preview": { "default": "gemini-3-pro-preview", "contexts": [ { "condition": { "hasAccessToPreview": false }, "target": "gemini-2.5-pro" }, { "condition": { "useGemini3_1": true, "useCustomTools": true }, "target": "gemini-3.1-pro-preview-customtools" }, { "condition": { "useGemini3_1": true }, "target": "gemini-3.1-pro-preview" } ] }, "auto-gemini-3": { "default": "gemini-3-pro-preview", "contexts": [ { "condition": { "hasAccessToPreview": false }, "target": "gemini-2.5-pro" }, { "condition": { "useGemini3_1": true, "useCustomTools": true }, "target": "gemini-3.1-pro-preview-customtools" }, { "condition": { "useGemini3_1": true }, "target": "gemini-3.1-pro-preview" } ] }, "auto": { "default": "gemini-3-pro-preview", "contexts": [ { "condition": { "hasAccessToPreview": false }, "target": "gemini-2.5-pro" }, { "condition": { "useGemini3_1": true, "useCustomTools": true }, "target": "gemini-3.1-pro-preview-customtools" }, { "condition": { "useGemini3_1": true }, "target": "gemini-3.1-pro-preview" } ] }, "pro": { "default": "gemini-3-pro-preview", "contexts": [ { "condition": { "hasAccessToPreview": false }, "target": "gemini-2.5-pro" }, { "condition": { "useGemini3_1": true, "useCustomTools": true }, "target": "gemini-3.1-pro-preview-customtools" }, { "condition": { "useGemini3_1": true }, "target": "gemini-3.1-pro-preview" } ] }, "auto-gemini-2.5": { "default": "gemini-2.5-pro" }, "gemini-3.1-flash-lite-preview": { "default": "gemini-3.1-flash-lite-preview", "contexts": [ { "condition": { "useGemini3_1FlashLite": false }, "target": "gemini-2.5-flash-lite" } ] }, "flash": { "default": "gemini-3-flash-preview", "contexts": [ { "condition": { "hasAccessToPreview": false }, "target": "gemini-2.5-flash" } ] }, "flash-lite": { "default": "gemini-2.5-flash-lite", "contexts": [ { "condition": { "useGemini3_1FlashLite": true }, "target": "gemini-3.1-flash-lite-preview" } ] } }, "classifierIdResolutions": { "flash": { "default": "gemini-3-flash-preview", "contexts": [ { "condition": { "requestedModels": [ "auto-gemini-2.5", "gemini-2.5-pro" ] }, "target": "gemini-2.5-flash" }, { "condition": { "requestedModels": [ "auto-gemini-3", "gemini-3-pro-preview" ] }, "target": "gemini-3-flash-preview" } ] }, "pro": { "default": "gemini-3-pro-preview", "contexts": [ { "condition": { "requestedModels": [ "auto-gemini-2.5", "gemini-2.5-pro" ] }, "target": "gemini-2.5-pro" }, { "condition": { "useGemini3_1": true, "useCustomTools": true }, "target": "gemini-3.1-pro-preview-customtools" }, { "condition": { "useGemini3_1": true }, "target": "gemini-3.1-pro-preview" } ] } }, "modelChains": { "preview": [ { "model": "gemini-3-pro-preview", "actions": { "terminal": "prompt", "transient": "prompt", "not_found": "prompt", "unknown": "prompt" }, "stateTransitions": { "terminal": "terminal", "transient": "terminal", "not_found": "terminal", "unknown": "terminal" } }, { "model": "gemini-3-flash-preview", "isLastResort": true, "actions": { "terminal": "prompt", "transient": "prompt", "not_found": "prompt", "unknown": "prompt" }, "stateTransitions": { "terminal": "terminal", "transient": "terminal", "not_found": "terminal", "unknown": "terminal" } } ], "default": [ { "model": "gemini-2.5-pro", "actions": { "terminal": "prompt", "transient": "prompt", "not_found": "prompt", "unknown": "prompt" }, "stateTransitions": { "terminal": "terminal", "transient": "terminal", "not_found": "terminal", "unknown": "terminal" } }, { "model": "gemini-2.5-flash", "isLastResort": true, "actions": { "terminal": "prompt", "transient": "prompt", "not_found": "prompt", "unknown": "prompt" }, "stateTransitions": { "terminal": "terminal", "transient": "terminal", "not_found": "terminal", "unknown": "terminal" } } ], "lite": [ { "model": "gemini-2.5-flash-lite", "actions": { "terminal": "silent", "transient": "silent", "not_found": "silent", "unknown": "silent" }, "stateTransitions": { "terminal": "terminal", "transient": "terminal", "not_found": "terminal", "unknown": "terminal" } }, { "model": "gemini-2.5-flash", "actions": { "terminal": "silent", "transient": "silent", "not_found": "silent", "unknown": "silent" }, "stateTransitions": { "terminal": "terminal", "transient": "terminal", "not_found": "terminal", "unknown": "terminal" } }, { "model": "gemini-2.5-pro", "isLastResort": true, "actions": { "terminal": "silent", "transient": "silent", "not_found": "silent", "unknown": "silent" }, "stateTransitions": { "terminal": "terminal", "transient": "terminal", "not_found": "terminal", "unknown": "terminal" } } ] } }
{
"aliases": {
"base": {
"modelConfig": {
"generateContentConfig": {
"temperature": 0,
"topP": 1
}
}
},
"chat-base": {
"extends": "base",
"modelConfig": {
"generateContentConfig": {
"thinkingConfig": {
"includeThoughts": true
},
"temperature": 1,
"topP": 0.95,
"topK": 64
}
}
},
"chat-base-2.5": {
"extends": "chat-base",
"modelConfig": {
"generateContentConfig": {
"thinkingConfig": {
"thinkingBudget": 8192
}
}
}
},
"chat-base-3": {
"extends": "chat-base",
"modelConfig": {
"generateContentConfig": {
"thinkingConfig": {
"thinkingLevel": "HIGH"
}
}
}
},
"gemini-3-pro-preview": {
"extends": "chat-base-3",
"modelConfig": {
"model": "gemini-3-pro-preview"
}
},
"gemini-3-flash-preview": {
"extends": "chat-base-3",
"modelConfig": {
"model": "gemini-3-flash-preview"
}
},
"gemini-2.5-pro": {
"extends": "chat-base-2.5",
"modelConfig": {
"model": "gemini-2.5-pro"
}
},
"gemini-2.5-flash": {
"extends": "chat-base-2.5",
"modelConfig": {
"model": "gemini-2.5-flash"
}
},
"gemini-2.5-flash-lite": {
"extends": "chat-base-2.5",
"modelConfig": {
"model": "gemini-2.5-flash-lite"
}
},
"gemini-2.5-flash-base": {
"extends": "base",
"modelConfig": {
"model": "gemini-2.5-flash"
}
},
"gemini-3-flash-base": {
"extends": "base",
"modelConfig": {
"model": "gemini-3-flash-preview"
}
},
"classifier": {
"extends": "base",
"modelConfig": {
"model": "gemini-2.5-flash-lite",
"generateContentConfig": {
"maxOutputTokens": 1024,
"thinkingConfig": {
"thinkingBudget": 512
}
}
}
},
"prompt-completion": {
"extends": "base",
"modelConfig": {
"model": "gemini-2.5-flash-lite",
"generateContentConfig": {
"temperature": 0.3,
"maxOutputTokens": 16000,
"thinkingConfig": {
"thinkingBudget": 0
}
}
}
},
"fast-ack-helper": {
"extends": "base",
"modelConfig": {
"model": "gemini-2.5-flash-lite",
"generateContentConfig": {
"temperature": 0.2,
"maxOutputTokens": 120,
"thinkingConfig": {
"thinkingBudget": 0
}
}
}
},
"edit-corrector": {
"extends": "base",
"modelConfig": {
"model": "gemini-2.5-flash-lite",
"generateContentConfig": {
"thinkingConfig": {
"thinkingBudget": 0
}
}
}
},
"summarizer-default": {
"extends": "base",
"modelConfig": {
"model": "gemini-2.5-flash-lite",
"generateContentConfig": {
"maxOutputTokens": 2000
}
}
},
"summarizer-shell": {
"extends": "base",
"modelConfig": {
"model": "gemini-2.5-flash-lite",
"generateContentConfig": {
"maxOutputTokens": 2000
}
}
},
"web-search": {
"extends": "gemini-3-flash-base",
"modelConfig": {
"generateContentConfig": {
"tools": [
{
"googleSearch": {}
}
]
}
}
},
"web-fetch": {
"extends": "gemini-3-flash-base",
"modelConfig": {
"generateContentConfig": {
"tools": [
{
"urlContext": {}
}
]
}
}
},
"web-fetch-fallback": {
"extends": "gemini-3-flash-base",
"modelConfig": {}
},
"loop-detection": {
"extends": "gemini-3-flash-base",
"modelConfig": {}
},
"loop-detection-double-check": {
"extends": "base",
"modelConfig": {
"model": "gemini-3-pro-preview"
}
},
"llm-edit-fixer": {
"extends": "gemini-3-flash-base",
"modelConfig": {}
},
"next-speaker-checker": {
"extends": "gemini-3-flash-base",
"modelConfig": {}
},
"chat-compression-3-pro": {
"modelConfig": {
"model": "gemini-3-pro-preview"
}
},
"chat-compression-3-flash": {
"modelConfig": {
"model": "gemini-3-flash-preview"
}
},
"chat-compression-3.1-flash-lite": {
"modelConfig": {
"model": "gemini-3.1-flash-lite-preview"
}
},
"chat-compression-2.5-pro": {
"modelConfig": {
"model": "gemini-2.5-pro"
}
},
"chat-compression-2.5-flash": {
"modelConfig": {
"model": "gemini-2.5-flash"
}
},
"chat-compression-2.5-flash-lite": {
"modelConfig": {
"model": "gemini-2.5-flash-lite"
}
},
"chat-compression-default": {
"modelConfig": {
"model": "gemini-3-pro-preview"
}
},
"agent-history-provider-summarizer": {
"modelConfig": {
"model": "gemini-3-flash-preview"
}
}
},
"overrides": [
{
"match": {
"model": "chat-base",
"isRetry": true
},
"modelConfig": {
"generateContentConfig": {
"temperature": 1
}
}
}
],
"modelDefinitions": {
"gemini-3.1-flash-lite-preview": {
"tier": "flash-lite",
"family": "gemini-3",
"isPreview": true,
"isVisible": true,
"features": {
"thinking": false,
"multimodalToolUse": true
}
},
"gemini-3.1-pro-preview": {
"tier": "pro",
"family": "gemini-3",
"isPreview": true,
"isVisible": true,
"features": {
"thinking": true,
"multimodalToolUse": true
}
},
"gemini-3.1-pro-preview-customtools": {
"tier": "pro",
"family": "gemini-3",
"isPreview": true,
"isVisible": false,
"features": {
"thinking": true,
"multimodalToolUse": true
}
},
"gemini-3-pro-preview": {
"tier": "pro",
"family": "gemini-3",
"isPreview": true,
"isVisible": true,
"features": {
"thinking": true,
"multimodalToolUse": true
}
},
"gemini-3-flash-preview": {
"tier": "flash",
"family": "gemini-3",
"isPreview": true,
"isVisible": true,
"features": {
"thinking": false,
"multimodalToolUse": true
}
},
"gemini-2.5-pro": {
"tier": "pro",
"family": "gemini-2.5",
"isPreview": false,
"isVisible": true,
"features": {
"thinking": false,
"multimodalToolUse": false
}
},
"gemini-2.5-flash": {
"tier": "flash",
"family": "gemini-2.5",
"isPreview": false,
"isVisible": true,
"features": {
"thinking": false,
"multimodalToolUse": false
}
},
"gemini-2.5-flash-lite": {
"tier": "flash-lite",
"family": "gemini-2.5",
"isPreview": false,
"isVisible": true,
"features": {
"thinking": false,
"multimodalToolUse": false
}
},
"auto": {
"tier": "auto",
"isPreview": true,
"isVisible": false,
"features": {
"thinking": true,
"multimodalToolUse": false
}
},
"pro": {
"tier": "pro",
"isPreview": false,
"isVisible": false,
"features": {
"thinking": true,
"multimodalToolUse": false
}
},
"flash": {
"tier": "flash",
"isPreview": false,
"isVisible": false,
"features": {
"thinking": false,
"multimodalToolUse": false
}
},
"flash-lite": {
"tier": "flash-lite",
"isPreview": false,
"isVisible": false,
"features": {
"thinking": false,
"multimodalToolUse": false
}
},
"auto-gemini-3": {
"displayName": "Auto (Gemini 3)",
"tier": "auto",
"isPreview": true,
"isVisible": true,
"dialogDescription": "Let Gemini CLI decide the best model for the task: gemini-3-pro, gemini-3-flash",
"features": {
"thinking": true,
"multimodalToolUse": false
}
},
"auto-gemini-2.5": {
"displayName": "Auto (Gemini 2.5)",
"tier": "auto",
"isPreview": false,
"isVisible": true,
"dialogDescription": "Let Gemini CLI decide the best model for the task: gemini-2.5-pro, gemini-2.5-flash",
"features": {
"thinking": false,
"multimodalToolUse": false
}
}
},
"modelIdResolutions": {
"gemini-3.1-pro-preview": {
"default": "gemini-3.1-pro-preview",
"contexts": [
{
"condition": {
"hasAccessToPreview": false
},
"target": "gemini-2.5-pro"
},
{
"condition": {
"useCustomTools": true
},
"target": "gemini-3.1-pro-preview-customtools"
}
]
},
"gemini-3.1-pro-preview-customtools": {
"default": "gemini-3.1-pro-preview-customtools",
"contexts": [
{
"condition": {
"hasAccessToPreview": false
},
"target": "gemini-2.5-pro"
}
]
},
"gemini-3-flash-preview": {
"default": "gemini-3-flash-preview",
"contexts": [
{
"condition": {
"hasAccessToPreview": false
},
"target": "gemini-2.5-flash"
}
]
},
"gemini-3-pro-preview": {
"default": "gemini-3-pro-preview",
"contexts": [
{
"condition": {
"hasAccessToPreview": false
},
"target": "gemini-2.5-pro"
},
{
"condition": {
"useGemini3_1": true,
"useCustomTools": true
},
"target": "gemini-3.1-pro-preview-customtools"
},
{
"condition": {
"useGemini3_1": true
},
"target": "gemini-3.1-pro-preview"
}
]
},
"auto-gemini-3": {
"default": "gemini-3-pro-preview",
"contexts": [
{
"condition": {
"hasAccessToPreview": false
},
"target": "gemini-2.5-pro"
},
{
"condition": {
"useGemini3_1": true,
"useCustomTools": true
},
"target": "gemini-3.1-pro-preview-customtools"
},
{
"condition": {
"useGemini3_1": true
},
"target": "gemini-3.1-pro-preview"
}
]
},
"auto": {
"default": "gemini-3-pro-preview",
"contexts": [
{
"condition": {
"hasAccessToPreview": false
},
"target": "gemini-2.5-pro"
},
{
"condition": {
"useGemini3_1": true,
"useCustomTools": true
},
"target": "gemini-3.1-pro-preview-customtools"
},
{
"condition": {
"useGemini3_1": true
},
"target": "gemini-3.1-pro-preview"
}
]
},
"pro": {
"default": "gemini-3-pro-preview",
"contexts": [
{
"condition": {
"hasAccessToPreview": false
},
"target": "gemini-2.5-pro"
},
{
"condition": {
"useGemini3_1": true,
"useCustomTools": true
},
"target": "gemini-3.1-pro-preview-customtools"
},
{
"condition": {
"useGemini3_1": true
},
"target": "gemini-3.1-pro-preview"
}
]
},
"auto-gemini-2.5": {
"default": "gemini-2.5-pro"
},
"gemini-3.1-flash-lite-preview": {
"default": "gemini-3.1-flash-lite-preview",
"contexts": [
{
"condition": {
"useGemini3_1FlashLite": false
},
"target": "gemini-2.5-flash-lite"
}
]
},
"flash": {
"default": "gemini-3-flash-preview",
"contexts": [
{
"condition": {
"hasAccessToPreview": false
},
"target": "gemini-2.5-flash"
}
]
},
"flash-lite": {
"default": "gemini-2.5-flash-lite",
"contexts": [
{
"condition": {
"useGemini3_1FlashLite": true
},
"target": "gemini-3.1-flash-lite-preview"
}
]
}
},
"classifierIdResolutions": {
"flash": {
"default": "gemini-3-flash-preview",
"contexts": [
{
"condition": {
"requestedModels": [
"auto-gemini-2.5",
"gemini-2.5-pro"
]
},
"target": "gemini-2.5-flash"
},
{
"condition": {
"requestedModels": [
"auto-gemini-3",
"gemini-3-pro-preview"
]
},
"target": "gemini-3-flash-preview"
}
]
},
"pro": {
"default": "gemini-3-pro-preview",
"contexts": [
{
"condition": {
"requestedModels": [
"auto-gemini-2.5",
"gemini-2.5-pro"
]
},
"target": "gemini-2.5-pro"
},
{
"condition": {
"useGemini3_1": true,
"useCustomTools": true
},
"target": "gemini-3.1-pro-preview-customtools"
},
{
"condition": {
"useGemini3_1": true
},
"target": "gemini-3.1-pro-preview"
}
]
}
},
"modelChains": {
"preview": [
{
"model": "gemini-3-pro-preview",
"actions": {
"terminal": "prompt",
"transient": "prompt",
"not_found": "prompt",
"unknown": "prompt"
},
"stateTransitions": {
"terminal": "terminal",
"transient": "terminal",
"not_found": "terminal",
"unknown": "terminal"
}
},
{
"model": "gemini-3-flash-preview",
"isLastResort": true,
"actions": {
"terminal": "prompt",
"transient": "prompt",
"not_found": "prompt",
"unknown": "prompt"
},
"stateTransitions": {
"terminal": "terminal",
"transient": "terminal",
"not_found": "terminal",
"unknown": "terminal"
}
}
],
"default": [
{
"model": "gemini-2.5-pro",
"actions": {
"terminal": "prompt",
"transient": "prompt",
"not_found": "prompt",
"unknown": "prompt"
},
"stateTransitions": {
"terminal": "terminal",
"transient": "terminal",
"not_found": "terminal",
"unknown": "terminal"
}
},
{
"model": "gemini-2.5-flash",
"isLastResort": true,
"actions": {
"terminal": "prompt",
"transient": "prompt",
"not_found": "prompt",
"unknown": "prompt"
},
"stateTransitions": {
"terminal": "terminal",
"transient": "terminal",
"not_found": "terminal",
"unknown": "terminal"
}
}
],
"lite": [
{
"model": "gemini-2.5-flash-lite",
"actions": {
"terminal": "silent",
"transient": "silent",
"not_found": "silent",
"unknown": "silent"
},
"stateTransitions": {
"terminal": "terminal",
"transient": "terminal",
"not_found": "terminal",
"unknown": "terminal"
}
},
{
"model": "gemini-2.5-flash",
"actions": {
"terminal": "silent",
"transient": "silent",
"not_found": "silent",
"unknown": "silent"
},
"stateTransitions": {
"terminal": "terminal",
"transient": "terminal",
"not_found": "terminal",
"unknown": "terminal"
}
},
{
"model": "gemini-2.5-pro",
"isLastResort": true,
"actions": {
"terminal": "silent",
"transient": "silent",
"not_found": "silent",
"unknown": "silent"
},
"stateTransitions": {
"terminal": "terminal",
"transient": "terminal",
"not_found": "terminal",
"unknown": "terminal"
}
}
]
}
}8 nested properties
Named presets for model configs. Can be used in place of a model name and can inherit from other aliases using an extends property.
- Category:
Model - Requires restart:
no - Default:
{ "base": { "modelConfig": { "generateContentConfig": { "temperature": 0, "topP": 1 } } }, "chat-base": { "extends": "base", "modelConfig": { "generateContentConfig": { "thinkingConfig": { "includeThoughts": true }, "temperature": 1, "topP": 0.95, "topK": 64 } } }, "chat-base-2.5": { "extends": "chat-base", "modelConfig": { "generateContentConfig": { "thinkingConfig": { "thinkingBudget": 8192 } } } }, "chat-base-3": { "extends": "chat-base", "modelConfig": { "generateContentConfig": { "thinkingConfig": { "thinkingLevel": "HIGH" } } } }, "gemini-3-pro-preview": { "extends": "chat-base-3", "modelConfig": { "model": "gemini-3-pro-preview" } }, "gemini-3-flash-preview": { "extends": "chat-base-3", "modelConfig": { "model": "gemini-3-flash-preview" } }, "gemini-2.5-pro": { "extends": "chat-base-2.5", "modelConfig": { "model": "gemini-2.5-pro" } }, "gemini-2.5-flash": { "extends": "chat-base-2.5", "modelConfig": { "model": "gemini-2.5-flash" } }, "gemini-2.5-flash-lite": { "extends": "chat-base-2.5", "modelConfig": { "model": "gemini-2.5-flash-lite" } }, "gemini-2.5-flash-base": { "extends": "base", "modelConfig": { "model": "gemini-2.5-flash" } }, "gemini-3-flash-base": { "extends": "base", "modelConfig": { "model": "gemini-3-flash-preview" } }, "classifier": { "extends": "base", "modelConfig": { "model": "gemini-2.5-flash-lite", "generateContentConfig": { "maxOutputTokens": 1024, "thinkingConfig": { "thinkingBudget": 512 } } } }, "prompt-completion": { "extends": "base", "modelConfig": { "model": "gemini-2.5-flash-lite", "generateContentConfig": { "temperature": 0.3, "maxOutputTokens": 16000, "thinkingConfig": { "thinkingBudget": 0 } } } }, "fast-ack-helper": { "extends": "base", "modelConfig": { "model": "gemini-2.5-flash-lite", "generateContentConfig": { "temperature": 0.2, "maxOutputTokens": 120, "thinkingConfig": { "thinkingBudget": 0 } } } }, "edit-corrector": { "extends": "base", "modelConfig": { "model": "gemini-2.5-flash-lite", "generateContentConfig": { "thinkingConfig": { "thinkingBudget": 0 } } } }, "summarizer-default": { "extends": "base", "modelConfig": { "model": "gemini-2.5-flash-lite", "generateContentConfig": { "maxOutputTokens": 2000 } } }, "summarizer-shell": { "extends": "base", "modelConfig": { "model": "gemini-2.5-flash-lite", "generateContentConfig": { "maxOutputTokens": 2000 } } }, "web-search": { "extends": "gemini-3-flash-base", "modelConfig": { "generateContentConfig": { "tools": [ { "googleSearch": {} } ] } } }, "web-fetch": { "extends": "gemini-3-flash-base", "modelConfig": { "generateContentConfig": { "tools": [ { "urlContext": {} } ] } } }, "web-fetch-fallback": { "extends": "gemini-3-flash-base", "modelConfig": {} }, "loop-detection": { "extends": "gemini-3-flash-base", "modelConfig": {} }, "loop-detection-double-check": { "extends": "base", "modelConfig": { "model": "gemini-3-pro-preview" } }, "llm-edit-fixer": { "extends": "gemini-3-flash-base", "modelConfig": {} }, "next-speaker-checker": { "extends": "gemini-3-flash-base", "modelConfig": {} }, "chat-compression-3-pro": { "modelConfig": { "model": "gemini-3-pro-preview" } }, "chat-compression-3-flash": { "modelConfig": { "model": "gemini-3-flash-preview" } }, "chat-compression-3.1-flash-lite": { "modelConfig": { "model": "gemini-3.1-flash-lite-preview" } }, "chat-compression-2.5-pro": { "modelConfig": { "model": "gemini-2.5-pro" } }, "chat-compression-2.5-flash": { "modelConfig": { "model": "gemini-2.5-flash" } }, "chat-compression-2.5-flash-lite": { "modelConfig": { "model": "gemini-2.5-flash-lite" } }, "chat-compression-default": { "modelConfig": { "model": "gemini-3-pro-preview" } }, "agent-history-provider-summarizer": { "modelConfig": { "model": "gemini-3-flash-preview" } } }
{
"base": {
"modelConfig": {
"generateContentConfig": {
"temperature": 0,
"topP": 1
}
}
},
"chat-base": {
"extends": "base",
"modelConfig": {
"generateContentConfig": {
"thinkingConfig": {
"includeThoughts": true
},
"temperature": 1,
"topP": 0.95,
"topK": 64
}
}
},
"chat-base-2.5": {
"extends": "chat-base",
"modelConfig": {
"generateContentConfig": {
"thinkingConfig": {
"thinkingBudget": 8192
}
}
}
},
"chat-base-3": {
"extends": "chat-base",
"modelConfig": {
"generateContentConfig": {
"thinkingConfig": {
"thinkingLevel": "HIGH"
}
}
}
},
"gemini-3-pro-preview": {
"extends": "chat-base-3",
"modelConfig": {
"model": "gemini-3-pro-preview"
}
},
"gemini-3-flash-preview": {
"extends": "chat-base-3",
"modelConfig": {
"model": "gemini-3-flash-preview"
}
},
"gemini-2.5-pro": {
"extends": "chat-base-2.5",
"modelConfig": {
"model": "gemini-2.5-pro"
}
},
"gemini-2.5-flash": {
"extends": "chat-base-2.5",
"modelConfig": {
"model": "gemini-2.5-flash"
}
},
"gemini-2.5-flash-lite": {
"extends": "chat-base-2.5",
"modelConfig": {
"model": "gemini-2.5-flash-lite"
}
},
"gemini-2.5-flash-base": {
"extends": "base",
"modelConfig": {
"model": "gemini-2.5-flash"
}
},
"gemini-3-flash-base": {
"extends": "base",
"modelConfig": {
"model": "gemini-3-flash-preview"
}
},
"classifier": {
"extends": "base",
"modelConfig": {
"model": "gemini-2.5-flash-lite",
"generateContentConfig": {
"maxOutputTokens": 1024,
"thinkingConfig": {
"thinkingBudget": 512
}
}
}
},
"prompt-completion": {
"extends": "base",
"modelConfig": {
"model": "gemini-2.5-flash-lite",
"generateContentConfig": {
"temperature": 0.3,
"maxOutputTokens": 16000,
"thinkingConfig": {
"thinkingBudget": 0
}
}
}
},
"fast-ack-helper": {
"extends": "base",
"modelConfig": {
"model": "gemini-2.5-flash-lite",
"generateContentConfig": {
"temperature": 0.2,
"maxOutputTokens": 120,
"thinkingConfig": {
"thinkingBudget": 0
}
}
}
},
"edit-corrector": {
"extends": "base",
"modelConfig": {
"model": "gemini-2.5-flash-lite",
"generateContentConfig": {
"thinkingConfig": {
"thinkingBudget": 0
}
}
}
},
"summarizer-default": {
"extends": "base",
"modelConfig": {
"model": "gemini-2.5-flash-lite",
"generateContentConfig": {
"maxOutputTokens": 2000
}
}
},
"summarizer-shell": {
"extends": "base",
"modelConfig": {
"model": "gemini-2.5-flash-lite",
"generateContentConfig": {
"maxOutputTokens": 2000
}
}
},
"web-search": {
"extends": "gemini-3-flash-base",
"modelConfig": {
"generateContentConfig": {
"tools": [
{
"googleSearch": {}
}
]
}
}
},
"web-fetch": {
"extends": "gemini-3-flash-base",
"modelConfig": {
"generateContentConfig": {
"tools": [
{
"urlContext": {}
}
]
}
}
},
"web-fetch-fallback": {
"extends": "gemini-3-flash-base",
"modelConfig": {}
},
"loop-detection": {
"extends": "gemini-3-flash-base",
"modelConfig": {}
},
"loop-detection-double-check": {
"extends": "base",
"modelConfig": {
"model": "gemini-3-pro-preview"
}
},
"llm-edit-fixer": {
"extends": "gemini-3-flash-base",
"modelConfig": {}
},
"next-speaker-checker": {
"extends": "gemini-3-flash-base",
"modelConfig": {}
},
"chat-compression-3-pro": {
"modelConfig": {
"model": "gemini-3-pro-preview"
}
},
"chat-compression-3-flash": {
"modelConfig": {
"model": "gemini-3-flash-preview"
}
},
"chat-compression-3.1-flash-lite": {
"modelConfig": {
"model": "gemini-3.1-flash-lite-preview"
}
},
"chat-compression-2.5-pro": {
"modelConfig": {
"model": "gemini-2.5-pro"
}
},
"chat-compression-2.5-flash": {
"modelConfig": {
"model": "gemini-2.5-flash"
}
},
"chat-compression-2.5-flash-lite": {
"modelConfig": {
"model": "gemini-2.5-flash-lite"
}
},
"chat-compression-default": {
"modelConfig": {
"model": "gemini-3-pro-preview"
}
},
"agent-history-provider-summarizer": {
"modelConfig": {
"model": "gemini-3-flash-preview"
}
}
}Custom named presets for model configs. These are merged with (and override) the built-in aliases.
- Category:
Model - Requires restart:
no - Default:
{}
{}Custom model config overrides. These are merged with (and added to) the built-in overrides.
- Category:
Model - Requires restart:
no - Default:
[]
[]Apply specific configuration overrides based on matches, with a primary key of model (or alias). The most specific match will be used.
- Category:
Model - Requires restart:
no - Default:
[]
[]Registry of model metadata, including tier, family, and features.
- Category:
Model - Requires restart:
yes - Default:
{ "gemini-3.1-flash-lite-preview": { "tier": "flash-lite", "family": "gemini-3", "isPreview": true, "isVisible": true, "features": { "thinking": false, "multimodalToolUse": true } }, "gemini-3.1-pro-preview": { "tier": "pro", "family": "gemini-3", "isPreview": true, "isVisible": true, "features": { "thinking": true, "multimodalToolUse": true } }, "gemini-3.1-pro-preview-customtools": { "tier": "pro", "family": "gemini-3", "isPreview": true, "isVisible": false, "features": { "thinking": true, "multimodalToolUse": true } }, "gemini-3-pro-preview": { "tier": "pro", "family": "gemini-3", "isPreview": true, "isVisible": true, "features": { "thinking": true, "multimodalToolUse": true } }, "gemini-3-flash-preview": { "tier": "flash", "family": "gemini-3", "isPreview": true, "isVisible": true, "features": { "thinking": false, "multimodalToolUse": true } }, "gemini-2.5-pro": { "tier": "pro", "family": "gemini-2.5", "isPreview": false, "isVisible": true, "features": { "thinking": false, "multimodalToolUse": false } }, "gemini-2.5-flash": { "tier": "flash", "family": "gemini-2.5", "isPreview": false, "isVisible": true, "features": { "thinking": false, "multimodalToolUse": false } }, "gemini-2.5-flash-lite": { "tier": "flash-lite", "family": "gemini-2.5", "isPreview": false, "isVisible": true, "features": { "thinking": false, "multimodalToolUse": false } }, "auto": { "tier": "auto", "isPreview": true, "isVisible": false, "features": { "thinking": true, "multimodalToolUse": false } }, "pro": { "tier": "pro", "isPreview": false, "isVisible": false, "features": { "thinking": true, "multimodalToolUse": false } }, "flash": { "tier": "flash", "isPreview": false, "isVisible": false, "features": { "thinking": false, "multimodalToolUse": false } }, "flash-lite": { "tier": "flash-lite", "isPreview": false, "isVisible": false, "features": { "thinking": false, "multimodalToolUse": false } }, "auto-gemini-3": { "displayName": "Auto (Gemini 3)", "tier": "auto", "isPreview": true, "isVisible": true, "dialogDescription": "Let Gemini CLI decide the best model for the task: gemini-3-pro, gemini-3-flash", "features": { "thinking": true, "multimodalToolUse": false } }, "auto-gemini-2.5": { "displayName": "Auto (Gemini 2.5)", "tier": "auto", "isPreview": false, "isVisible": true, "dialogDescription": "Let Gemini CLI decide the best model for the task: gemini-2.5-pro, gemini-2.5-flash", "features": { "thinking": false, "multimodalToolUse": false } } }
{
"gemini-3.1-flash-lite-preview": {
"tier": "flash-lite",
"family": "gemini-3",
"isPreview": true,
"isVisible": true,
"features": {
"thinking": false,
"multimodalToolUse": true
}
},
"gemini-3.1-pro-preview": {
"tier": "pro",
"family": "gemini-3",
"isPreview": true,
"isVisible": true,
"features": {
"thinking": true,
"multimodalToolUse": true
}
},
"gemini-3.1-pro-preview-customtools": {
"tier": "pro",
"family": "gemini-3",
"isPreview": true,
"isVisible": false,
"features": {
"thinking": true,
"multimodalToolUse": true
}
},
"gemini-3-pro-preview": {
"tier": "pro",
"family": "gemini-3",
"isPreview": true,
"isVisible": true,
"features": {
"thinking": true,
"multimodalToolUse": true
}
},
"gemini-3-flash-preview": {
"tier": "flash",
"family": "gemini-3",
"isPreview": true,
"isVisible": true,
"features": {
"thinking": false,
"multimodalToolUse": true
}
},
"gemini-2.5-pro": {
"tier": "pro",
"family": "gemini-2.5",
"isPreview": false,
"isVisible": true,
"features": {
"thinking": false,
"multimodalToolUse": false
}
},
"gemini-2.5-flash": {
"tier": "flash",
"family": "gemini-2.5",
"isPreview": false,
"isVisible": true,
"features": {
"thinking": false,
"multimodalToolUse": false
}
},
"gemini-2.5-flash-lite": {
"tier": "flash-lite",
"family": "gemini-2.5",
"isPreview": false,
"isVisible": true,
"features": {
"thinking": false,
"multimodalToolUse": false
}
},
"auto": {
"tier": "auto",
"isPreview": true,
"isVisible": false,
"features": {
"thinking": true,
"multimodalToolUse": false
}
},
"pro": {
"tier": "pro",
"isPreview": false,
"isVisible": false,
"features": {
"thinking": true,
"multimodalToolUse": false
}
},
"flash": {
"tier": "flash",
"isPreview": false,
"isVisible": false,
"features": {
"thinking": false,
"multimodalToolUse": false
}
},
"flash-lite": {
"tier": "flash-lite",
"isPreview": false,
"isVisible": false,
"features": {
"thinking": false,
"multimodalToolUse": false
}
},
"auto-gemini-3": {
"displayName": "Auto (Gemini 3)",
"tier": "auto",
"isPreview": true,
"isVisible": true,
"dialogDescription": "Let Gemini CLI decide the best model for the task: gemini-3-pro, gemini-3-flash",
"features": {
"thinking": true,
"multimodalToolUse": false
}
},
"auto-gemini-2.5": {
"displayName": "Auto (Gemini 2.5)",
"tier": "auto",
"isPreview": false,
"isVisible": true,
"dialogDescription": "Let Gemini CLI decide the best model for the task: gemini-2.5-pro, gemini-2.5-flash",
"features": {
"thinking": false,
"multimodalToolUse": false
}
}
}Rules for resolving requested model names to concrete model IDs based on context.
- Category:
Model - Requires restart:
yes - Default:
{ "gemini-3.1-pro-preview": { "default": "gemini-3.1-pro-preview", "contexts": [ { "condition": { "hasAccessToPreview": false }, "target": "gemini-2.5-pro" }, { "condition": { "useCustomTools": true }, "target": "gemini-3.1-pro-preview-customtools" } ] }, "gemini-3.1-pro-preview-customtools": { "default": "gemini-3.1-pro-preview-customtools", "contexts": [ { "condition": { "hasAccessToPreview": false }, "target": "gemini-2.5-pro" } ] }, "gemini-3-flash-preview": { "default": "gemini-3-flash-preview", "contexts": [ { "condition": { "hasAccessToPreview": false }, "target": "gemini-2.5-flash" } ] }, "gemini-3-pro-preview": { "default": "gemini-3-pro-preview", "contexts": [ { "condition": { "hasAccessToPreview": false }, "target": "gemini-2.5-pro" }, { "condition": { "useGemini3_1": true, "useCustomTools": true }, "target": "gemini-3.1-pro-preview-customtools" }, { "condition": { "useGemini3_1": true }, "target": "gemini-3.1-pro-preview" } ] }, "auto-gemini-3": { "default": "gemini-3-pro-preview", "contexts": [ { "condition": { "hasAccessToPreview": false }, "target": "gemini-2.5-pro" }, { "condition": { "useGemini3_1": true, "useCustomTools": true }, "target": "gemini-3.1-pro-preview-customtools" }, { "condition": { "useGemini3_1": true }, "target": "gemini-3.1-pro-preview" } ] }, "auto": { "default": "gemini-3-pro-preview", "contexts": [ { "condition": { "hasAccessToPreview": false }, "target": "gemini-2.5-pro" }, { "condition": { "useGemini3_1": true, "useCustomTools": true }, "target": "gemini-3.1-pro-preview-customtools" }, { "condition": { "useGemini3_1": true }, "target": "gemini-3.1-pro-preview" } ] }, "pro": { "default": "gemini-3-pro-preview", "contexts": [ { "condition": { "hasAccessToPreview": false }, "target": "gemini-2.5-pro" }, { "condition": { "useGemini3_1": true, "useCustomTools": true }, "target": "gemini-3.1-pro-preview-customtools" }, { "condition": { "useGemini3_1": true }, "target": "gemini-3.1-pro-preview" } ] }, "auto-gemini-2.5": { "default": "gemini-2.5-pro" }, "gemini-3.1-flash-lite-preview": { "default": "gemini-3.1-flash-lite-preview", "contexts": [ { "condition": { "useGemini3_1FlashLite": false }, "target": "gemini-2.5-flash-lite" } ] }, "flash": { "default": "gemini-3-flash-preview", "contexts": [ { "condition": { "hasAccessToPreview": false }, "target": "gemini-2.5-flash" } ] }, "flash-lite": { "default": "gemini-2.5-flash-lite", "contexts": [ { "condition": { "useGemini3_1FlashLite": true }, "target": "gemini-3.1-flash-lite-preview" } ] } }
{
"gemini-3.1-pro-preview": {
"default": "gemini-3.1-pro-preview",
"contexts": [
{
"condition": {
"hasAccessToPreview": false
},
"target": "gemini-2.5-pro"
},
{
"condition": {
"useCustomTools": true
},
"target": "gemini-3.1-pro-preview-customtools"
}
]
},
"gemini-3.1-pro-preview-customtools": {
"default": "gemini-3.1-pro-preview-customtools",
"contexts": [
{
"condition": {
"hasAccessToPreview": false
},
"target": "gemini-2.5-pro"
}
]
},
"gemini-3-flash-preview": {
"default": "gemini-3-flash-preview",
"contexts": [
{
"condition": {
"hasAccessToPreview": false
},
"target": "gemini-2.5-flash"
}
]
},
"gemini-3-pro-preview": {
"default": "gemini-3-pro-preview",
"contexts": [
{
"condition": {
"hasAccessToPreview": false
},
"target": "gemini-2.5-pro"
},
{
"condition": {
"useGemini3_1": true,
"useCustomTools": true
},
"target": "gemini-3.1-pro-preview-customtools"
},
{
"condition": {
"useGemini3_1": true
},
"target": "gemini-3.1-pro-preview"
}
]
},
"auto-gemini-3": {
"default": "gemini-3-pro-preview",
"contexts": [
{
"condition": {
"hasAccessToPreview": false
},
"target": "gemini-2.5-pro"
},
{
"condition": {
"useGemini3_1": true,
"useCustomTools": true
},
"target": "gemini-3.1-pro-preview-customtools"
},
{
"condition": {
"useGemini3_1": true
},
"target": "gemini-3.1-pro-preview"
}
]
},
"auto": {
"default": "gemini-3-pro-preview",
"contexts": [
{
"condition": {
"hasAccessToPreview": false
},
"target": "gemini-2.5-pro"
},
{
"condition": {
"useGemini3_1": true,
"useCustomTools": true
},
"target": "gemini-3.1-pro-preview-customtools"
},
{
"condition": {
"useGemini3_1": true
},
"target": "gemini-3.1-pro-preview"
}
]
},
"pro": {
"default": "gemini-3-pro-preview",
"contexts": [
{
"condition": {
"hasAccessToPreview": false
},
"target": "gemini-2.5-pro"
},
{
"condition": {
"useGemini3_1": true,
"useCustomTools": true
},
"target": "gemini-3.1-pro-preview-customtools"
},
{
"condition": {
"useGemini3_1": true
},
"target": "gemini-3.1-pro-preview"
}
]
},
"auto-gemini-2.5": {
"default": "gemini-2.5-pro"
},
"gemini-3.1-flash-lite-preview": {
"default": "gemini-3.1-flash-lite-preview",
"contexts": [
{
"condition": {
"useGemini3_1FlashLite": false
},
"target": "gemini-2.5-flash-lite"
}
]
},
"flash": {
"default": "gemini-3-flash-preview",
"contexts": [
{
"condition": {
"hasAccessToPreview": false
},
"target": "gemini-2.5-flash"
}
]
},
"flash-lite": {
"default": "gemini-2.5-flash-lite",
"contexts": [
{
"condition": {
"useGemini3_1FlashLite": true
},
"target": "gemini-3.1-flash-lite-preview"
}
]
}
}Rules for resolving classifier tiers (flash, pro) to concrete model IDs.
- Category:
Model - Requires restart:
yes - Default:
{ "flash": { "default": "gemini-3-flash-preview", "contexts": [ { "condition": { "requestedModels": [ "auto-gemini-2.5", "gemini-2.5-pro" ] }, "target": "gemini-2.5-flash" }, { "condition": { "requestedModels": [ "auto-gemini-3", "gemini-3-pro-preview" ] }, "target": "gemini-3-flash-preview" } ] }, "pro": { "default": "gemini-3-pro-preview", "contexts": [ { "condition": { "requestedModels": [ "auto-gemini-2.5", "gemini-2.5-pro" ] }, "target": "gemini-2.5-pro" }, { "condition": { "useGemini3_1": true, "useCustomTools": true }, "target": "gemini-3.1-pro-preview-customtools" }, { "condition": { "useGemini3_1": true }, "target": "gemini-3.1-pro-preview" } ] } }
{
"flash": {
"default": "gemini-3-flash-preview",
"contexts": [
{
"condition": {
"requestedModels": [
"auto-gemini-2.5",
"gemini-2.5-pro"
]
},
"target": "gemini-2.5-flash"
},
{
"condition": {
"requestedModels": [
"auto-gemini-3",
"gemini-3-pro-preview"
]
},
"target": "gemini-3-flash-preview"
}
]
},
"pro": {
"default": "gemini-3-pro-preview",
"contexts": [
{
"condition": {
"requestedModels": [
"auto-gemini-2.5",
"gemini-2.5-pro"
]
},
"target": "gemini-2.5-pro"
},
{
"condition": {
"useGemini3_1": true,
"useCustomTools": true
},
"target": "gemini-3.1-pro-preview-customtools"
},
{
"condition": {
"useGemini3_1": true
},
"target": "gemini-3.1-pro-preview"
}
]
}
}Availability policy chains defining fallback behavior for models.
- Category:
Model - Requires restart:
yes - Default:
{ "preview": [ { "model": "gemini-3-pro-preview", "actions": { "terminal": "prompt", "transient": "prompt", "not_found": "prompt", "unknown": "prompt" }, "stateTransitions": { "terminal": "terminal", "transient": "terminal", "not_found": "terminal", "unknown": "terminal" } }, { "model": "gemini-3-flash-preview", "isLastResort": true, "actions": { "terminal": "prompt", "transient": "prompt", "not_found": "prompt", "unknown": "prompt" }, "stateTransitions": { "terminal": "terminal", "transient": "terminal", "not_found": "terminal", "unknown": "terminal" } } ], "default": [ { "model": "gemini-2.5-pro", "actions": { "terminal": "prompt", "transient": "prompt", "not_found": "prompt", "unknown": "prompt" }, "stateTransitions": { "terminal": "terminal", "transient": "terminal", "not_found": "terminal", "unknown": "terminal" } }, { "model": "gemini-2.5-flash", "isLastResort": true, "actions": { "terminal": "prompt", "transient": "prompt", "not_found": "prompt", "unknown": "prompt" }, "stateTransitions": { "terminal": "terminal", "transient": "terminal", "not_found": "terminal", "unknown": "terminal" } } ], "lite": [ { "model": "gemini-2.5-flash-lite", "actions": { "terminal": "silent", "transient": "silent", "not_found": "silent", "unknown": "silent" }, "stateTransitions": { "terminal": "terminal", "transient": "terminal", "not_found": "terminal", "unknown": "terminal" } }, { "model": "gemini-2.5-flash", "actions": { "terminal": "silent", "transient": "silent", "not_found": "silent", "unknown": "silent" }, "stateTransitions": { "terminal": "terminal", "transient": "terminal", "not_found": "terminal", "unknown": "terminal" } }, { "model": "gemini-2.5-pro", "isLastResort": true, "actions": { "terminal": "silent", "transient": "silent", "not_found": "silent", "unknown": "silent" }, "stateTransitions": { "terminal": "terminal", "transient": "terminal", "not_found": "terminal", "unknown": "terminal" } } ] }
{
"preview": [
{
"model": "gemini-3-pro-preview",
"actions": {
"terminal": "prompt",
"transient": "prompt",
"not_found": "prompt",
"unknown": "prompt"
},
"stateTransitions": {
"terminal": "terminal",
"transient": "terminal",
"not_found": "terminal",
"unknown": "terminal"
}
},
{
"model": "gemini-3-flash-preview",
"isLastResort": true,
"actions": {
"terminal": "prompt",
"transient": "prompt",
"not_found": "prompt",
"unknown": "prompt"
},
"stateTransitions": {
"terminal": "terminal",
"transient": "terminal",
"not_found": "terminal",
"unknown": "terminal"
}
}
],
"default": [
{
"model": "gemini-2.5-pro",
"actions": {
"terminal": "prompt",
"transient": "prompt",
"not_found": "prompt",
"unknown": "prompt"
},
"stateTransitions": {
"terminal": "terminal",
"transient": "terminal",
"not_found": "terminal",
"unknown": "terminal"
}
},
{
"model": "gemini-2.5-flash",
"isLastResort": true,
"actions": {
"terminal": "prompt",
"transient": "prompt",
"not_found": "prompt",
"unknown": "prompt"
},
"stateTransitions": {
"terminal": "terminal",
"transient": "terminal",
"not_found": "terminal",
"unknown": "terminal"
}
}
],
"lite": [
{
"model": "gemini-2.5-flash-lite",
"actions": {
"terminal": "silent",
"transient": "silent",
"not_found": "silent",
"unknown": "silent"
},
"stateTransitions": {
"terminal": "terminal",
"transient": "terminal",
"not_found": "terminal",
"unknown": "terminal"
}
},
{
"model": "gemini-2.5-flash",
"actions": {
"terminal": "silent",
"transient": "silent",
"not_found": "silent",
"unknown": "silent"
},
"stateTransitions": {
"terminal": "terminal",
"transient": "terminal",
"not_found": "terminal",
"unknown": "terminal"
}
},
{
"model": "gemini-2.5-pro",
"isLastResort": true,
"actions": {
"terminal": "silent",
"transient": "silent",
"not_found": "silent",
"unknown": "silent"
},
"stateTransitions": {
"terminal": "terminal",
"transient": "terminal",
"not_found": "terminal",
"unknown": "terminal"
}
}
]
}Settings for subagents.
- Category:
Advanced - Requires restart:
yes - Default:
{}
{}2 nested properties
Override settings for specific agents, e.g. to disable the agent, set a custom model config, or run config.
- Category:
Advanced - Requires restart:
yes - Default:
{}
{}Settings specific to the browser agent.
- Category:
Advanced - Requires restart:
yes - Default:
{}
{}9 nested properties
Session mode: 'persistent', 'isolated', or 'existing'.
- Category:
Advanced - Requires restart:
yes - Default:
persistent
Run browser in headless mode.
- Category:
Advanced - Requires restart:
yes - Default:
false
Path to browser profile directory for session persistence.
- Category:
Advanced - Requires restart:
yes
Model for the visual agent's analyze_screenshot tool. When set, enables the tool.
- Category:
Advanced - Requires restart:
yes
A list of allowed domains for the browser agent (e.g., ["github.com", "*.google.com"]).
- Category:
Advanced - Requires restart:
yes - Default:
[ "github.com", "*.google.com", "localhost" ]
[
"github.com",
"*.google.com",
"localhost"
]Disable user input on browser window during automation.
- Category:
Advanced - Requires restart:
no - Default:
true
The maximum number of tool calls allowed per browser task. Enforcement is hard: the agent will be terminated when the limit is reached.
- Category:
Advanced - Requires restart:
no - Default:
100
Require manual confirmation for sensitive browser actions (e.g., fill_form, evaluate_script).
- Category:
Advanced - Requires restart:
yes - Default:
false
Hard-block file upload requests from the browser agent.
- Category:
Advanced - Requires restart:
yes - Default:
false
Settings for managing context provided to the model.
- Category:
Context - Requires restart:
no - Default:
{}
{}8 nested properties
Accepts either a single string or an array of strings.
The format to use when importing memory.
- Category:
Context - Requires restart:
no
Whether to include the directory tree of the current working directory in the initial request to the model.
- Category:
Context - Requires restart:
no - Default:
true
Maximum number of directories to search for memory.
- Category:
Context - Requires restart:
no - Default:
200
File or directory names that mark the boundary for GEMINI.md discovery. The upward traversal stops at the first directory containing any of these markers. An empty array disables parent traversal.
- Category:
Context - Requires restart:
yes - Default:
[ ".git" ]
[
".git"
]Additional directories to include in the workspace context. Missing directories will be skipped with a warning.
- Category:
Context - Requires restart:
no - Default:
[]
[]Controls how /memory reload loads GEMINI.md files. When true, include directories are scanned; when false, only the current directory is used.
- Category:
Context - Requires restart:
no - Default:
false
Settings for git-aware file filtering.
- Category:
Context - Requires restart:
yes - Default:
{}
{}5 nested properties
Respect .gitignore files when searching.
- Category:
Context - Requires restart:
yes - Default:
true
Respect .geminiignore files when searching.
- Category:
Context - Requires restart:
yes - Default:
true
Enable recursive file search functionality when completing @ references in the prompt.
- Category:
Context - Requires restart:
yes - Default:
true
Enable fuzzy search when searching for files.
- Category:
Context - Requires restart:
yes - Default:
true
Additional ignore file paths to respect. These files take precedence over .geminiignore and .gitignore. Files earlier in the array take precedence over files later in the array, e.g. the first file takes precedence over the second one.
- Category:
Context - Requires restart:
yes - Default:
[]
[]Settings for built-in and custom tools.
- Category:
Tools - Requires restart:
yes - Default:
{}
{}12 nested properties
Accepts either a boolean flag, a string command name, or a configuration object.
List of additional paths that the sandbox is allowed to access.
- Category:
Tools - Requires restart:
yes - Default:
[]
[]Whether the sandbox is allowed to access the network.
- Category:
Tools - Requires restart:
yes - Default:
false
Settings for shell execution.
- Category:
Tools - Requires restart:
no - Default:
{}
{}6 nested properties
Use node-pty for an interactive shell experience. Fallback to child_process still applies.
- Category:
Tools - Requires restart:
yes - Default:
true
Controls what happens when a background shell command finishes. 'silent' (default): quietly exits in background. 'inject': automatically returns output to agent. 'notify': shows brief message in chat.
- Category:
Tools - Requires restart:
no - Default:
silent
The pager command to use for shell output. Defaults to cat.
- Category:
Tools - Requires restart:
no - Default:
cat
Show color in shell output.
- Category:
Tools - Requires restart:
no - Default:
true
The maximum time in seconds allowed without output from the shell command. Defaults to 5 minutes.
- Category:
Tools - Requires restart:
no - Default:
300
Enable shell output efficiency optimizations for better performance.
- Category:
Tools - Requires restart:
no - Default:
true
Restrict the set of built-in tools with an allowlist. Match semantics mirror tools.allowed; see the built-in tools documentation for available names.
- Category:
Tools - Requires restart:
yes
Tool names that bypass the confirmation dialog. Useful for trusted commands (for example ["run_shell_command(git)", "run_shell_command(npm test)"]). See shell tool command restrictions for matching details.
- Category:
Advanced - Requires restart:
yes
Tool names to exclude from discovery.
- Category:
Tools - Requires restart:
yes
Command to run for tool discovery.
- Category:
Tools - Requires restart:
yes
Defines a custom shell command for invoking discovered tools. The command must take the tool name as the first argument, read JSON arguments from stdin, and emit JSON results on stdout.
- Category:
Tools - Requires restart:
yes
Use ripgrep for file content search instead of the fallback implementation. Provides faster search performance.
- Category:
Tools - Requires restart:
no - Default:
true
Maximum characters to show when truncating large tool outputs. Set to 0 or negative to disable truncation.
- Category:
General - Requires restart:
yes - Default:
40000
Disable 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.
- Category:
Tools - Requires restart:
yes - Default:
true
Settings for Model Context Protocol (MCP) servers.
- Category:
MCP - Requires restart:
yes - Default:
{}
{}3 nested properties
Command to start an MCP server.
- Category:
MCP - Requires restart:
yes
A list of MCP servers to allow.
- Category:
MCP - Requires restart:
yes
A list of MCP servers to exclude.
- Category:
MCP - Requires restart:
yes
Enable the write_todos tool.
- Category:
Advanced - Requires restart:
no - Default:
true
Security-related settings.
- Category:
Security - Requires restart:
yes - Default:
{}
{}11 nested properties
Tool-level sandboxing. Isolates individual tools instead of the entire CLI process.
- Category:
Security - Requires restart:
yes - Default:
false
Disable YOLO mode, even if enabled by a flag.
- Category:
Security - Requires restart:
yes - Default:
false
Disable "Always allow" options in tool confirmation dialogs.
- Category:
Security - Requires restart:
yes - Default:
false
Enable the "Allow for all future sessions" option in tool confirmation dialogs.
- Category:
Security - Requires restart:
no - Default:
false
When enabled, the "Allow for all future sessions" option becomes the default choice for low-risk tools in trusted workspaces.
- Category:
Security - Requires restart:
no - Default:
false
Blocks installing and loading extensions from Git.
- Category:
Security - Requires restart:
yes - Default:
false
List of Regex patterns for allowed extensions. If nonempty, only extensions that match the patterns in this list are allowed. Overrides the blockGitExtensions setting.
- Category:
Security - Requires restart:
yes - Default:
[]
[]Settings for folder trust.
- Category:
Security - Requires restart:
no - Default:
{}
{}1 nested properties
Setting to track whether Folder trust is enabled.
- Category:
Security - Requires restart:
yes - Default:
true
Settings for environment variable redaction.
- Category:
Security - Requires restart:
no - Default:
{}
{}3 nested properties
Environment variables to always allow (bypass redaction).
- Category:
Security - Requires restart:
yes - Default:
[]
[]Environment variables to always redact.
- Category:
Security - Requires restart:
yes - Default:
[]
[]Enable redaction of environment variables that may contain secrets.
- Category:
Security - Requires restart:
yes - Default:
false
Authentication settings.
- Category:
Security - Requires restart:
yes - Default:
{}
{}3 nested properties
The currently selected authentication type.
- Category:
Security - Requires restart:
yes
The required auth type. If this does not match the selected auth type, the user will be prompted to re-authenticate.
- Category:
Advanced - Requires restart:
yes
Whether to use an external authentication flow.
- Category:
Security - Requires restart:
yes
Enable the context-aware security checker. This feature uses an LLM to dynamically generate and enforce security policies for tool use based on your prompt, providing an additional layer of protection against unintended actions.
- Category:
Security - Requires restart:
yes - Default:
false
Advanced settings for power users.
- Category:
Advanced - Requires restart:
yes - Default:
{}
{}4 nested properties
Automatically configure Node.js memory limits
- Category:
Advanced - Requires restart:
yes - Default:
true
The DNS resolution order.
- Category:
Advanced - Requires restart:
yes
Environment variables to exclude from project context.
- Category:
Advanced - Requires restart:
no - Default:
[ "DEBUG", "DEBUG_MODE" ]
[
"DEBUG",
"DEBUG_MODE"
]Configuration for the bug report helper command.
1 nested properties
Template used to open a bug report URL. Variables in the template are populated at runtime.
Setting to enable experimental features
- Category:
Experimental - Requires restart:
yes - Default:
{}
{}20 nested properties
Settings for the Agent Development Kit (ADK).
- Category:
Experimental - Requires restart:
yes - Default:
{}
{}1 nested properties
Enable non-interactive agent sessions.
- Category:
Experimental - Requires restart:
yes - Default:
false
Enable local and remote subagents.
- Category:
Experimental - Requires restart:
yes - Default:
true
Enable automated Git worktree management for parallel work.
- Category:
Experimental - Requires restart:
yes - Default:
false
Enable extension management features.
- Category:
Experimental - Requires restart:
yes - Default:
true
Enable requesting and fetching of extension settings.
- Category:
Experimental - Requires restart:
yes - Default:
true
Enable extension registry explore UI.
- Category:
Experimental - Requires restart:
yes - Default:
false
The URI (web URL or local file path) of the extension registry.
- Category:
Experimental - Requires restart:
yes - Default:
https://geminicli.com/extensions.json
Enables extension loading/unloading within the CLI session.
- Category:
Experimental - Requires restart:
yes - Default:
false
Enable Just-In-Time (JIT) context loading.
- Category:
Experimental - Requires restart:
yes - Default:
false
Use OSC 52 for pasting. This may be more robust than the default system when using remote terminal sessions (if your terminal is configured to allow it).
- Category:
Experimental - Requires restart:
no - Default:
false
Use OSC 52 for copying. This may be more robust than the default system when using remote terminal sessions (if your terminal is configured to allow it).
- Category:
Experimental - Requires restart:
no - Default:
false
Enable task tracker tools.
- Category:
Experimental - Requires restart:
yes - Default:
false
Enable model steering (user hints) to guide the model during tool execution.
- Category:
Experimental - Requires restart:
no - Default:
false
Enable web fetch behavior that bypasses LLM summarization.
- Category:
Experimental - Requires restart:
yes - Default:
false
Enable dynamic model configuration (definitions, resolutions, and chains) via settings.
- Category:
Experimental - Requires restart:
yes - Default:
false
Enable Gemma model router (experimental).
- Category:
Experimental - Requires restart:
yes - Default:
{}
{}2 nested properties
Enable the Gemma Model Router (experimental). Requires a local endpoint serving Gemma via the Gemini API using LiteRT-LM shim.
- Category:
Experimental - Requires restart:
yes - Default:
false
Classifier configuration.
- Category:
Experimental - Requires restart:
yes - Default:
{}
{}2 nested properties
The host of the classifier.
- Category:
Experimental - Requires restart:
yes - Default:
http://localhost:9379
The model to use for the classifier. Only tested on gemma3-1b-gpu-custom.
- Category:
Experimental - Requires restart:
yes - Default:
gemma3-1b-gpu-custom
Replace the built-in save_memory tool with a memory manager subagent that supports adding, removing, de-duplicating, and organizing memories.
- Category:
Experimental - Requires restart:
yes - Default:
false
Suitable for general coding and software development tasks.
- Category:
Experimental - Requires restart:
yes - Default:
false
Enable logic for context management.
- Category:
Experimental - Requires restart:
yes - Default:
false
Enable the experimental Topic & Update communication model for reduced chattiness and structured progress reporting.
- Category:
Experimental - Requires restart:
no - Default:
false
Settings for extensions.
- Category:
Extensions - Requires restart:
yes - Default:
{}
{}2 nested properties
List of disabled extensions.
- Category:
Extensions - Requires restart:
yes - Default:
[]
[]List of workspaces for which the migration nudge has been shown.
- Category:
Extensions - Requires restart:
no - Default:
[]
[]Settings for agent skills.
- Category:
Advanced - Requires restart:
yes - Default:
{}
{}2 nested properties
Enable Agent Skills.
- Category:
Advanced - Requires restart:
yes - Default:
true
List of disabled skills.
- Category:
Advanced - Requires restart:
yes - Default:
[]
[]Hook configurations for intercepting and customizing agent behavior.
- Category:
Advanced - Requires restart:
no - Default:
{}
{}3 nested properties
Canonical toggle for the hooks system. When disabled, no hooks will be executed.
- Category:
Advanced - Requires restart:
yes - Default:
true
List of hook names (commands) that should be disabled. Hooks in this list will not execute even if configured.
- Category:
Advanced - Requires restart:
no - Default:
[]
[]Show visual indicators when hooks are executing.
- Category:
Advanced - Requires restart:
no - Default:
true
Event-specific hook configurations.
- Category:
Advanced - Requires restart:
no - Default:
{}
{}11 nested properties
Array of hook definition objects for a specific event.
Array of hook definition objects for a specific event.
Array of hook definition objects for a specific event.
Array of hook definition objects for a specific event.
Array of hook definition objects for a specific event.
Array of hook definition objects for a specific event.
Array of hook definition objects for a specific event.
Array of hook definition objects for a specific event.
Array of hook definition objects for a specific event.
Array of hook definition objects for a specific event.
Array of hook definition objects for a specific event.
Settings for agent history and tool distillation context management.
- Category:
Experimental - Requires restart:
yes - Default:
{}
{}3 nested properties
Description not provided.
- Category:
Context Management - Requires restart:
yes - Default:
{}
{}2 nested properties
The number of tokens to allow before triggering compression.
- Category:
Context Management - Requires restart:
yes - Default:
150000
The number of tokens to always retain.
- Category:
Context Management - Requires restart:
yes - Default:
40000
Description not provided.
- Category:
Context Management - Requires restart:
yes - Default:
{}
{}3 nested properties
The target number of tokens to budget for a normal conversation turn.
- Category:
Context Management - Requires restart:
yes - Default:
2500
The maximum number of tokens a single conversation turn can consume before truncation.
- Category:
Context Management - Requires restart:
yes - Default:
12000
The ratio of tokens to retain from the beginning of a truncated message (0.0 to 1.0).
- Category:
Context Management - Requires restart:
yes - Default:
0.25
Description not provided.
- Category:
Context Management - Requires restart:
yes - Default:
{}
{}2 nested properties
Description not provided.
- Category:
Context Management - Requires restart:
yes - Default:
{}
{}2 nested properties
Maximum tokens to show to the model when truncating large tool outputs.
- Category:
Context Management - Requires restart:
yes - Default:
10000
Threshold above which truncated tool outputs will be summarized by an LLM.
- Category:
Context Management - Requires restart:
yes - Default:
20000
Advanced settings for tool output masking to manage context window efficiency.
- Category:
Context Management - Requires restart:
yes - Default:
{}
{}3 nested properties
Minimum number of tokens to protect from masking (most recent tool outputs).
- Category:
Context Management - Requires restart:
yes - Default:
50000
Minimum prunable tokens required to trigger a masking pass.
- Category:
Context Management - Requires restart:
yes - Default:
30000
Ensures the absolute latest turn is never masked, regardless of token count.
- Category:
Context Management - Requires restart:
yes - Default:
true
Settings configured remotely by enterprise admins.
- Category:
Admin - Requires restart:
no - Default:
{}
{}4 nested properties
If true, disallows YOLO mode and "Always allow" options from being used.
- Category:
Admin - Requires restart:
no - Default:
false
Extensions-specific admin settings.
- Category:
Admin - Requires restart:
no - Default:
{}
{}1 nested properties
If false, disallows extensions from being installed or used.
- Category:
Admin - Requires restart:
no - Default:
true
MCP-specific admin settings.
- Category:
Admin - Requires restart:
no - Default:
{}
{}3 nested properties
If false, disallows MCP servers from being used.
- Category:
Admin - Requires restart:
no - Default:
true
Admin-configured MCP servers (allowlist).
- Category:
Admin - Requires restart:
no - Default:
{}
{}Admin-required MCP servers that are always injected.
- Category:
Admin - Requires restart:
no - Default:
{}
{}Agent Skills-specific admin settings.
- Category:
Admin - Requires restart:
no - Default:
{}
{}1 nested properties
If false, disallows agent skills from being used.
- Category:
Admin - Requires restart:
no - Default:
true
Definitions
Definition of a Model Context Protocol (MCP) server configuration.
Executable invoked for stdio transport.
Command-line arguments for the stdio transport command.
Environment variables to set for the server process.
Working directory for the server process.
URL for SSE or HTTP transport. Use with "type" field to specify transport type.
Streaming HTTP transport URL.
Additional HTTP headers sent to the server.
TCP address for websocket transport.
Transport type. Use "stdio" for local command, "sse" for Server-Sent Events, or "http" for Streamable HTTP.
Timeout in milliseconds for MCP requests.
Marks the server as trusted. Trusted servers may gain additional capabilities.
Human-readable description of the server.
Subset of tools that should be enabled for this server. When omitted all tools are enabled.
Tools that should be disabled for this server even if exposed.
Metadata describing the Gemini CLI extension that owns this MCP server.
OAuth configuration for authenticating with the server.
Authentication provider used for acquiring credentials (for example dynamic_discovery).
OAuth target audience (CLIENT_ID.apps.googleusercontent.com).
Service account email to impersonate ([email protected]).
Admin-required MCP server configuration (remote transports only).
URL for the required MCP server.
Transport type for the required server.
Additional HTTP headers sent to the server.
Timeout in milliseconds for MCP requests.
Marks the server as trusted. Defaults to true for admin-required servers.
Human-readable description of the server.
Subset of tools enabled for this server.
Tools disabled for this server.
OAuth configuration for authenticating with the server.
Authentication provider used for acquiring credentials.
OAuth target audience (CLIENT_ID.apps.googleusercontent.com).
Service account email to impersonate ([email protected]).
Telemetry configuration for Gemini CLI.
Enables telemetry emission.
Telemetry destination (for example stderr, stdout, or otlp).
Endpoint for OTLP exporters.
Protocol for OTLP exporters.
Whether prompts are logged in telemetry payloads.
File path for writing telemetry output.
Whether to forward telemetry to an OTLP collector.
Whether to use CLI authentication for telemetry (only for in-process exporters).
Configuration for the bug report helper command.
Template used to open a bug report URL. Variables in the template are populated at runtime.
Controls summarization behavior for individual tools. All properties are optional.
Maximum number of tokens used when summarizing tool output.
Override settings for a specific agent.
Run configuration for an agent.
2 nested properties
The maximum execution time for the agent in minutes.
The maximum number of conversational turns.
Whether to enable the agent.
Custom theme definition used for styling Gemini CLI output. Colors are provided as hex strings or named ANSI colors.
Theme display name.
4 nested properties
2 nested properties
2 nested properties
2 nested properties
3 nested properties
3 nested properties
Accepts either a single string or an array of strings.
Accepts either a boolean flag, a string command name, or a configuration object.
Array of hook definition objects for a specific event.
Model metadata registry entry.
2 nested properties
Model resolution rule.
A chain of model policies for fallback behavior.
Defines the policy for a single model in the availability chain.