GET STARTED · ANTIGRAVITY TOOLS

Antigravity Manager Guide: Start Here

To get started with Antigravity Manager, add one account and choose where you want to use it: in Antigravity IDE, through another AI client or on a server. Follow your route below to reach a working conversation.

The application is called Antigravity Tools. These guides cover version 5.0.0 of lbjlaq’s Antigravity Manager.

Where do you want to use your account?

Choose the IDE route to switch the account in Google Antigravity IDE, the API route to connect another app, or Docker to host the gateway on a server.

FIRST RUN

Add your first account

Open Antigravity Tools and authorize one account before connecting the IDE or an API client. For a remote installation, start with the server route to set up browser access.

  1. Open Antigravity Tools

    Get the package for your computer from Downloads and follow the installation guide. Open the app and go to Accounts → Add Account → OAuth.

  2. Authorize the account in your browser

    Copy the current authorization link from the dialog, open it in your browser and complete sign-in and consent. Keep the app and dialog open throughout. If consent finishes but the app is still waiting, click I already authorized.

  3. Check the saved account

    Confirm that the intended email address appears in Accounts. Check its status and the last quota refresh, then continue with your IDE or API client below. If the account is saved but quotas fail to load, use the quota guide to check refresh errors and available models.

DESKTOP ROUTE

Switch accounts in Antigravity IDE

Use Manager’s account controls to select the account for your installed Google Antigravity IDE. The IDE uses that account’s access and quotas; automatic selection across an account pool belongs to the API gateway workflow.

  1. Install Google Antigravity IDE separately, save your work and note the account you are currently using.
  2. In Manager, check the target account’s model quotas and refresh time, then use its switch action. Follow the account guide for the switching controls.
  3. Return to the IDE and confirm the active email address. Start a fresh conversation with a short prompt, then ask a follow-up.

Ready to work: the IDE shows the intended account and answers both messages. You can then return to your project.

If the IDE keeps the old account, use account-switching troubleshooting. To return to your previous setup, switch back to the account you noted and check the IDE identity again.

API ROUTE

Connect Claude Code, OpenCode or another client

Start Manager’s API proxy, then give your client the gateway address, API key and model name. The gateway receives the client’s requests and routes them to an upstream service.

  1. Save a copy of your client’s current settings. In Manager, open API Proxy and follow the proxy setup guide to configure and start the service.
  2. Use the instructions for Claude Code CLI, OpenCode or another API client. For a desktop app, look for its custom-provider settings and supported protocol.
  3. Copy your configured gateway key and choose an available model. Send a short text prompt, then a follow-up in the same conversation.
Addresses when Manager and the client run on the same computer
OpenAI-compatible base URL
http://127.0.0.1:8045/v1
Anthropic / Claude Code base URL
http://127.0.0.1:8045

Replace 8045 if you configured a different port. For a client on another device, use the gateway computer’s reachable address and configure network access and authentication. Enter the API key from Manager in the client’s key field.

Ready to work: the client answers the prompt and uses the earlier message when answering your follow-up. Try tools or media next if your workflow needs them.

If the selected model produces an unexpected result, check model names and routing. To undo the connection change, restore your saved client settings; OpenCode’s sync panel also provides a Restore action.

SERVER ROUTE

Run the gateway on a server or NAS

Use Docker to host the API gateway and manage accounts through a browser. Start with the Docker deployment guide for the container configuration and remote sign-in steps.

  1. Choose a host directory for persistent data and mount it at /root/.antigravity_tools inside the container.
  2. Set separate credentials: API_KEY for client requests and WEB_PASSWORD for the management interface. Configure access controls before making the service reachable from other devices.
  3. Open the Web UI at your configured server address and port. Add an account, then connect a client using that server address.

Ready to work: you can sign in to the Web UI and complete a conversation from the intended client device. Restart the container and confirm that the saved account and settings remain available.

Before upgrading or replacing the container, back up its persistent data. Keep the backup together with the version you used so you can plan a compatible restore.

TROUBLESHOOTING

Where did setup stop?

Start with the symptom you can observe. Keep the exact error message and change one setting at a time.

The app will not open
Use the installation and startup guide for your operating system before changing account files.
The browser finishes sign-in, but the account is missing
Keep Manager’s authorization dialog open and use its newest link. Follow OAuth and sign-in troubleshooting if the callback fails or authorization remains incomplete.
The IDE still uses the previous account
Compare the identity shown in the IDE with your selection in Manager, then follow the switching checks.
The client cannot connect, or returns 401 or 404
Check the running service, base URL, port, protocol and gateway key with the connection-error guide.
A request returns 429 or 503
Keep the response body and requested model name. Use the quota and availability guide to distinguish rate limits from account or model availability problems.
A reply hangs or a tool call fails
Try a short text conversation, then the failing feature. Follow the streaming and tool-call checks with your client and Manager versions.

For another symptom, open the troubleshooting hub. If you need to report a reproducible problem, use the logs and bug-report guide to collect versions, steps and relevant errors while removing keys, tokens and private content.

GUIDE DIRECTORY

Choose your next task

Open the guide for the change you want to make. Each one covers the setup details and checks for that task.

Install & open the app

Choose the right package, finish installation and resolve startup errors on Windows, macOS or Linux.

Installation guide

Add & manage accounts

Complete browser sign-in, import an existing account or choose the account to use in your IDE.

Account setup

Read quotas & choose an account

Understand model-specific balances, refresh times and the information to check before switching.

Quotas and switching

Start the API proxy

Set the gateway address, port and authentication, then make your first model request.

API proxy setup

Choose a client connection

Match your app to its API protocol and configuration method, including custom-provider settings.

Client connection guide

Connect Claude Code

Set the CLI’s gateway address and key, choose a model and check the first conversation.

Claude Code setup

Connect OpenCode

Create the Manager provider, select a model and restore your previous configuration when needed.

OpenCode setup

Choose models & routing

See how a client model name maps to an upstream model and investigate an unexpected model choice.

Models and routing

Deploy with Docker

Run the gateway on a server or NAS with browser administration and persistent account data.

Docker deployment

Control access

Configure authentication and network access before connecting other devices or sharing the gateway.

Access and security

Back up & recover data

Find your account and configuration files, prepare a backup and plan a restore or migration.

Data and recovery

Work with images, audio & video

Find the request format for your media task and check the returned file or response.

Multimodal guide

Look up an API detail

Find endpoint paths, headers, configuration fields and request examples.

Technical reference

WINDOWS DOWNLOAD

Archive password

Keep this password to open your Windows download if prompted.