Install & open the app
Choose the right package, finish installation and resolve startup errors on Windows, macOS or Linux.
Installation guideGET STARTED · ANTIGRAVITY TOOLS
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.
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
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.
Get the package for your computer from Downloads and follow the installation guide. Open the app and go to Accounts → Add Account → OAuth.
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.
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
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.
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
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.
http://127.0.0.1:8045/v1http://127.0.0.1:8045Replace 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
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.
/root/.antigravity_tools inside the container.API_KEY for client requests and WEB_PASSWORD for the management interface. Configure access controls before making the service reachable from other devices.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
Start with the symptom you can observe. Keep the exact error message and change one setting at a time.
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
Open the guide for the change you want to make. Each one covers the setup details and checks for that task.
Choose the right package, finish installation and resolve startup errors on Windows, macOS or Linux.
Installation guideComplete browser sign-in, import an existing account or choose the account to use in your IDE.
Account setupUnderstand model-specific balances, refresh times and the information to check before switching.
Quotas and switchingSet the gateway address, port and authentication, then make your first model request.
API proxy setupMatch your app to its API protocol and configuration method, including custom-provider settings.
Client connection guideSet the CLI’s gateway address and key, choose a model and check the first conversation.
Claude Code setupCreate the Manager provider, select a model and restore your previous configuration when needed.
OpenCode setupSee how a client model name maps to an upstream model and investigate an unexpected model choice.
Models and routingRun the gateway on a server or NAS with browser administration and persistent account data.
Docker deploymentConfigure authentication and network access before connecting other devices or sharing the gateway.
Access and securityFind your account and configuration files, prepare a backup and plan a restore or migration.
Data and recoveryFind the request format for your media task and check the returned file or response.
Multimodal guideFind endpoint paths, headers, configuration fields and request examples.
Technical referenceCheck release changes, client compatibility and rollback considerations before upgrading.
Updates and compatibility