antigravity-claude-proxy 2.4.3 → 2.5.0

package/README.md

@@ -132,7 +132,10 @@ You can configure these settings in two ways:
 
 1. Open the WebUI at `http://localhost:8080`.
 2. Go to **Settings** → **Claude CLI**.
-3. Select your preferred models and click **Apply to Claude CLI**.
+3. Use the **Connection Mode** toggle to switch between:
+   - **Proxy Mode**: Uses the local proxy server (Antigravity Cloud Code). Configure models, base URL, and presets here.
+   - **Paid Mode**: Uses the official Anthropic Credits directly (requires your own subscription). This hides proxy settings to prevent accidental misconfiguration.
+4. Click **Apply to Claude CLI** to save your changes.
 
 > [!TIP] > **Configuration Precedence**: System environment variables (set in shell profile like `.zshrc`) take precedence over the `settings.json` file. If you use the Web Console to manage settings, ensure you haven't manually exported conflicting variables in your terminal.
 
@@ -221,6 +224,18 @@ claude
 
 > **Note:** If Claude Code asks you to select a login method, add `"hasCompletedOnboarding": true` to `~/.claude.json` (macOS/Linux) or `%USERPROFILE%\.claude.json` (Windows), then restart your terminal and try again.
 
+### Proxy Mode vs. Paid Mode
+
+Toggle in **Settings** → **Claude CLI**:
+
+| Feature | 🔌 Proxy Mode | 💳 Paid Mode |
+| :--- | :--- | :--- |
+| **Backend** | Local Server (Antigravity) | Official Anthropic Credits |
+| **Cost** | Free (Google Cloud) | Paid (Anthropic Credits) |
+| **Models** | Claude + Gemini | Claude Only |
+
+**Paid Mode** automatically clears proxy settings so you can use your official Anthropic account directly.
+
 ### Multiple Claude Code Instances (Optional)
 
 To run both the official Claude Code and Antigravity version simultaneously, add this alias:
@@ -298,7 +313,8 @@ antigravity-claude-proxy start --strategy=round-robin  # Load-balanced
 
 - **Health Score Tracking**: Accounts earn points for successful requests and lose points for failures/rate-limits
 - **Token Bucket Rate Limiting**: Client-side throttling with regenerating tokens (50 max, 6/minute)
-- **Quota Awareness**: Accounts with critical quota (<5%) are deprioritized; exhausted accounts trigger emergency fallback
+- **Quota Awareness**: Accounts below configurable quota thresholds are deprioritized; exhausted accounts trigger emergency fallback
+- **Quota Protection**: Set minimum quota levels globally, per-account, or per-model to switch accounts before quota runs out
 - **Emergency Fallback**: When all accounts appear exhausted, bypasses checks with throttle delays (250-500ms)
 - **Automatic Cooldown**: Rate-limited accounts recover automatically after reset time expires
 - **Invalid Account Detection**: Accounts needing re-authentication are marked and skipped
@@ -340,16 +356,17 @@ The proxy includes a built-in, modern web interface for real-time monitoring and
 ### Key Features
 
 - **Real-time Dashboard**: Monitor request volume, active accounts, model health, and subscription tier distribution.
-- **Visual Model Quota**: Track per-model usage and next reset times with color-coded progress indicators.
-- **Account Management**: Add/remove Google accounts via OAuth, view subscription tiers (Free/Pro/Ultra) and quota status at a glance.
+- **Visual Model Quota**: Track per-model usage and next reset times with color-coded progress indicators and draggable per-account threshold markers.
+- **Account Management**: Add/remove Google accounts via OAuth, view subscription tiers (Free/Pro/Ultra), quota status, and per-account threshold settings.
 - **Manual OAuth Mode**: Add accounts on headless servers by copying the OAuth URL and pasting the authorization code.
 - **Claude CLI Configuration**: Edit your `~/.claude/settings.json` directly from the browser.
 - **Persistent History**: Tracks request volume by model family for 30 days, persisting across server restarts.
 - **Time Range Filtering**: Analyze usage trends over 1H, 6H, 24H, 7D, or All Time periods.
 - **Smart Analysis**: Auto-select top 5 most used models or toggle between Family/Model views.
 - **Live Logs**: Stream server logs with level-based filtering and search.
+- **Quota Protection**: Set global or per-account minimum quota thresholds to proactively switch accounts before quota runs out.
 - **Advanced Tuning**: Configure retries, timeouts, and debug mode on the fly.
-- **Multi-language Interface**: Full support for English, Chinese (中文), Indonesian (Bahasa), and Portuguese (PT-BR).
+- **Multi-language Interface**: Full support for English, Chinese (中文), Indonesian (Bahasa), Portuguese (PT-BR), and Turkish (Türkçe).
 
 ---
 
@@ -367,6 +384,7 @@ While most users can use the default settings, you can tune the proxy behavior v
 - **Load Balancing**: Adjust `defaultCooldownMs` and `maxWaitBeforeErrorMs`.
 - **Persistence**: Enable `persistTokenCache` to save OAuth sessions across restarts.
 - **Max Accounts**: Set `maxAccounts` (1-100) to limit the number of Google accounts. Default: 10.
+- **Quota Threshold**: Set `globalQuotaThreshold` (0-0.99) to switch accounts before quota drops below a minimum level. Supports per-account and per-model overrides.
 - **Endpoint Fallback**: Automatic 403/404 endpoint fallback for API compatibility.
 
 Refer to `config.example.json` for a complete list of fields and documentation.
@@ -387,6 +405,7 @@ For macOS users who prefer a native experience, there's a companion menu bar app
 - **Status Indicator**: Menu bar icon shows server running state at a glance.
 - **WebUI Access**: Open the web management console directly from the menu.
 - **Port Configuration**: Customize the proxy server port (default: 8080).
+- **Account Selection Strategy**: Choose between Hybrid, Sticky, or Round-Robin load balancing strategies.
 - **Auto-Start Options**: Launch server on app start and launch app at login.
 - **Native Experience**: Clean, native SwiftUI interface designed for macOS.
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "antigravity-claude-proxy",
-  "version": "2.4.3",
+  "version": "2.5.0",
   "description": "Proxy server to use Antigravity's Claude models with Claude Code CLI",
   "main": "src/index.js",
   "type": "module",