From 03ed37d0dc2b5e2077b53073517abaab3d24d9c2 Mon Sep 17 00:00:00 2001 From: Oleksandr Gotgelf Date: Sun, 3 Aug 2025 20:44:15 +0200 Subject: fix: exclude DEBUG and DEBUG_MODE from project .env files by default (#5289) Co-authored-by: Jacob Richman --- docs/cli/authentication.md | 2 ++ 1 file changed, 2 insertions(+) (limited to 'docs/cli/authentication.md') 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: -- cgit v1.2.3