antigravity-manager

SKILL.md

Antigravity Manager

Skill by ara.so — Daily 2026 Skills collection.

Antigravity Manager is a professional AI account manager and proxy gateway. It takes Google (Gemini) and Anthropic (Claude) web session tokens and exposes them as standard API endpoints (OpenAI-compatible, Anthropic-native, and Gemini-native formats) with intelligent multi-account rotation, quota tracking, and automatic failover.

Key capabilities:

Multi-account management with real-time quota dashboards

Protocol conversion: web sessions → OpenAI / Anthropic / Gemini API

Auto-rotation on 429/401 errors (millisecond failover)

Model routing and remapping

Desktop app (Tauri v2 + React + Rust) or headless Docker/server mode

Installation

Option A: One-line script (Linux/macOS)
curl -fsSL https://raw.githubusercontent.com/lbjlaq/Antigravity-Manager/v4.1.30/install.sh | bash

Install a specific version:

curl -fsSL https://raw.githubusercontent.com/lbjlaq/Antigravity-Manager/v4.1.30/install.sh | bash -s -- --version 4.1.30

Dry run (preview without installing):

curl -fsSL https://raw.githubusercontent.com/lbjlaq/Antigravity-Manager/v4.1.30/install.sh | bash -s -- --dry-run

Option B: Windows (PowerShell)

irm https://raw.githubusercontent.com/lbjlaq/Antigravity-Manager/main/install.ps1 | iex

Option C: Homebrew (macOS / Linuxbrew)

brew tap lbjlaq/antigravity-manager https://github.com/lbjlaq/Antigravity-Manager
brew install --cask antigravity-tools

Option D: Docker (recommended for servers/NAS)

docker run -d --name antigravity-manager \
  -p 8045:8045 \
  -e API_KEY=$ANTIGRAVITY_API_KEY \
  -e WEB_PASSWORD=$ANTIGRAVITY_WEB_PASSWORD \
  -e ABV_MAX_BODY_SIZE=104857600 \
  -v ~/.antigravity_tools:/root/.antigravity_tools \
  lbjlaq/antigravity-manager:latest

Docker Compose:

# docker-compose.yml
version: "3.8"
services:
  antigravity:
    image: lbjlaq/antigravity-manager:latest
    container_name: antigravity-manager
    restart: unless-stopped
    ports:
      - "8045:8045"
    environment:
      - API_KEY=${ANTIGRAVITY_API_KEY}
      - WEB_PASSWORD=${ANTIGRAVITY_WEB_PASSWORD}
      - ABV_MAX_BODY_SIZE=104857600
    volumes:
      - ~/.antigravity_tools:/root/.antigravity_tools

docker compose up -d
docker logs antigravity-manager          # view logs / recover forgotten keys

Option E: Manual download

Download from GitHub Releases:

macOS: .dmg (Apple Silicon + Intel)

Windows: .msi or portable .zip

Linux: .deb, .rpm, or .AppImage

Authentication / Security Model

Antigravity uses two separate credentials:

Credential
Env var
Config key
Purpose

API Key
API_KEY
api_key
Authenticates AI API calls (Authorization: Bearer ...)

Web Password
WEB_PASSWORD
admin_password
Logs into the management web UI

Scenario A — only API_KEY set:

Web UI login: use API_KEY

API calls: use API_KEY

Scenario B — both set (recommended):

Web UI login: WEB_PASSWORD only (API Key rejected for login)

API calls: API_KEY only

Recover credentials:

docker logs antigravity-manager
# or
grep -E '"api_key"|"admin_password"' ~/.antigravity_tools/gui_config.json

API Endpoints

The proxy server runs on port 8045 by default.

OpenAI-compatible (works with any OpenAI SDK)

POST http://localhost:8045/v1/chat/completions
Authorization: Bearer $ANTIGRAVITY_API_KEY

Anthropic-native (Claude Code, etc.)

POST http://localhost:8045/v1/messages
Authorization: Bearer $ANTIGRAVITY_API_KEY

Gemini-native

POST http://localhost:8045/v1/models/{model}:generateContent
Authorization: Bearer $ANTIGRAVITY_API_KEY

Code Examples

Python — OpenAI SDK (Gemini via Antigravity)

import os
from openai import OpenAI

client = OpenAI(
    api_key=os.environ["ANTIGRAVITY_API_KEY"],
    base_url="http://localhost:8045/v1",
)

response = client.chat.completions.create(
    model="gemini-2.5-pro",
    messages=[
        {"role": "user", "content": "Explain quantum entanglement in simple terms."}
    ],
    stream=True,
)

for chunk in response:
    if chunk.choices[0].delta.content:
        print(chunk.choices[0].delta.content, end="", flush=True)

Python — Anthropic SDK (Claude via Antigravity)

import os
import anthropic

client = anthropic.Anthropic(
    api_key=os.environ["ANTIGRAVITY_API_KEY"],
    base_url="http://localhost:8045",
)

message = client.messages.create(
    model="claude-sonnet-4-5",
    max_tokens=1024,
    messages=[
        {"role": "user", "content": "Write a haiku about distributed systems."}
    ],
)
print(message.content[0].text)

Python — Streaming with Anthropic

import os
import anthropic

client = anthropic.Anthropic(
    api_key=os.environ["ANTIGRAVITY_API_KEY"],
    base_url="http://localhost:8045",
)

with client.messages.stream(
    model="claude-opus-4-5",
    max_tokens=2048,
    system="You are a helpful coding assistant.",
    messages=[{"role": "user", "content": "Implement a binary search in Rust."}],
) as stream:
    for text in stream.text_stream:
        print(text, end="", flush=True)

TypeScript / Node — OpenAI SDK

import OpenAI from "openai";

const client = new OpenAI({
  apiKey: process.env.ANTIGRAVITY_API_KEY!,
  baseURL: "http://localhost:8045/v1",
});

async function chat(prompt: string): Promise<string> {
  const response = await client.chat.completions.create({
    model: "gemini-2.5-flash",
    messages: [{ role: "user", content: prompt }],
  });
  return response.choices[0].message.content ?? "";
}

// Image generation via Imagen 3
async function generateImage(prompt: string) {
  const response = await client.images.generate({
    model: "imagen-3.0-generate-002",
    prompt,
    size: "1024x1024",  // maps to Imagen 3 aspect ratio
    n: 1,
  });
  return response.data[0].url;
}

cURL — quick test

# Test OpenAI-compatible endpoint
curl -s http://localhost:8045/v1/chat/completions \
  -H "Authorization: Bearer $ANTIGRAVITY_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gemini-2.5-pro",
    "messages": [{"role": "user", "content": "Hello!"}]
  }' | jq '.choices[0].message.content'

# Test Anthropic endpoint
curl -s http://localhost:8045/v1/messages \
  -H "Authorization: Bearer $ANTIGRAVITY_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "claude-sonnet-4-5",
    "max_tokens": 256,
    "messages": [{"role": "user", "content": "Hello!"}]
  }' | jq '.content[0].text'

Connecting Claude Code CLI

Claude Code uses the Anthropic protocol. Point it at Antigravity:

# Set environment variables before starting Claude Code
export ANTHROPIC_API_KEY=$ANTIGRAVITY_API_KEY
export ANTHROPIC_BASE_URL=http://localhost:8045

claude  # start Claude Code — it will use Antigravity as the backend

Or create a .env in your project root:

# .env
ANTHROPIC_API_KEY=your-antigravity-api-key
ANTHROPIC_BASE_URL=http://localhost:8045

Connecting to Popular AI Clients

Cherry Studio

Open Cherry Studio → Settings → API Provider

Select OpenAI-compatible

Base URL: http://localhost:8045/v1

API Key: your ANTIGRAVITY_API_KEY

Cursor

In Cursor settings, set:

OpenAI Base URL: http://localhost:8045/v1

API Key: your ANTIGRAVITY_API_KEY

Continue.dev

// ~/.continue/config.json
{
  "models": [
    {
      "title": "Gemini Pro (Antigravity)",
      "provider": "openai",
      "model": "gemini-2.5-pro",
      "apiKey": "YOUR_ANTIGRAVITY_API_KEY",
      "apiBase": "http://localhost:8045/v1"
    },
    {
      "title": "Claude (Antigravity)",
      "provider": "anthropic",
      "model": "claude-sonnet-4-5",
      "apiKey": "YOUR_ANTIGRAVITY_API_KEY",
      "apiBase": "http://localhost:8045"
    }
  ]
}

Configuration File

Config is stored at ~/.antigravity_tools/gui_config.json:

{
  "api_key": "sk-your-api-key",
  "admin_password": "your-web-ui-password",
  "proxy": {
    "port": 8045,
    "max_body_size": 104857600,
    "admin_password": "your-web-ui-password"
  },
  "model_routes": [
    {
      "pattern": "gpt-4.*",
      "target": "gemini-2.5-pro"
    },
    {
      "pattern": "gpt-3.5.*",
      "target": "gemini-2.5-flash"
    }
  ]
}

Environment Variables (Docker / server mode)

Variable
Description
Default

API_KEY
API key for authenticating proxy requests
required

WEB_PASSWORD
Web UI admin password
falls back to API_KEY

ABV_MAX_BODY_SIZE
Max request body in bytes (for image uploads)
104857600 (100MB)

Model Routing

Antigravity's model router lets you remap incoming model names to actual upstream models. This is useful when clients hard-code model names like gpt-4.

Configuration via Web UI (API Proxy → Model Router) or gui_config.json:

{
  "model_routes": [
    {
      "pattern": "gpt-4-turbo",
      "target": "gemini-2.5-pro"
    },
    {
      "pattern": "gpt-4o",
      "target": "gemini-2.5-pro"
    },
    {
      "pattern": "gpt-3\\.5.*",
      "target": "gemini-2.5-flash"
    },
    {
      "pattern": "claude-3-opus.*",
      "target": "claude-opus-4-5"
    }
  ]
}

Tiered routing (automatic): Antigravity prioritizes accounts by type (Ultra → Pro → Free) and quota reset frequency, consuming fast-reset accounts first.

Background task demotion (automatic): Requests detected as background tasks (e.g., Claude CLI title generation) are automatically redirected to Flash-tier models to preserve premium quota.

Account Management

Adding accounts via the UI

Open Antigravity Manager desktop app or web UI (http://localhost:8045)

Navigate to Accounts

Click Add Account — the app generates an OAuth 2.0 authorization URL

Complete authorization in any browser

The app captures the callback automatically; click "I've authorized, continue" if needed

Batch import (JSON)

Export from another tool and import in the Accounts page:

[
  {
    "token": "session-token-1",
    "type": "google",
    "label": "account-work"
  },
  {
    "token": "session-token-2",
    "type": "anthropic",
    "label": "account-personal"
  }
]

Migration from v1

Antigravity auto-detects and migrates v1 database format on first launch — no manual steps needed.

Quota Monitoring

The dashboard shows live quota across all accounts:

Gemini Pro remaining calls (average across accounts)

Gemini Flash remaining calls

Claude remaining calls

Imagen 3 image generation quota

Smart Recommendation: The dashboard algorithmically selects the account with the most headroom and offers one-click switching.

403 detection: Accounts banned upstream are automatically flagged and skipped during rotation.

Building from Source (Rust + Tauri v2)

Prerequisites

# Rust
curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh

# Node.js (for frontend)
node --version  # requires v18+

# Tauri v2 CLI
cargo install tauri-cli --version "^2"

# System deps (Linux)
sudo apt install libwebkit2gtk-4.1-dev libayatana-appindicator3-dev librsvg2-dev

Build & run

git clone https://github.com/lbjlaq/Antigravity-Manager.git
cd Antigravity-Manager

npm install          # install frontend deps
cargo tauri dev      # run in development mode
cargo tauri build    # build release binaries → src-tauri/target/release/bundle/

Build headless server only (no GUI)

cd src-tauri
cargo build --release --features headless
./target/release/antigravity-manager --headless --port 8045

Troubleshooting

Port 8045 already in use

# Find and kill the process
lsof -ti:8045 | xargs kill -9
# or change port in gui_config.json:
# "proxy": { "port": 8046 }

Forgotten API key or web password

# Docker
docker logs antigravity-manager | grep -E "api_key|password"

# Local install
cat ~/.antigravity_tools/gui_config.json | grep -E '"api_key"|"admin_password"'

Account shows 403 / banned

The account has been flagged upstream. In the Accounts view it will be marked with a 403 badge and automatically skipped. Add a fresh account and remove/re-authorize the banned one.

Requests failing with 429

Antigravity handles this automatically (rotates to next account within milliseconds). If all accounts are exhausted, add more accounts or wait for quota reset. Check the dashboard for per-account quota status.

macOS Gatekeeper blocking the app

xattr -d com.apple.quarantine /Applications/Antigravity\ Tools.app
# or install with:
brew install --cask antigravity-tools --no-quarantine

Docker container not persisting accounts after restart

Ensure the volume mount is correct:

docker run ... -v ~/.antigravity_tools:/root/.antigravity_tools ...
# Verify data is present:
ls ~/.antigravity_tools/

Claude Code not connecting

# Verify the proxy is running
curl -s http://localhost:8045/v1/models \
  -H "Authorization: Bearer $ANTIGRAVITY_API_KEY"

# Check env vars are exported (not just set)
export ANTHROPIC_BASE_URL=http://localhost:8045
export ANTHROPIC_API_KEY=$ANTIGRAVITY_API_KEY
echo $ANTHROPIC_BASE_URL  # should print the URL

Project Structure (for contributors)

Antigravity-Manager/
├── src/                    # React frontend (TypeScript)
│   ├── components/         # UI components (Dashboard, Accounts, etc.)
│   └── pages/
├── src-tauri/              # Rust backend
│   ├── src/
│   │   ├── main.rs         # Tauri app entry
│   │   ├── proxy/          # Axum HTTP proxy server
│   │   │   ├── router.rs   # Model routing logic
│   │   │   ├── dispatcher.rs # Account rotation
│   │   │   └── mapper.rs   # Protocol conversion
│   │   ├── accounts/       # Account storage & OAuth
│   │   └── quota/          # Quota tracking
│   └── Cargo.toml
├── docker/
│   └── Dockerfile
├── install.sh              # Linux/macOS installer
├── install.ps1             # Windows installer
└── docker-compose.yml