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

Widget
System Tray

System Tray
Settings

Settings

System Requirements

Windows macOS Linux

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

Download the latest release:

  • Setup: .exe installer, 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

Download the latest release:

  • 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

  1. After launching the app, click the tray icon to open settings
  2. Click "Add Account" to log in with your Google account
  3. After successful login, select the models you want to monitor (up to 6 for the widget)
  4. 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 Credits in 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?

  1. Check your network connection
  2. Try removing and re-adding your account
  3. 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:

  1. When redistributing, please keep the source attribution: https://github.com/wusimpl/ag-quota-desktop
  2. Please do not use for commercial purposes, use the code legally and compliantly
  3. If the license changes, it will be updated in this GitHub repository without further notice

Acknowledgements

License

GPL-3.0 License