Antigravity-Shield 🛡️

The Hardened, Zero-Restart AI Account Manager & Multi-IDE Protocol Gateway (v5.10.1)

Your Dedicated High-Performance, Anti-Ban AI Gateway & Developer Hub

Engineered for seamless multi-account AI routing, zero-restart IDE account switching, local chat telemetry, and rock-solid account safety.

⚡ What's New • Why Shield? (Anti-403) • Showcase • Key Features • Quick Integration • Architecture • Installation • License

English | 简体中文

⚡ What's New in v5.10 (Killer Features)

🛡️ Why Antigravity-Shield? (The Anti-403 Solution)

While the original upstream project (lbjlaq/Antigravity-Manager) provided a basic proxy framework, over 1,800+ community issues accumulated due to critical architectural vulnerabilities when running high-concurrency AI coding agents (Claude Code CLI, Cursor, OpenCode, OpenClaw).

Antigravity-Shield is an independently maintained, deeply hardened distribution that systematically resolves these root causes across the proxy, account rotation, and network layers.

📊 Reliability & Architecture Comparison

📸 Interface Showcase

💓 System & AI Health Pulse Radar	🎛️ Multi-Account Quota Grid & Reset Windows
Real-time upstream probe, proxy status & pool summary	Side-by-side Gemini 3.1 Pro, 3.8 Flash & Claude 5H/weekly resets

📊 53-Week Token Activity Heatmap	🇮🇷 Native RTL & Vazirmatn Font Patch
Annual activity calendar & multi-IDE token burn telemetry	1-Click non-destructive Persian / Arabic typography patch for Antigravity & IDE

🌟 Key Features

1. 🔌 Antigravity Toolkit & Zero-Restart Account Hot-Switching

• No IDE Restarts Required: Connects to Antigravity IDE, VS Code, Cursor, Zed, and Xcode via local loopback bridge (127.0.0.1:8765). Switch accounts on-the-fly without killing editors, dropping active Claude Code agent loops, or losing unsaved editor buffers.
• 1-Click Extension Installation: Bundled antigravity-toolkit.vsix installs directly with one click from the UI.
• Bi-Directional Telemetry: Live heartbeat badge in the header shows active editor connection, active account email, and port fallback status.

2. 🧠 Conversation Telemetry, Brain Scanner & Crash Recovery

• Autonomous File Watcher: Rust-powered watcher monitors ~/.gemini/antigravity/brain/ every 3 seconds for newly written prompt/response transcripts.
• Crash-Resilient Session Recovery (Power-Outage Defense): When sudden power outages or abrupt OS shutdowns kill running IDE windows, Antigravity IDE's internal state database (state.vscdb) drops the uncommitted session from history because trajectory summaries are only flushed on graceful shutdown. Antigravity-Shield and the bundled Toolkit automatically detect unindexed brain transcripts, synthesize compliant Protobuf trajectory descriptors, and inject them back into the IDE's native conversation store so developers can pick up active agent tasks right where they left off with zero data loss.
• Full Context Extraction: Reconstructs token consumption, model IDs, conversation branches, and error rates.
• Multi-Source Attribution: Cleanly differentiates usage across Antigravity IDE, Antigravity CLI (agy), and the Local Gateway Proxy (port 8045).

3. 💓 Network Health Pulse & Geoblock Radar

• Live Latency Probes: Proactively measures Round-Trip Time (RTT) to official Google production endpoints (cloudcode-pa.googleapis.com), Gemini SDK APIs, and general Internet access.
• WARP & Geo-Restriction Guide: Detects regional blocks (HTTP 400 "User location not supported") and opens an interactive, illustrated unblocking guide.

4. 🎛️ Intelligent Multi-Account Quota Routing

• Rolling 5-Hour & Weekly Reset Windows: Side-by-side countdown steppers track exact recovery times for Gemini 3.1 Pro, Gemini 3 Flash, Claude 3.7 Sonnet, and Imagen 3.
• Smart Auto-Sort & Failover: Automatically routes traffic to accounts with the highest remaining quota score and shifts traffic away from rate-limited (HTTP 429) accounts.
• Smart Auto-Warmup: Proactively warms accounts as soon as their quota resets to 100%, eliminating cold-start latency.

5. 🔌 Universal Protocol Translation (API Gateway)

• OpenAI Compatible: Standard /v1/chat/completions endpoint for plug-and-play compatibility with Cursor, Cherry Studio, NextChat, OpenCode, and Windsurf.
• Anthropic Messages Protocol: Native /v1/messages endpoint with full reasoning/thinking chain support, custom system prompts, and full compatibility with Claude Code CLI.
• Google Gemini Protocol: Direct support for native Gemini SDK clients.

6. 🇮🇷 Native Persian / RTL & Vazirmatn Typography

• 1-Click IDE & Desktop Patch: Injects Persian RTL support and the modern Vazirmatn typeface with a single toggle.
• Non-Destructive: Automatically creates .bak backups and enforces clean left-to-right alignment for code blocks and monospace tokens.

7. 🎨 High-Definition Image Generation (Imagen 3)

• Support for arbitrary aspect ratios (1:1, 16:9, 9:16, 4:3, 21:9) and resolutions up to 4K via standard OpenAI image parameters or chat prompts.

🔌 Quick Integration

1. Claude Code CLI

Start the API proxy in Antigravity-Shield (default port: 8045), then run in your terminal:

export ANTHROPIC_API_KEY="sk-antigravity"
export ANTHROPIC_BASE_URL="http://127.0.0.1:8045"
claude

On Windows PowerShell:

$env:ANTHROPIC_API_KEY = "sk-antigravity"
$env:ANTHROPIC_BASE_URL = "http://127.0.0.1:8045"
claude

2. Cursor / Windsurf / Cherry Studio / NextChat (OpenAI Protocol)

• Base URL: http://127.0.0.1:8045/v1
• API Key: sk-antigravity (or your configured custom key in Settings)
• Models: gemini-3-pro-high, gemini-3-flash, claude-sonnet-4-6

3. Python SDK Example

import openai

client = openai.OpenAI(
    api_key="sk-antigravity",
    base_url="http://127.0.0.1:8045/v1"
)

response = client.chat.completions.create(
    model="gemini-3-flash",
    messages=[{"role": "user", "content": "Explain quantum computing in 3 sentences."}]
)
print(response.choices[0].message.content)

🏗️ Architecture

graph TD
    subgraph Clients["Supported Development Environments"]
        IDE["Antigravity IDE / VS Code / Cursor / Zed"]
        ClaudeCLI["Claude Code CLI / Terminal"]
        SDKClient["OpenAI / Gemini SDK / Cherry Studio"]
    end

    subgraph ToolkitBridge["Antigravity Toolkit (Port 8765)"]
        HotSwitch["Zero-Restart In-Memory Hot Switcher"]
        IDEHook["Editor Context & Session Preserver"]
    end

    subgraph ShieldGateway["Antigravity-Shield Gateway (Port 8045)"]
        Router["Axum Protocol Router: /v1/messages & /v1/chat/completions"]
        Security["Auth Token & Jitter Guard & IP Filter"]
        HealthPulse["Network Health Pulse & WARP Detector"]
        BrainWatcher["Brain Scanner: ~/.gemini/antigravity/brain/"]
        Dispatcher["Account Dispatcher: Smart Quota & 5H/Weekly Prioritizer"]
        WarmupEngine["Auto-Warmup Engine (100% Reset Probing)"]
    end

    subgraph UpstreamGoogle["Official Google Production Infrastructure"]
        ProdAPI["cloudcode-pa.googleapis.com (Zero Sandbox Detection)"]
    end

    IDE <-->|WebSocket / IPC| ToolkitBridge
    ToolkitBridge <-->|Loopback Bridge| ShieldGateway
    ClaudeCLI -->|Anthropic Protocol /v1/messages| Router
    SDKClient -->|OpenAI Protocol /v1/chat/completions| Router

    Router --> Security
    Security --> Dispatcher
    HealthPulse -.->|Proactive RTT Checks| ProdAPI
    WarmupEngine -.->|Keep-Alive| ProdAPI
    Dispatcher -->|Virtual DeviceProfile + RFC UUID| ProdAPI
    BrainWatcher -->|Extract Tokens & Deduplicate| DB[(SQLite: token_stats.db)]

📦 Installation

Pre-built Binaries (Recommended)

Download the latest verified binaries directly from GitHub Releases:

• Windows: Antigravity.Shield_5.10.1_x64-setup.exe (or standalone portable package)
• macOS: .dmg (Apple Silicon & Intel)
• Linux: .deb or .AppImage

[!TIP] Seamless In-App Updates: Once installed, future updates are delivered through the built-in streaming updater with real-time download progress and zero manual downloads.

Running via Docker (Headless Server)

docker run -d --name antigravity-shield \
  -p 8045:8045 \
  -e API_KEY=sk-your-api-key \
  -e WEB_PASSWORD=your-admin-password \
  -v ~/.antigravity_shield:/root/.antigravity_shield \
  doctorguidance/antigravity-shield:latest

⚖️ License & Attribution

• License: Distributed under the Creative Commons Attribution-NonCommercial-ShareAlike 4.0 International License (CC BY-NC-SA 4.0). Strictly for personal, non-commercial use.
• Upstream Attribution: Antigravity-Shield is an independently maintained, hardened distribution based on the open-source project lbjlaq/Antigravity-Manager created by lbjlaq and its contributors. All upstream copyrights, git history, and contributor credits are respectfully preserved.
• Privacy Guarantee: All OAuth tokens and credentials remain 100% locally encrypted on your machine in a local SQLite database. Zero telemetry or credentials ever leave your local computer.