opencode-antigravity-auth 1.2.7-beta.7 → 1.2.7

package/README.md

@@ -1,104 +1,94 @@
-# opencode-antigravity-auth
+# Antigravity + Gemini CLI OAuth Plugin for Opencode
 
 [![npm version](https://img.shields.io/npm/v/opencode-antigravity-auth.svg)](https://www.npmjs.com/package/opencode-antigravity-auth)
 [![npm beta](https://img.shields.io/npm/v/opencode-antigravity-auth/beta.svg?label=beta)](https://www.npmjs.com/package/opencode-antigravity-auth)
 [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](LICENSE)
 
-OpenCode plugin for Google Antigravity OAuth authentication.
+Enable Opencode to authenticate against **Antigravity** (Google's IDE) via OAuth so you can use Antigravity rate limits and access models like `gemini-3-pro-high` and `claude-opus-4-5-thinking` with your Google credentials.
 
-## Features
+## What you get
 
+- **Google OAuth sign-in** with automatic token refresh via `opencode auth login`
 - **Dual Quota System** - Access both Antigravity quota (Claude, Gemini 3) and Gemini CLI quota from a single plugin
 - **Multi-Account Rotation** - Add multiple Google accounts; automatically rotates when one is rate-limited
-- **Plugin Compatible** - Works alongside other OpenCode plugins (opencodesync, etc.)
+- **Real-time SSE streaming** including thinking blocks and incremental output
 - **Extended Thinking** - Native support for Claude thinking budgets and Gemini 3 thinking levels
 - **Auto Recovery** - Automatic session recovery from Claude tool_result_missing errors
+- **Plugin Compatible** - Works alongside other OpenCode plugins (opencodesync, etc.)
 
 ## Installation
 
-```bash
-npm install opencode-antigravity-auth
-```
+### For Humans
 
-Add to your OpenCode config (`~/.config/opencode/opencode.json`):
+**Option A: Let an LLM do it**
+
+Paste this into any LLM agent (Claude Code, OpenCode, Cursor, etc.):
 
-```json
-{
-  "plugin": ["opencode-antigravity-auth@beta"]
-}
+```
+Install the opencode-antigravity-auth plugin and add the Antigravity model definitions to ~/.config/opencode/opencode.json by following: https://raw.githubusercontent.com/anthropics/opencode-antigravity-auth/dev/README.md
 ```
 
-On first run, a browser window opens for Google OAuth. Tokens are stored securely and refresh automatically.
+**Option B: Manual setup**
 
-<details>
-<summary>Installation Guide for LLM Agents</summary>
+1. **Add the plugin to your config** (`~/.config/opencode/opencode.json`):
 
-### Step-by-Step Instructions
+   ```json
+   {
+     "plugin": ["opencode-antigravity-auth@1.2.7"]
+   }
+   ```
 
-1. Edit the OpenCode configuration file:
-   - Linux/Mac: `~/.config/opencode/opencode.json`
-   - Windows: `%APPDATA%\opencode\opencode.json`
+2. **Authenticate:**
 
-2. Add the plugin to the `plugins` array
+   ```bash
+   opencode auth login
+   ```
 
-3. Set `provider` to `"google"` and choose a model
+3. **Add models** (see [Available Models](#available-models) for full list):
 
-### Complete Configuration Example
+   ```json
+   {
+     "plugin": ["opencode-antigravity-auth@1.2.7"],
+     "provider": {
+       "google": {
+         "models": {
+           "antigravity-claude-sonnet-4-5": {
+             "name": "Claude Sonnet 4.5 (Antigravity)",
+             "limit": { "context": 200000, "output": 64000 },
+             "modalities": { "input": ["text", "image", "pdf"], "output": ["text"] }
+           }
+         }
+       }
+     }
+   }
+   ```
 
-Create `~/.config/opencode/antigravity.json`
-```jsonc
-{
-  // JSON Schema for IDE autocompletion
-  "$schema": "https://raw.githubusercontent.com/anthropics/opencode-antigravity-auth/main/assets/antigravity.schema.json",
+4. **Use it:**
 
-  // === General ===
-  "quiet_mode": false,           // Suppress toast notifications (except recovery)
-  "debug": false,                // Enable debug logging to file
-  "log_dir": "/custom/log/path", // Custom debug log directory (optional)
-  "auto_update": true,           // Auto-update plugin
+   ```bash
+   opencode run "Hello" --model=google/antigravity-claude-sonnet-4-5
+   ```
 
-  // === Thinking Blocks ===
-  "keep_thinking": false,        // Preserve thinking blocks (may cause signature errors)
-
-  // === Session Recovery ===
-  "session_recovery": true,      // Auto-recover from tool_result_missing errors
-  "auto_resume": true,           // Auto-send "continue" after recovery
-  "resume_text": "continue",     // Custom resume prompt text
+<details>
+<summary><b>Installation Guide for LLM Agents</b></summary>
 
-  // === Empty Response Handling ===
-  "empty_response_max_attempts": 4,      // Max retries for empty responses
-  "empty_response_retry_delay_ms": 2000, // Delay between retries (ms)
+### Step-by-Step Instructions
 
-  // === Tool Handling ===
-  "tool_id_recovery": true,       // Fix mismatched tool IDs from context compaction
-  "claude_tool_hardening": true,  // Prevent Claude tool hallucinations
+1. Edit the OpenCode configuration file:
+   - Linux/Mac: `~/.config/opencode/opencode.json`
+   - Windows: `%APPDATA%\opencode\opencode.json`
 
-  // === Token Refresh ===
-  "proactive_token_refresh": true,              // Background token refresh
-  "proactive_refresh_buffer_seconds": 1800,     // Refresh 30min before expiry
-  "proactive_refresh_check_interval_seconds": 300, // Check every 5min
+2. Add the plugin to the `plugins` array
 
-  // === Rate Limiting ===
-  "max_rate_limit_wait_seconds": 300, // Max wait time when rate limited (0=unlimited)
-  "quota_fallback": false,            // Try alternate quota when rate limited
+3. Set `provider` to `"google"` and choose a model
 
-  // === Signature Cache (for keep_thinking=true) ===
-  "signature_cache": {
-    "enabled": true,
-    "memory_ttl_seconds": 3600,      // 1 hour in-memory
-    "disk_ttl_seconds": 172800,      // 48 hours on disk
-    "write_interval_seconds": 60     // Background write interval
-  }
-}
-```
+### Complete Configuration Example
 
-Create `~/.config/opencode/opencode.json`
-```jsonc
+Create `~/.config/opencode/opencode.json`:
+```json
 {
   "$schema": "https://opencode.ai/config.json",
-  "plugin": [
-    "opencode-antigravity-auth@beta"
-  ],
+  "plugin": ["opencode-antigravity-auth@1.2.7"],
   "provider": {
     "google": {
       "models": {
@@ -117,6 +107,21 @@ Create `~/.config/opencode/opencode.json`
           "limit": { "context": 1048576, "output": 65536 },
           "modalities": { "input": ["text", "image", "pdf"], "output": ["text"] }
         },
+        "gemini-3-pro-low": {
+          "name": "Gemini 3 Pro Low (Antigravity)",
+          "limit": { "context": 1048576, "output": 65535 },
+          "modalities": { "input": ["text", "image", "pdf"], "output": ["text"] }
+        },
+        "gemini-3-pro-high": {
+          "name": "Gemini 3 Pro High (Antigravity)",
+          "limit": { "context": 1048576, "output": 65535 },
+          "modalities": { "input": ["text", "image", "pdf"], "output": ["text"] }
+        },
+        "gemini-3-flash": {
+          "name": "Gemini 3 Flash (Antigravity)",
+          "limit": { "context": 1048576, "output": 65536 },
+          "modalities": { "input": ["text", "image", "pdf"], "output": ["text"] }
+        },
         "antigravity-claude-sonnet-4-5": {
           "name": "Claude Sonnet 4.5 (Antigravity)",
           "limit": { "context": 200000, "output": 64000 },
@@ -158,9 +163,11 @@ Create `~/.config/opencode/opencode.json`
 }
 ```
 
-### Beta Versions
+### Verification
 
-For the latest development features, check the [dev branch README](https://github.com/anthropics/opencode-antigravity-auth/tree/dev) for beta installation instructions.
+```bash
+opencode run "Hello" --model=google/antigravity-claude-sonnet-4-5
+```
 
 </details>
 
@@ -183,27 +190,26 @@ Models with `antigravity-` prefix use Antigravity quota:
 | `google/antigravity-claude-opus-4-5-thinking-medium` | Opus with 16K thinking budget |
 | `google/antigravity-claude-opus-4-5-thinking-high` | Opus with 32K thinking budget |
 
+> **Backward compatibility:** Old model names (`gemini-3-pro-low`, `gemini-3-pro-high`, `gemini-3-flash`) still work as a fallback. However, you should update to the `antigravity-` prefix for stability. See [Migration Guide](#migration-guide-v127).
+
 ### Gemini CLI Quota
 
-Models without `antigravity-` prefix use Gemini CLI quota:
+Models with `-preview` suffix use Gemini CLI quota:
 
 | Model | Description |
 |-------|-------------|
 | `google/gemini-2.5-flash` | Gemini 2.5 Flash |
 | `google/gemini-2.5-pro` | Gemini 2.5 Pro |
-| `google/gemini-3-flash` | Gemini 3 Flash |
-| `google/gemini-3-pro-low` | Gemini 3 Pro with low thinking |
-| `google/gemini-3-pro-high` | Gemini 3 Pro with high thinking |
+| `google/gemini-3-flash-preview` | Gemini 3 Flash (preview) |
+| `google/gemini-3-pro-preview` | Gemini 3 Pro (preview) |
 
 <details>
-<summary>Full models configuration</summary>
+<summary><b>Full models configuration</b></summary>
 
-```jsonc
+```json
 {
   "$schema": "https://opencode.ai/config.json",
-  "plugin": [
-    "opencode-antigravity-auth@latest"
-  ],
+  "plugin": ["opencode-antigravity-auth@1.2.7"],
   "provider": {
     "google": {
       "models": {
@@ -222,6 +228,21 @@ Models without `antigravity-` prefix use Gemini CLI quota:
           "limit": { "context": 1048576, "output": 65536 },
           "modalities": { "input": ["text", "image", "pdf"], "output": ["text"] }
         },
+        "gemini-3-pro-low": {
+          "name": "Gemini 3 Pro Low (Antigravity)",
+          "limit": { "context": 1048576, "output": 65535 },
+          "modalities": { "input": ["text", "image", "pdf"], "output": ["text"] }
+        },
+        "gemini-3-pro-high": {
+          "name": "Gemini 3 Pro High (Antigravity)",
+          "limit": { "context": 1048576, "output": 65535 },
+          "modalities": { "input": ["text", "image", "pdf"], "output": ["text"] }
+        },
+        "gemini-3-flash": {
+          "name": "Gemini 3 Flash (Antigravity)",
+          "limit": { "context": 1048576, "output": 65536 },
+          "modalities": { "input": ["text", "image", "pdf"], "output": ["text"] }
+        },
         "antigravity-claude-sonnet-4-5": {
           "name": "Claude Sonnet 4.5 (Antigravity)",
           "limit": { "context": 200000, "output": 64000 },
@@ -256,194 +277,231 @@ Models without `antigravity-` prefix use Gemini CLI quota:
           "name": "Claude Opus 4.5 Think High (Antigravity)",
           "limit": { "context": 200000, "output": 64000 },
           "modalities": { "input": ["text", "image", "pdf"], "output": ["text"] }
+        },
+        "gemini-2.5-flash": {
+          "name": "Gemini 2.5 Flash (CLI)",
+          "limit": { "context": 1048576, "output": 65536 },
+          "modalities": { "input": ["text", "image", "pdf"], "output": ["text"] }
+        },
+        "gemini-2.5-pro": {
+          "name": "Gemini 2.5 Pro (CLI)",
+          "limit": { "context": 1048576, "output": 65536 },
+          "modalities": { "input": ["text", "image", "pdf"], "output": ["text"] }
+        },
+        "gemini-3-flash-preview": {
+          "name": "Gemini 3 Flash Preview (CLI)",
+          "limit": { "context": 1048576, "output": 65536 },
+          "modalities": { "input": ["text", "image", "pdf"], "output": ["text"] }
+        },
+        "gemini-3-pro-preview": {
+          "name": "Gemini 3 Pro Preview (CLI)",
+          "limit": { "context": 1048576, "output": 65535 },
+          "modalities": { "input": ["text", "image", "pdf"], "output": ["text"] }
         }
       }
     }
   }
 }
 ```
-</details>
 
-## Configuration
+</details>
 
+## Multi-Account Setup
 
-### Environment Overrides
+Add multiple Google accounts for higher combined quotas. The plugin automatically rotates between accounts when one is rate-limited.
 
 ```bash
-OPENCODE_ANTIGRAVITY_QUIET=1         # quiet_mode
-OPENCODE_ANTIGRAVITY_DEBUG=1         # debug
-OPENCODE_ANTIGRAVITY_LOG_DIR=/path   # log_dir
-OPENCODE_ANTIGRAVITY_KEEP_THINKING=1 # keep_thinking
+opencode auth login
 ```
 
 <details>
-<summary>Create `~/.config/opencode/antigravity.json` (or `.opencode/antigravity.json` in project root):</summary>
+<summary><b>How multi-account works</b></summary>
 
-```jsonc
-{
-  // JSON Schema for IDE autocompletion
-  "$schema": "https://raw.githubusercontent.com/anthropics/opencode-antigravity-auth/main/assets/antigravity.schema.json",
+### Load Balancing Behavior
 
-  // === General ===
-  "quiet_mode": false,           // Suppress toast notifications (except recovery)
-  "debug": false,                // Enable debug logging to file
-  "log_dir": "/custom/log/path", // Custom debug log directory (optional)
-  "auto_update": true,           // Auto-update plugin
+- **Sticky account selection** - Sticks to the same account until rate-limited (preserves Anthropic's prompt cache)
+- **Per-model-family limits** - Rate limits tracked separately for Claude and Gemini models
+- **Dual quota pools for Gemini** - Automatic fallback between Antigravity quota and Gemini CLI quota before switching accounts
+- **Smart retry threshold** - Short rate limits (≤5s) are retried on same account
+- **Exponential backoff** - Increasing delays for consecutive rate limits
 
-  // === Thinking Blocks ===
-  "keep_thinking": false,        // Preserve thinking blocks (may cause signature errors)
+### Dual Quota Pools (Gemini only)
 
-  // === Session Recovery ===
-  "session_recovery": true,      // Auto-recover from tool_result_missing errors
-  "auto_resume": true,           // Auto-send "continue" after recovery
-  "resume_text": "continue",     // Custom resume prompt text
+For Gemini models, the plugin accesses **two independent quota pools** per account:
 
-  // === Empty Response Handling ===
-  "empty_response_max_attempts": 4,      // Max retries for empty responses
-  "empty_response_retry_delay_ms": 2000, // Delay between retries (ms)
+| Quota Pool | When Used |
+|------------|-----------|
+| **Antigravity** | Primary (tried first) |
+| **Gemini CLI** | Fallback when Antigravity is rate-limited |
 
-  // === Tool Handling ===
-  "tool_id_recovery": true,       // Fix mismatched tool IDs from context compaction
-  "claude_tool_hardening": true,  // Prevent Claude tool hallucinations
+This effectively **doubles your Gemini quota** per account.
 
-  // === Token Refresh ===
-  "proactive_token_refresh": true,              // Background token refresh
-  "proactive_refresh_buffer_seconds": 1800,     // Refresh 30min before expiry
-  "proactive_refresh_check_interval_seconds": 300, // Check every 5min
+### Adding Accounts
 
-  // === Rate Limiting ===
-  "max_rate_limit_wait_seconds": 300, // Max wait time when rate limited (0=unlimited)
-  "quota_fallback": false,            // Try alternate quota when rate limited
+When running `opencode auth login` with existing accounts:
 
-  // === Signature Cache (for keep_thinking=true) ===
-  "signature_cache": {
-    "enabled": true,
-    "memory_ttl_seconds": 3600,      // 1 hour in-memory
-    "disk_ttl_seconds": 172800,      // 48 hours on disk
-    "write_interval_seconds": 60     // Background write interval
-  }
-}
 ```
+2 account(s) saved:
+  1. user1@gmail.com
+  2. user2@gmail.com
+
+(a)dd new account(s) or (f)resh start? [a/f]:
+```
+
+### Account Storage
+
+- Stored in `~/.config/opencode/antigravity-accounts.json`
+- Contains OAuth refresh tokens - **treat like a password**
+- If Google revokes a token (`invalid_grant`), that account is automatically removed
 
 </details>
 
-## Multi-Account Setup
+## Configuration
 
-Add multiple Google accounts for higher combined quotas. The plugin automatically rotates between accounts when one is rate-limited.
+Create `~/.config/opencode/antigravity.json` (or `.opencode/antigravity.json` in project root):
+
+### General Settings
+
+| Option | Default | Description |
+|--------|---------|-------------|
+| `quiet_mode` | `false` | Suppress toast notifications (except recovery) |
+| `debug` | `false` | Enable debug logging to file |
+| `log_dir` | OS default | Custom directory for debug logs |
+| `auto_update` | `true` | Enable automatic plugin updates |
+
+### Session Recovery
+
+| Option | Default | Description |
+|--------|---------|-------------|
+| `session_recovery` | `true` | Auto-recover from tool_result_missing errors |
+| `auto_resume` | `true` | Auto-send resume prompt after recovery |
+| `resume_text` | `"continue"` | Text to send when auto-resuming |
+
+### Error Recovery
+
+| Option | Default | Description |
+|--------|---------|-------------|
+| `empty_response_max_attempts` | `4` | Retries for empty API responses |
+| `empty_response_retry_delay_ms` | `2000` | Delay between retries |
+| `tool_id_recovery` | `true` | Fix mismatched tool IDs from context compaction |
+| `claude_tool_hardening` | `true` | Prevent tool parameter hallucination |
+
+### Token Management
+
+| Option | Default | Description |
+|--------|---------|-------------|
+| `proactive_token_refresh` | `true` | Refresh tokens before expiry |
+| `proactive_refresh_buffer_seconds` | `1800` | Refresh 30min before expiry |
+| `max_rate_limit_wait_seconds` | `300` | Max wait time when rate limited (0=unlimited) |
+| `quota_fallback` | `false` | Try alternate quota when rate limited |
+
+### Environment Overrides
 
 ```bash
-# Add accounts
-opencode auth login
+OPENCODE_ANTIGRAVITY_QUIET=1         # quiet_mode
+OPENCODE_ANTIGRAVITY_DEBUG=1         # debug
+OPENCODE_ANTIGRAVITY_LOG_DIR=/path   # log_dir
+OPENCODE_ANTIGRAVITY_KEEP_THINKING=1 # keep_thinking
 ```
 
-## Compatible Plugins
+<details>
+<summary><b>Full configuration example</b></summary>
 
-This plugin works alongside other OpenCode plugins. Some important notes:
+```json
+{
+  "$schema": "https://raw.githubusercontent.com/anthropics/opencode-antigravity-auth/main/assets/antigravity.schema.json",
+  "quiet_mode": false,
+  "debug": false,
+  "log_dir": "/custom/log/path",
+  "auto_update": true,
+  "keep_thinking": false,
+  "session_recovery": true,
+  "auto_resume": true,
+  "resume_text": "continue",
+  "empty_response_max_attempts": 4,
+  "empty_response_retry_delay_ms": 2000,
+  "tool_id_recovery": true,
+  "claude_tool_hardening": true,
+  "proactive_token_refresh": true,
+  "proactive_refresh_buffer_seconds": 1800,
+  "proactive_refresh_check_interval_seconds": 300,
+  "max_rate_limit_wait_seconds": 300,
+  "quota_fallback": false,
+  "signature_cache": {
+    "enabled": true,
+    "memory_ttl_seconds": 3600,
+    "disk_ttl_seconds": 172800,
+    "write_interval_seconds": 60
+  }
+}
+```
 
-### Plugin Ordering
+</details>
 
-If using `@tarquinen/opencode-dcp` (Dynamic Context Protocol), **our plugin must be listed first**:
+## Known Plugin Interactions
+
+### @tarquinen/opencode-dcp
+
+DCP creates synthetic assistant messages that lack thinking blocks. **Our plugin must be listed BEFORE DCP:**
 
 ```json
 {
   "plugin": [
     "opencode-antigravity-auth@beta",
-    "@tarquinen/opencode-dcp@1.1.2"
+    "@tarquinen/opencode-dcp@latest",
   ]
 }
 ```
 
+### oh-my-opencode
+
+When spawning parallel subagents, multiple processes may select the same account causing rate limit errors. **Workaround:** Add more accounts via `opencode auth login`.
+
 ### Plugins You Don't Need
 
 - **gemini-auth plugins** - Not needed. This plugin handles all Google OAuth authentication.
 
-### Rate Limit Considerations
+<details>
+<summary><b>Migration Guide (v1.2.7+)</b></summary>
 
-- **oh-my-opencode** - This plugin may make background API calls that consume your quota. If you're hitting rate limits unexpectedly, check if oh-my-opencode is making requests.
+If upgrading from v1.2.6 or earlier:
 
-## Migration Guide (v1.2.7+)
+### What Changed
 
-<details>
-<summary>If upgrading from v1.2.6 or earlier, follow these steps:</summary>
+v1.2.7+ uses explicit prefixes to distinguish quota sources:
 
-### Step 1: Clear Old Tokens (Optional)
+| Model Type | New Name (Recommended) | Old Name (Still Works) |
+|------------|------------------------|------------------------|
+| Gemini 3 (Antigravity) | `antigravity-gemini-3-pro-low` | `gemini-3-pro-low` |
+| Gemini 3 (Antigravity) | `antigravity-gemini-3-pro-high` | `gemini-3-pro-high` |
+| Gemini 3 (Antigravity) | `antigravity-gemini-3-flash` | `gemini-3-flash` |
+| Gemini 3 (CLI) | `gemini-3-pro-preview` | N/A |
+| Claude | `antigravity-claude-sonnet-4-5` | `claude-sonnet-4-5` |
 
-```bash
-rm -rf ~/.config/opencode/antigravity-account.json
+### Action Required
+
+**Update your config to use `antigravity-` prefix:**
+
+```diff
+- "gemini-3-pro-low": { ... }
++ "antigravity-gemini-3-pro-low": { ... }
 ```
 
-Then reauth
+> **Why update?** Old names work now as a fallback, but this depends on Gemini CLI using `-preview` suffix. If Google removes `-preview` in the future, old names may route to the wrong quota. The `antigravity-` prefix is explicit and stable.
+
+### Step 1: Clear Old Tokens (Optional - do this if you have issues calling models)
+
 ```bash
+rm -rf ~/.config/opencode/antigravity-account.json
 opencode auth login
 ```
 
 ### Step 2: Update opencode.json
 
-Replace your old provider google config with:
-
-```json
-"provider": {
-    "google": {
-      "models": {
-        "antigravity-gemini-3-pro-low": {
-          "name": "Gemini 3 Pro Low (Antigravity)",
-          "limit": { "context": 1048576, "output": 65535 },
-          "modalities": { "input": ["text", "image", "pdf"], "output": ["text"] }
-        },
-        "antigravity-gemini-3-pro-high": {
-          "name": "Gemini 3 Pro High (Antigravity)",
-          "limit": { "context": 1048576, "output": 65535 },
-          "modalities": { "input": ["text", "image", "pdf"], "output": ["text"] }
-        },
-        "antigravity-gemini-3-flash": {
-          "name": "Gemini 3 Flash (Antigravity)",
-          "limit": { "context": 1048576, "output": 65536 },
-          "modalities": { "input": ["text", "image", "pdf"], "output": ["text"] }
-        },
-        "antigravity-claude-sonnet-4-5": {
-          "name": "Claude Sonnet 4.5 (Antigravity)",
-          "limit": { "context": 200000, "output": 64000 },
-          "modalities": { "input": ["text", "image", "pdf"], "output": ["text"] }
-        },
-        "antigravity-claude-sonnet-4-5-thinking-low": {
-          "name": "Claude Sonnet 4.5 Think Low (Antigravity)",
-          "limit": { "context": 200000, "output": 64000 },
-          "modalities": { "input": ["text", "image", "pdf"], "output": ["text"] }
-        },
-        "antigravity-claude-sonnet-4-5-thinking-medium": {
-          "name": "Claude Sonnet 4.5 Think Medium (Antigravity)",
-          "limit": { "context": 200000, "output": 64000 },
-          "modalities": { "input": ["text", "image", "pdf"], "output": ["text"] }
-        },
-        "antigravity-claude-sonnet-4-5-thinking-high": {
-          "name": "Claude Sonnet 4.5 Think High (Antigravity)",
-          "limit": { "context": 200000, "output": 64000 },
-          "modalities": { "input": ["text", "image", "pdf"], "output": ["text"] }
-        },
-        "antigravity-claude-opus-4-5-thinking-low": {
-          "name": "Claude Opus 4.5 Think Low (Antigravity)",
-          "limit": { "context": 200000, "output": 64000 },
-          "modalities": { "input": ["text", "image", "pdf"], "output": ["text"] }
-        },
-        "antigravity-claude-opus-4-5-thinking-medium": {
-          "name": "Claude Opus 4.5 Think Medium (Antigravity)",
-          "limit": { "context": 200000, "output": 64000 },
-          "modalities": { "input": ["text", "image", "pdf"], "output": ["text"] }
-        },
-        "antigravity-claude-opus-4-5-thinking-high": {
-          "name": "Claude Opus 4.5 Think High (Antigravity)",
-          "limit": { "context": 200000, "output": 64000 },
-          "modalities": { "input": ["text", "image", "pdf"], "output": ["text"] }
-        }
-      }
-    }
-}
-```
+Models now use `antigravity-` prefix for Antigravity quota. See [Available Models](#available-models).
 
 ### Step 3: Create antigravity.json (Optional)
 
-If you had custom settings, migrate them to `~/.config/opencode/antigravity.json`:
-
 ```json
 {
   "$schema": "https://raw.githubusercontent.com/anthropics/opencode-antigravity-auth/main/assets/antigravity.schema.json",
@@ -452,25 +510,10 @@ If you had custom settings, migrate them to `~/.config/opencode/antigravity.json
 }
 ```
 
-### Step 4: Re-authenticate
-
-Run OpenCode once. A browser window will open for Google OAuth:
-
-```bash
-opencode
-```
-
-### Breaking Changes
-
-| Old (v1.2.6) | New (v1.2.7+) |
-|--------------|---------------|
-| `OPENCODE_ANTIGRAVITY_*` env vars | `~/.config/opencode/antigravity.json` |
-| `gemini-3-pro` | `google/antigravity-gemini-3-pro-low` |
-| `claude-sonnet-4-5` | `google/antigravity-claude-sonnet-4-5` |
-
 </details>
 
-## E2E Testing
+<details>
+<summary><b>E2E Testing</b></summary>
 
 The plugin includes regression tests for stability verification. Tests consume API quota.
 
@@ -478,10 +521,10 @@ The plugin includes regression tests for stability verification. Tests consume A
 # Sanity tests (7 tests, ~5 min)
 npx tsx script/test-regression.ts --sanity
 
-# Heavy tests (4 tests, ~30 min) - stress testing with 8-50 turn conversations
+# Heavy tests (4 tests, ~30 min)
 npx tsx script/test-regression.ts --heavy
 
-# Concurrent tests (3 tests) - rate limit handling with 5-10 parallel requests
+# Concurrent tests (3 tests)
 npx tsx script/test-regression.ts --category concurrency
 
 # Run specific test
@@ -491,25 +534,61 @@ npx tsx script/test-regression.ts --test thinking-tool-use
 npx tsx script/test-regression.ts --dry-run
 ```
 
-## Debugging
+</details>
 
-Enable debug logging:
+## Debugging
 
 ```bash
-# Via environment
-OPENCODE_ANTIGRAVITY_DEBUG=1 opencode
-
-# Via config
-echo '{"debug": true}' > ~/.config/opencode/antigravity.json
+OPENCODE_ANTIGRAVITY_DEBUG=1 opencode   # Basic logging
+OPENCODE_ANTIGRAVITY_DEBUG=2 opencode   # Verbose (full request/response bodies)
 ```
 
-Logs are written to `~/.config/opencode/antigravity-logs/` (or `log_dir` if configured).
+Logs are written to `~/.config/opencode/antigravity-logs/`.
 
 ## Documentation
 
 - [Architecture](docs/ARCHITECTURE.md) - Plugin internals and request flow
 - [API Spec](docs/ANTIGRAVITY_API_SPEC.md) - Antigravity API reference
 
+<details>
+<summary><b>Safety, Usage & Legal</b></summary>
+
+### Intended Use
+
+- Personal / internal development only
+- Respect internal quotas and data handling policies
+- Not for production services or bypassing intended limits
+
+### Warning (Assumption of Risk)
+
+By using this plugin, you acknowledge:
+
+- **Terms of Service risk** - This approach may violate ToS of AI model providers
+- **Account risk** - Providers may suspend or ban accounts
+- **No guarantees** - APIs may change without notice
+- **Assumption of risk** - You assume all legal, financial, and technical risks
+
+### Legal
+
+- Not affiliated with Google. This is an independent open-source project.
+- "Antigravity", "Gemini", "Google Cloud", and "Google" are trademarks of Google LLC.
+- Software is provided "as is", without warranty.
+
+</details>
+
+## Credits
+
+Built with help from:
+
+- [opencode-gemini-auth](https://github.com/jenslys/opencode-gemini-auth) - Gemini OAuth groundwork by [@jenslys](https://github.com/jenslys)
+- [CLIProxyAPI](https://github.com/router-for-me/CLIProxyAPI) - Antigravity API reference
+
+## Support
+
+If this plugin helps you, consider supporting its continued maintenance:
+
+[![ko-fi](https://ko-fi.com/img/githubbutton_sm.svg)](https://ko-fi.com/S6S81QBOIR)
+
 ## License
 
 MIT