b3nw/zerogravity
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

docs: Relocate the authentication section and refine token acquisition instructions in the README.

Browse Source
This commit is contained in:
Nikketryhard
2026-02-18 03:50:29 -06:00
parent 132f8fb3e6
commit efdb98e6f0
1 changed files with 28 additions and 21 deletions
Download Patch File Download Diff File Expand all files Collapse all files

49
README.md
View File

@@ -97,6 +97,34 @@ RUST_LOG=info ./target/release/zerogravity --headless
zg start zg start
``` ```
## Authentication
The proxy needs an OAuth token:
1. **Env var**: `ZEROGRAVITY_TOKEN=ya29.xxx`
2. **Token file**: `~/.config/zerogravity-token`
3. **Runtime**: `curl -X POST http://localhost:8741/v1/token -d '{"token":"ya29.xxx"}'`
<details>
<summary>How to get the token</summary>
1. Open Antigravity → **Help** > **Toggle Developer Tools**
2. Go to the **Network** tab
3. Send any prompt
4. Find a request to `generativelanguage.googleapis.com` or `SendUserCascadeMessage`
5. Right-click → **Copy as cURL**
6. Paste the cURL into any LLM with this prompt:
```
Extract the OAuth token (starts with ya29.) from this cURL command and give me just the token, nothing else:
<paste cURL here>
```
> **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>
## Setup ## Setup
### Linux ### Linux
@@ -167,27 +195,6 @@ schtasks /run /tn "ZeroGravity Proxy"
| `GET` | `/v1/quota` | LS quota and rate limits | | `GET` | `/v1/quota` | LS quota and rate limits |
| `GET` | `/health` | Health check | | `GET` | `/health` | Health check |
## Authentication
The proxy needs an OAuth token:
1. **Env var**: `ZEROGRAVITY_TOKEN=ya29.xxx`
2. **Token file**: `~/.config/zerogravity-token`
3. **Runtime**: `curl -X POST http://localhost:8741/v1/token -d '{"token":"ya29.xxx"}'`
<details>
<summary>How to get the token</summary>
1. Open Antigravity → **Help** > **Toggle Developer Tools**
2. Go to the **Network** tab
3. Send any prompt
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>
## `zg` Commands ## `zg` Commands
| Command | Description | | Command | Description |