summaryrefslogtreecommitdiff
path: root/docs/cli/authentication.md
diff options
context:
space:
mode:
authorOleksandr Gotgelf <[email protected]>2025-08-03 20:44:15 +0200
committerGitHub <[email protected]>2025-08-03 18:44:15 +0000
commit03ed37d0dc2b5e2077b53073517abaab3d24d9c2 (patch)
treee84a6cadef21cc6862b12215153b3e1177a1732d /docs/cli/authentication.md
parentbedcbb9feb3b4f5fcdd9d64782f3ee1e06376715 (diff)
fix: exclude DEBUG and DEBUG_MODE from project .env files by default (#5289)
Co-authored-by: Jacob Richman <[email protected]>
Diffstat (limited to 'docs/cli/authentication.md')
-rw-r--r--docs/cli/authentication.md2
1 files changed, 2 insertions, 0 deletions
diff --git a/docs/cli/authentication.md b/docs/cli/authentication.md
index 8e534d0b..d9adcfb1 100644
--- a/docs/cli/authentication.md
+++ b/docs/cli/authentication.md
@@ -91,6 +91,8 @@ The Gemini CLI requires you to authenticate with Google's AI services. On initia
You can create a **`.gemini/.env`** file in your project directory or in your home directory. Creating a plain **`.env`** file also works, but `.gemini/.env` is recommended to keep Gemini variables isolated from other tools.
+**Important:** Some environment variables (like `DEBUG` and `DEBUG_MODE`) are automatically excluded from project `.env` files to prevent interference with gemini-cli behavior. Use `.gemini/.env` files for gemini-cli specific variables.
+
Gemini CLI automatically loads environment variables from the **first** `.env` file it finds, using the following search order:
1. Starting in the **current directory** and moving upward toward `/`, for each directory it checks: