diff --git a/packages/ai/CHANGELOG.md b/packages/ai/CHANGELOG.md
index 53033b85..02894a48 100644
--- a/packages/ai/CHANGELOG.md
+++ b/packages/ai/CHANGELOG.md
@@ -10,6 +10,7 @@
 
 - Fixed `os.homedir()` calls at module load time; now resolved lazily when needed.
 - Fixed OpenAI Responses tool strict flag to use a boolean for LM Studio compatibility ([#598](https://github.com/badlogic/pi-mono/pull/598) by [@gnattu](https://github.com/gnattu))
+- Fixed Google Cloud Code Assist OAuth for paid subscriptions: properly handles long-running operations for project provisioning, supports `GOOGLE_CLOUD_PROJECT` / `GOOGLE_CLOUD_PROJECT_ID` env vars for paid tiers, and handles VPC-SC affected users ([#582](https://github.com/badlogic/pi-mono/pull/582) by [@cmf](https://github.com/cmf))
 
 ## [0.42.1] - 2026-01-09
 
diff --git a/packages/ai/README.md b/packages/ai/README.md
index d121cbbb..abacb28c 100644
--- a/packages/ai/README.md
+++ b/packages/ai/README.md
@@ -892,9 +892,11 @@ Several providers require OAuth authentication instead of static API keys:
 - **Anthropic** (Claude Pro/Max subscription)
 - **OpenAI Codex** (ChatGPT Plus/Pro subscription, access to GPT-5.x Codex models)
 - **GitHub Copilot** (Copilot subscription)
-- **Google Gemini CLI** (Free Gemini 2.0/2.5 via Google Cloud Code Assist)
+- **Google Gemini CLI** (Gemini 2.0/2.5 via Google Cloud Code Assist; free tier or paid subscription)
 - **Antigravity** (Free Gemini 3, Claude, GPT-OSS via Google Cloud)
 
+For paid Cloud Code Assist subscriptions, set `GOOGLE_CLOUD_PROJECT` or `GOOGLE_CLOUD_PROJECT_ID` to your project ID.
+
 ### Vertex AI (ADC)
 
 Vertex AI models use Application Default Credentials (ADC):
diff --git a/packages/coding-agent/README.md b/packages/coding-agent/README.md
index d08f0a64..8dcbfc62 100644
--- a/packages/coding-agent/README.md
+++ b/packages/coding-agent/README.md
@@ -197,6 +197,7 @@ pi
 - Gemini CLI uses the production Cloud Code Assist endpoint (standard Gemini models)
 - Antigravity uses a sandbox endpoint with access to Gemini 3, Claude (sonnet/opus thinking), and GPT-OSS models
 - Both are free with any Google account, subject to rate limits
+- Paid Cloud Code Assist subscriptions: set `GOOGLE_CLOUD_PROJECT` or `GOOGLE_CLOUD_PROJECT_ID` env var to your project ID
 
 **OpenAI Codex notes:**
 - Requires ChatGPT Plus/Pro OAuth (`/login openai-codex`)