summaryrefslogtreecommitdiff
path: root/docs/cli/configuration.md
diff options
context:
space:
mode:
Diffstat (limited to 'docs/cli/configuration.md')
-rw-r--r--docs/cli/configuration.md16
1 files changed, 16 insertions, 0 deletions
diff --git a/docs/cli/configuration.md b/docs/cli/configuration.md
index da5a6bfd..4367e73e 100644
--- a/docs/cli/configuration.md
+++ b/docs/cli/configuration.md
@@ -42,6 +42,22 @@ When you create a `.gemini/settings.json` file for project-specific settings, or
- **Default:** `GEMINI.md`
- **Example:** `"contextFileName": "AGENTS.md"`
+- **`fileFiltering`** (object, optional):
+
+ - **Description:** Controls git-aware file filtering behavior for @ commands and file discovery tools.
+ - **Properties:**
+ - **`respectGitIgnore`** (boolean, default: `true`): Whether to respect .gitignore patterns when discovering files. When enabled, git-ignored files (like `node_modules/`, `dist/`, `.env`) are automatically excluded from @ commands and file listing operations.
+ - **`customIgnorePatterns`** (array of strings, default: `[]`): Additional patterns to ignore beyond git-ignored files. Useful for excluding specific directories or file types.
+ - **`allowBuildArtifacts`** (boolean, default: `false`): Whether to include build artifacts and generated files in file discovery operations.
+ - **Example:**
+ ```json
+ "fileFiltering": {
+ "respectGitIgnore": true,
+ "customIgnorePatterns": ["temp/", "*.log"],
+ "allowBuildArtifacts": false
+ }
+ ```
+
- **`coreTools`** (array of strings, optional):
- **Description:** Allows you to specify a list of core tool names that should be made available to the model. This can be used to restrict or customize the set of built-in tools.
- **Example:** `"coreTools": ["ReadFileTool", "GlobTool", "SearchText"]`.