In today’s era of booming AI applications, developers and AI enthusiasts often face a common set of challenges: inconsistent interface protocols across different AI services (such as Google Gemini and Anthropic Claude), cumbersome multi-account management, and difficult quota monitoring. These issues not only hinder development efficiency but may also lead to resource waste or service interruptions.
Antigravity Tools (Version 3.3.1) is built to solve these exact problems. As a professional desktop application, it integrates multi-account management, protocol conversion, and intelligent request scheduling into a single platform, serving as your local AI relay station. Whether you need to convert web-side Sessions into standardized APIs or achieve seamless switching between different AI services, it provides stable and efficient support.
Core Features: Simplifying AI Management
Intelligent Account Dashboard: Gain a Bird’s-Eye View of Global Status
Imagine this: when you’re using multiple Gemini Pro, Gemini Flash, and Claude accounts simultaneously, how do you quickly identify which account has sufficient quotas and is in good standing? The Intelligent Account Dashboard acts as your “AI account command center”.
It displays the real-time health status of all accounts, including the average remaining quota for various models. More practically, the system automatically recommends the “best account” based on the quota redundancy of each account, with one-click switching to eliminate the hassle of manual comparison. At the same time, the quota percentage of active accounts and the last synchronization time are displayed intuitively, keeping you fully informed of resource usage.
Powerful Account Manager: Flexible Multi-Account Management
Adding and managing multiple AI accounts has always been a tedious task, but the Account Manager feature of Antigravity Tools simplifies this process significantly:
- ▸
OAuth 2.0 Authorization: When adding an account, the system generates a copyable authorization link that you can use to complete authorization in any browser. After successful authorization, the application automatically saves the account information; if the process does not complete automatically, simply click “I have authorized, continue” to finalize it manually. - ▸
Multi-Dimensional Import: Supports single Token entry, batch JSON import (e.g., from backup files of other tools), and automatic migration from V1 old version databases, eliminating the need for repeated configuration. - ▸
Gateway-Level Views: Offers two views—”List” and “Grid”—for operation in different scenarios. Additionally, it automatically detects 403 ban status, marks, and skips accounts with permission exceptions to avoid invalid requests.
Protocol Conversion and Relay: Breaking Down API Barriers
Interface protocols of different AI vendors are often incompatible, which means you may need to write adaptive code for each service individually. The protocol conversion feature of Antigravity Tools completely resolves this issue:
- ▸
Full Protocol Compatibility: - ▸
Provides an OpenAI-formatted /v1/chat/completionsendpoint, compatible with 99% of existing AI applications; - ▸
Supports the Anthropic native /v1/messagesinterface, including all features of Claude Code CLI (such as chain-of-thought and system prompts); - ▸
Compatible with the Google official SDK, allowing direct calls to Gemini-related functions.
- ▸
- ▸
Intelligent State Self-Healing: When a request encounters 429 (too many requests) or 401 (unauthorized) errors, the backend automatically retries and switches accounts in milliseconds to ensure uninterrupted business operations.
Model Routing Center: Precisely Controlling Request Flow
If you need to route specific requests to designated models, the Model Routing Center can meet your requirements:
- ▸
Serialized Mapping: Complex original model IDs can be categorized into “spec families”, for example, routing all GPT-4 requests uniformly to gemini-3-pro-high. - ▸
Expert-Level Redirection: Supports custom regular expressions for model mapping, enabling precise control over the landing model of each request to flexibly adapt to various scenarios.
Multimodal and Imagen 3 Support: Effortlessly Handling High-Definition Content
For scenarios that require image processing, Antigravity Tools also delivers outstanding performance:
- ▸
Advanced Image Quality Control: Automatically maps to corresponding Imagen 3 specifications through OpenAI’s sizeparameter (e.g.,1024x1024,16:9), eliminating the need for manual adjustments. - ▸
Super Load Support: The backend supports Payloads up to 100MB, which is more than sufficient for processing 4K high-definition image recognition, meeting the needs of multimodal applications.
Interface Tour: An Intuitive and User-Friendly Operation Experience
The interface design of Antigravity Tools prioritizes practicality and ease of use, with the following core pages:
The dashboard is your starting point for using the tool, centrally displaying the quota status and best recommendations for all accounts, allowing you to quickly grasp the overall situation.
The account list page supports switching between two views, clearly displaying detailed information for each account (including quotas and status), facilitating batch management.
The about page provides basic information such as tool version details and copyright notices, helping you understand the background of the tool.
The API reverse proxy page is used to control the activation and configuration of services, including key parameters such as ports and protocols, and is the core entry point for implementing protocol conversion.
The system settings page allows you to customize various parameters of the tool, such as startup on boot and log management, to meet personalized needs.
Technical Architecture: Understanding How the Tool Works
The efficient operation of Antigravity Tools relies on a clear technical architecture, with its core workflow as follows:
-
External Application Access: External applications such as Claude Code and NextChat connect to Antigravity’s Axum server via the OpenAI or Anthropic protocol. -
Middleware Processing: Requests first pass through middleware for authentication, rate limiting, logging, etc., to ensure security and compliance. -
Model Routing: The Model Router routes requests to the corresponding models based on preset mapping rules. -
Account Distribution: The account dispatcher selects the appropriate account to process the request based on round-robin or weight-based strategies. -
Protocol Conversion: The Request Mapper converts external requests into a format recognizable by upstream services (such as Google and Anthropic APIs). -
Upstream Interaction: The converted request is sent to the upstream API. After obtaining the response, the Response Mapper converts it into a format recognizable by the external application, which is then finally returned to the client.
This architectural design ensures the efficiency and flexibility of request processing, and is also the key to the tool’s ability to achieve multi-protocol compatibility and intelligent scheduling.
Installation Guide: Rapid Tool Deployment
Option A: macOS Terminal Installation (Recommended)
If you are using macOS and have Homebrew installed, you can quickly install the tool through the following steps:
-
Tap the repository:
brew tap lbjlaq/antigravity-manager https://github.com/lbjlaq/Antigravity-Manager
-
Install the application:
brew install --cask antigravity-tools
If you encounter permission issues, you can add the --no-quarantine parameter:
brew install --cask --no-quarantine antigravity
Option B: Manual Download
Download the installation package for your corresponding system from GitHub Releases:
- ▸
macOS: .dmgformat (supports Apple Silicon and Intel chips) - ▸
Windows: .msior portable.zipformat - ▸
Linux: .deborAppImageformat
Common Issue Troubleshooting
macOS prompts “App is damaged and cannot be opened”?
This is caused by macOS’s security mechanism and can be resolved through the following methods:
-
Command Line Fix (Recommended):
Open Terminal and execute:
sudo xattr -rd com.apple.quarantine "/Applications/Antigravity Tools.app"
-
Homebrew Installation Tip:
Adding the--no-quarantineparameter when installing via brew can avoid this issue:
brew install --cask --no-quarantine antigravity
Quick Integration: How to Use Antigravity Tools?
OAuth Authorization Process (Adding an Account)
-
Open “Accounts” → “Add Account” → “OAuth”. -
A pop-up window will generate an authorization link that you can copy to the clipboard and open in a browser to complete authorization. -
After successful authorization, the browser will display “✅ Authorization Successful!”. -
The application will automatically save the account; if it does not complete automatically, click “I have authorized, continue” to finalize it manually.
“
Tip: The authorization link contains a one-time callback port. Please use the latest link in the pop-up window; if the application is not running or the pop-up window is closed during authorization, the browser may prompt
localhost refused connection.
Integrating with Claude Code CLI
-
Launch Antigravity and enable the service on the “API Reverse Proxy” page. -
Execute the following commands in Terminal:
export ANTHROPIC_API_KEY="sk-antigravity"
export ANTHROPIC_BASE_URL="http://127.0.0.1:8045"
claude
Integrating with Kilo Code
-
Protocol Selection: It is recommended to use the Gemini protocol first. -
Base URL: Enter http://127.0.0.1:8045.
Notes:
- ▸
OpenAI Protocol Limitations: When Kilo Code uses the OpenAI mode, the request path may appear in a non-standard format (e.g., /v1/chat/completions/responses), resulting in a 404 error. Therefore, the Gemini mode should be selected. - ▸
Model Mapping: If the model names do not match, you can set custom mappings on the “Model Mapping” page and view log files for debugging.
Usage in Python
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": "Hello, please introduce yourself"}]
)
print(response.choices[0].message.content)
Version Evolution: Tool Iteration and Optimization
Antigravity Tools is continuously iterated to optimize its functionality and stability. Below are the update highlights of the major versions:
v3.3.1 (December 28, 2025)
- ▸
Fix for Claude Protocol 400 Errors: Resolved upstream validation errors caused by cache_controltags orthought: truefields in long-context conversations, and optimized the conversion logic for MCP tool definitions. - ▸
Built-in Web Tool Compatibility for All Protocols: The OpenAI, Gemini, and Claude protocols all support triggering web access “without model suffixes”, enhancing compatibility with clients such as Cherry Studio. - ▸
End-to-End Tracing and Log Optimization: Added a 6-digit random Trace ID to each request, marking request attributes ( [USER]for real conversations,[AUTO]for background tasks), and achieving closed-loop echo of Token consumption. - ▸
Optimization for Claude CLI Background Tasks: Identifies low-value requests such as title generation and summary extraction, and automatically redirects them to gemini-2.5-flashto save high-value model quotas.
v3.3.0 (December 27, 2025)
- ▸
Codex CLI and Claude CLI Compatibility: Supports the /v1/responsesendpoint of Codex CLI, and resolves signature validation errors when Claude CLI uses Gemini 3 series models. - ▸
OpenAI Protocol Stack Reconstruction: Added /v1/completionsand/v1/responsesroutes, integrating image parsing and JSON Schema filtering strategies. - ▸
Network Binding Control: Listens to 127.0.0.1by default (local access only), and LAN access can be enabled via theallow_lan_accessswitch, balancing privacy and flexibility.
v3.2.8 (December 26, 2025)
Fixed the 400 error when sending image requests to vision models (e.g., gemini-3-pro-image) under the OpenAI protocol, complementing the vision processing capability to keep it consistent with the Claude protocol.
v3.2.7 (December 26, 2025)
- ▸
New Features: Added automatic startup on boot, and the account list supports pagination size selection (10/20/50/100 entries). - ▸
Enhanced JSON Schema Cleaning: Removes advanced fields not supported by Gemini (such as propertyNamesandconst), resolving errors when using MCP tools with Claude Code v2.0.76+. - ▸
Reverse Proxy Stability Optimization: Supports parsing upstream RetryInfoto accurately follow retry instructions; optimizes concurrent processing of image generation requests to resolve 429 errors.
Earlier Versions
- ▸
v3.2.6: Optimized the Claude protocol, resolved tool conflict errors, and enhanced reverse proxy stability. - ▸
v3.2.3: Optimized the process management architecture, resolving process identification issues in Linux environments. - ▸
v3.2.2: Upgraded the logging system to achieve full log persistence, and optimized Google free quota routing. - ▸
v3.2.1: Supports custom DB import, and enhances the tool calling capability of the OpenAI and Gemini protocols. - ▸
v3.2.0: Reconstructed the API reverse proxy engine, optimized Linux process management, and reconstructed the dashboard interface.
Frequently Asked Questions (FAQ)
What AI services does Antigravity Tools support?
Currently, it supports mainstream AI services such as Google Gemini (including Pro, Flash, and image generation models) and Anthropic Claude. Through protocol conversion, it is compatible with most applications based on the OpenAI and Anthropic protocols.
What are the advantages of multi-account management?
Multi-account management can avoid service interruptions caused by quota exhaustion of a single account, and the system will automatically switch accounts; at the same time, through best account recommendations, it can prioritize the use of accounts with sufficient quotas to improve resource utilization.
How to resolve startup issues after installation?
- ▸
For macOS users who encounter the “App is damaged” prompt, you can fix it by executing sudo xattr -rd com.apple.quarantine "/Applications/Antigravity Tools.app"in Terminal. - ▸
If other systems fail to start, it is recommended to check the integrity of the installation package or try re-downloading the installation file for the corresponding version.
Where are log files stored and how to view them?
Log files are automatically archived to the local app.log, recording system startup, request processing, and other information. You can find log-related options in the settings page, including viewing and clearing logs.
Will the tool upload my account data?
No. All account data is encrypted and stored in a local SQLite database. Unless the synchronization function is manually enabled, the data will not leave your device, ensuring privacy and security.
Summary
As a professional AI account management and protocol reverse proxy system, Antigravity Tools provides an efficient local AI relay station solution for developers and AI enthusiasts through its intelligent dashboard, flexible account management, full protocol compatibility, precise model routing, and multimodal support.
Whether it is simplifying the multi-account management process or breaking down the protocol barriers between different AI services, it can play an important role. With continuous version iteration, its functionality and stability are constantly improving, making it a practical tool for connecting various AI services.
If you are troubled by multi-AI service management, you may wish to try Antigravity Tools to make AI application development and usage simpler and more efficient.
