diff --git a/README.md b/README.md
index 13f72e4..66a3988 100644
--- a/README.md
+++ b/README.md
@@ -139,11 +139,13 @@ The proxy needs an OAuth token:
 <details>
 <summary>How to get the token</summary>
 
-1. Open Antigravity
-2. Go to **Help** > **Toggle Developer Tools**
+1. Open Antigravity → **Help** > **Toggle Developer Tools**
+2. Go to the **Network** tab
 3. Send any prompt
-4. In the **Network** tab, find a request to `generativelanguage.googleapis.com`
-5. Copy the `Authorization: Bearer ya29.xxx...` header value
+4. Find a request to `generativelanguage.googleapis.com` or `SendUserCascadeMessage`
+5. Copy the `ya29.xxx...` token from the `Authorization` header or protobuf payload
+
+> **Note:** OAuth tokens expire after ~1 hour. If Antigravity is installed on the same machine, the proxy reads `state.vscdb` which contains a refresh token — auto-refresh works automatically even without Antigravity running. If you provide a bare `ya29.xxx` token via env/file/runtime, there's no refresh token, so you'll need to update it manually when it expires.
 
 </details>