summaryrefslogtreecommitdiff
path: root/docs/cli
diff options
context:
space:
mode:
authorMarat Boshernitsan <[email protected]>2025-07-07 15:02:13 -0700
committerGitHub <[email protected]>2025-07-07 22:02:13 +0000
commit48c2aa296a7ed8b17e861d54682b0ea71695ca66 (patch)
treeaf686139688bfca8e2fd9c7fedb944d012d52ff6 /docs/cli
parent357546a2aac918702f6ebfa4a97bd95ccd614e5d (diff)
Enable Gemini CLI to reuse user's auth in Cloud Shell (#3070)
Diffstat (limited to 'docs/cli')
-rw-r--r--docs/cli/authentication.md4
-rw-r--r--docs/cli/configuration.md1
2 files changed, 5 insertions, 0 deletions
diff --git a/docs/cli/authentication.md b/docs/cli/authentication.md
index a3d3c0f3..3dddb897 100644
--- a/docs/cli/authentication.md
+++ b/docs/cli/authentication.md
@@ -74,6 +74,10 @@ The Gemini CLI requires you to authenticate with Google's AI services. On initia
echo 'export GOOGLE_GENAI_USE_VERTEXAI=true' >> ~/.bashrc
source ~/.bashrc
```
+4. **Cloud Shell:**
+ - This option is only available when running in a Google Cloud Shell environment.
+ - It automatically uses the credentials of the logged-in user in the Cloud Shell environment.
+ - This is the default authentication method when running in Cloud Shell and no other method is configured.
### Persisting Environment Variables with `.env` Files
diff --git a/docs/cli/configuration.md b/docs/cli/configuration.md
index 6e724ab1..31931391 100644
--- a/docs/cli/configuration.md
+++ b/docs/cli/configuration.md
@@ -248,6 +248,7 @@ The CLI automatically loads environment variables from an `.env` file. The loadi
- Your Google Cloud Project ID.
- Required for using Code Assist or Vertex AI.
- If using Vertex AI, ensure you have the necessary permissions and set the `GOOGLE_GENAI_USE_VERTEXAI=true` environment variable.
+ - **Cloud Shell Note:** When running in a Cloud Shell environment, this variable defaults to a special project allocated for Cloud Shell users. If you have `GOOGLE_CLOUD_PROJECT` set in your global environment in Cloud Shell, it will be overridden by this default. To use a different project in Cloud Shell, you must define `GOOGLE_CLOUD_PROJECT` in a `.env` file.
- Example: `export GOOGLE_CLOUD_PROJECT="YOUR_PROJECT_ID"`.
- **`GOOGLE_APPLICATION_CREDENTIALS`** (string):
- **Description:** The path to your Google Application Credentials JSON file.