Float
January 29, 2026 · View on GitHub
Choose Your Language: 简体中文 | English
Caution
This application requires logging in with a Google account and obtaining an Access Token. The token is stored locally only and will not be uploaded to any server. However, please note: Anyone with your token can access your Google Cloud resources. Please keep your configuration files safe.
A standalone desktop application for real-time monitoring of Google Antigravity AI model quota and Kiro Credits.
This is the desktop version of Antigravity Quota Watcher extension. No local Antigravity environment required, check your quota anytime, anywhere.
Demo
Widget
|
System Tray
|
Settings
|
System Requirements
Features
- ✅ Real-time monitoring of Antigravity AI model quota (e.g., Gemini-3-Pro, etc.)
- ✅ Kiro Credits display support
- ✅ Desktop widget showing up to 6 models simultaneously
- ✅ Multi-account management
- ✅ Custom model aliases
- ✅ Adjustable refresh interval and warning thresholds
Installation
Windows
- Setup:
.exeinstaller, double-click to install - Portable: No installation required, extract and run
macOS
Download the latest release .dmg file:
- x64: For Intel Macs
- arm64: For Apple Silicon (M1/M2/M3) Macs
After dragging to your Applications folder, since the app is unsigned, you may see a "Applications is damaged, cannot open" warning on first launch. Run the following command in Terminal before opening:
xattr -cr /Applications/Float.app
Installation still has questions? Please refer to this article.
Linux
- AppImage: No installation required, add execute permission and run (
chmod +x *.AppImage) - deb: For Debian/Ubuntu, install with
sudo dpkg -i *.deb
Usage
First Time Setup
- After launching the app, click the tray icon to open settings
- Click "Add Account" to log in with your Google account
- After successful login, select the models you want to monitor (up to 6 for the widget)
- Enable "Show Widget" to display quota information on your desktop
Widget
The widget displays up to 6 models:
- The first 2 models are shown as "Energy Capsules", with water level indicating remaining quota percentage
- Models 3-6 are displayed as compact Mini Bars below
- Drag to any position, the position will be saved automatically
Kiro Credits Support
This app supports displaying Kiro Credits:
- Select
Kiro Creditsin the model selection to monitor it - Kiro Credits shows remaining credits instead of percentage
- Reset period is displayed as "monthly"
Settings Page
In the settings page you can:
- Manage Google accounts (add/remove)
- Select models to display in the widget
- Set model aliases (e.g., shorten "gemini-3-pro" to "G Pro")
- Adjust refresh interval, warning thresholds, etc.
Tray Menu
Right-click the tray icon to:
- Show/Hide widget
- Refresh quota immediately
- Open settings
- Quit the app
Quota Status Colors
Same as the extension version, quota status is color-coded:
- Green: Remaining quota ≥ 50% (Sufficient)
- Yellow: Remaining quota 30%-50% (Warning)
- Red: Remaining quota < 30% (Low)
- Gray: Quota exhausted (0%)
Thresholds can be customized in settings.
FAQ
Browser doesn't open during login?
The browser should open automatically during login. If it doesn't, you can manually copy the link from the dialog to your browser.
Widget disappeared?
Right-click the tray icon and select "Show Widget".
Quota not updating?
- Check your network connection
- Try removing and re-adding your account
- Click "Refresh Now" to manually refresh
How to configure proxy?
Turn on the proxy switch, the app will automatically detect system proxy (environment variables HTTP_PROXY/HTTPS_PROXY or system proxy settings). To manually specify a proxy, enter the proxy URL (e.g., http://127.0.0.1:7890) in Settings > System Settings. Leave empty to use system proxy.
Configuration File Location
All configurations (including login tokens) are stored locally. If you need to backup, migrate, or manually clean up, you can find the following configuration files:
- config.json: Stores application settings and model configurations
- auth.json: Stores Google account login tokens (encrypted with
safeStorage)
Actual Paths:
Windows:
%APPDATA%\Float\
macOS:
~/Library/Application Support/Float/
Linux:
~/.config/Float/
Submitting Issues
When submitting an issue, please include:
- Your operating system version
- Steps to reproduce the problem
- Screenshots if there are any errors
Usage Agreement
This project is open source under the GPL-3.0 License. Please comply with the license when using this project.
Additionally, please be aware of the following:
- When redistributing, please keep the source attribution: https://github.com/wusimpl/ag-quota-desktop
- Please do not use for commercial purposes, use the code legally and compliantly
- If the license changes, it will be updated in this GitHub repository without further notice
Acknowledgements
- Antigravity-Manager - Reference for Google API login flow
License
GPL-3.0 License