summaryrefslogtreecommitdiff
path: root/docs/cli/configuration.md
AgeCommit message (Collapse)Author
2025-07-11Add support for specifying maxSessionTurns via the settings configuration ↵anj-s
(#3507)
2025-07-10Fix invalid docker command and invalid JSON in the mcpServers example. (#3672)neo.alienson
2025-07-09Add system-wide settings config for administrators (#3498)christine betts
Co-authored-by: Jack Wotherspoon <[email protected]>
2025-07-08refactor: consolidate all flags to use hyphens (deprecate underscore flags) ↵Jack Wotherspoon
(#3541)
2025-07-08Add a command line option to enable and list extensions (#3191)Billy Biggs
2025-07-08Improve auth env var validation logic and messaging to detect settings that ↵Marat Boshernitsan
confuse GenAI SDK (#1381) Co-authored-by: Scott Densmore <[email protected]> Co-authored-by: gemini-code-assist[bot] <176961590+gemini-code-assist[bot]@users.noreply.github.com>
2025-07-07Enable Gemini CLI to reuse user's auth in Cloud Shell (#3070)Marat Boshernitsan
2025-07-05fix typos in diverse files (#3284)Didier Durand
Co-authored-by: Scott Densmore <[email protected]>
2025-07-05feat: Update minimum Node.js version to 20 (#3277)matt korwel
2025-06-29feat(cli): Add hideTips setting (#1524)Marcin Jahn
Co-authored-by: Allen Hutchison <[email protected]>
2025-06-29feat: allow command-specific restrictions for ShellTool (#2605)Jerop Kipruto
2025-06-27Upgrade to Ink 6 and React 19 (#2096)Sandy Tao
Co-authored-by: jacob314 <[email protected]>
2025-06-25Streamline issue submission with YAML forms (#1608)Jerop Kipruto
2025-06-25Add tos and privacy links docs for clarity (#1571)anj-s
2025-06-25Remove GEMINI_CODE_ASSIST env variable from configuration.md doc (#1514)starsandskies
2025-06-25docs: fix typos in documentation (#1411)Daniel Tedesco
Co-authored-by: Dan Tedesco <[email protected]>
2025-06-24 Add the link to the privacy policy to the Usage Statistics section and ↵anj-s
remove debug logs (#1393)
2025-06-24Checkpointing documentation (#1321)Louis Jimenez
Co-authored-by: matt korwel <[email protected]>
2025-06-23Fix broken doc links (#1368)starsandskies
2025-06-24Refactor usage statistics to be a top-level setting (#1363)Jerop Kipruto
This commit refactors the `usageStatisticsEnabled` setting from a sub-property of the `telemetry` configuration to a top-level setting. This change simplifies the configuration by decoupling usage statistics from the telemetry settings. The documentation has also been updated to reflect this change.
2025-06-23docs: update configuration.md with new CLI options (#1360)cperry-goog
2025-06-23[June 25] Updated docs for telemetry and user statistics (#1346)Bryan Morgan
2025-06-23Docs: Add `telemetry` to the list of configuration options (#1348)starsandskies
2025-06-23docs(telemetry): relocate telemetry documentation (#1327)Jerop Kipruto
Moves the telemetry.md file from docs/core to the top-level docs/ directory to make it more discoverable. Updates the link in the main index.md and removes the old reference from the CLI configuration page.
2025-06-22Docs update (#1295)cperry-goog
2025-06-22Add setting enableRecursiveFileSearch to control @-file completion (#1290)Billy Biggs
2025-06-21Updating missing commands (#1289)cperry-goog
2025-06-20Edit pass for the first chunk of docs/cli/configuration.md (#1174)starsandskies
Co-authored-by: cperry-goog <[email protected]>
2025-06-18GC guided review of docs (#1167)Seth Troisi
2025-06-17Move theme discussion from configuration.md to themes.md (#1158)starsandskies
This content looks like it is better hosted in the themes.md doc. This is as close as possible to an as-is cut-paste from one file to the other, with the goal of minimizing fine-grained review in this particular PR. I'll take another pass through themes.md specifically to improve the moved content in a follow up PR
2025-06-16Decouple telemetry project ID configuration (#1077)Jerop Kipruto
#750 Renames project ID for telemetry from `GOOGLE_CLOUD_PROJECT` to `OTLP_GOOGLE_CLOUD_PROJECT`. This change allows for a separate Google Cloud Project to be used for telemetry data, distinct from the project used for other services like Vertex AI or Code Assist. This enhances clarity and flexibility in project configuration.
2025-06-14docs: document environment variables for cloud services (#1048)Scott Densmore
2025-06-14feat: Add custom URL support for the /bug command (#1017)Allen Hutchison
2025-06-13Update contextFileName to support an optional list of strings (#1001)Billy Biggs
2025-06-13cleanup unused `allowBuildArtifacts` (#1010)Anas H. Sulaiman
2025-06-13cleanup unused `customIgnorePatterns` (#1009)Anas H. Sulaiman
2025-06-12Code Assist cleanup and docs (#993)Tommaso Sciortino
2025-06-11add excludeTools flag to settings.json config (#957)JingboWang1997-1
2025-06-10restricted networking for all sandboxing methods, new seatbelt profiles, ↵Olcan
updated docs, fixes to sandbox build, debugging through sandbox (#891)
2025-06-09rename shell tool more intuitively as run_shell_command (from historical ↵Olcan
name of execute_bash_command inherited from terminal tool) (#869)
2025-06-08Revert "Add batch editing capabilities to Edit Tool (#648)" (#857)N. Taylor Mullen
2025-06-07docs: update and reorganize documentation (#806)cperry-goog
2025-06-06Add batch editing capabilities to Edit Tool (#648)Keith Ballinger
Co-authored-by: N. Taylor Mullen <[email protected]>
2025-06-06feat: Enable environment variable substitution in settingsjerop
This commit introduces the ability to use system environment variables within the settings files (e.g., `settings.json`). Users can now reference environment variables using the `${VAR_NAME}` syntax. This enhancement improves security and flexibility, particularly for configurations like MCP server settings, which often require sensitive tokens. Previously, to configure an MCP server, a token might be directly embedded: ```json "mcpServers": { "github": { "env": { "GITHUB_PERSONAL_ACCESS_TOKEN": "pat_abc123" } // ... } } ``` With this change, the same configuration can securely reference an environment variable: ```json "mcpServers": { "github": { "env": { "GITHUB_PERSONAL_ACCESS_TOKEN": "${GITHUB_PERSONAL_ACCESS_TOKEN}" } // ... } } ``` This allows users to avoid storing secrets directly in configuration files.
2025-06-05fix: Disable automatic image building if BUILD_SANDBOX is not provided (#764)Tolik Malibroda
2025-06-05feat: Add multi-stage docker build support for custom sandbox.Dockerfile (#746)Tolik Malibroda
2025-06-04Ignore folders files (#651)Keith Ballinger
# Add .gitignore-Aware File Filtering to gemini-cli This pull request introduces .gitignore-based file filtering to the gemini-cli, ensuring that git-ignored files are automatically excluded from file-related operations and suggestions throughout the CLI. The update enhances usability, reduces noise from build artifacts and dependencies, and provides new configuration options for fine-tuning file discovery. Key Improvements .gitignore File Filtering All @ (at) commands, file completions, and core discovery tools now honor .gitignore patterns by default. Git-ignored files (such as node_modules/, dist/, .env, and .git) are excluded from results unless explicitly overridden. The behavior can be customized via a new fileFiltering section in settings.json, including options for: Turning .gitignore respect on/off. Adding custom ignore patterns. Allowing or excluding build artifacts. Configuration & Documentation Updates settings.json schema extended with fileFiltering options. Documentation updated to explain new filtering controls and usage patterns. Testing New and updated integration/unit tests for file filtering logic, configuration merging, and edge cases. Test coverage ensures .gitignore filtering works as intended across different workflows. Internal Refactoring Core file discovery logic refactored for maintainability and extensibility. Underlying tools (ls, glob, read-many-files) now support git-aware filtering out of the box. Co-authored-by: N. Taylor Mullen <[email protected]>
2025-06-03Update configuration.md (#722)Cindy Xing
2025-06-03document mcp server trust option (#719)Olcan
2025-06-02allow toolDiscoveryCommand to return function declarations with or without a ↵Olcan
tool wrapper; fully document both toolDiscoveryCommand and toolCallCommand with examples and pointers to API docs (#696)