AI Usage Ball 0.3.8

Added

• Grok Bot Orb: A fourth crystal ball that reads your weekly Grok Bot usage from the local Grok Bot app cache, with remaining percentage, plan name, and reset countdown. It can also be popped out as a desktop widget, and double-clicking it opens Grok Bot.

Fixed

• Offline Labels: Offline orbs no longer say OPEN ANTIGRAVITY for every provider; each one names its own app (for example OFFLINE · OPEN GROK BOT).
• Offline Widgets: Desktop widgets for any orb whose source is unavailable (including Grok) now show an offline state with empty rings and liquid, instead of the last live percentage.
• Plan Label on Single-Ring Orbs: Orbs with a single gauge now show their plan under the percentage (for example SUPER PLAN).
• Stale Grok Usage: A missing, unreadable, expired, or previous-window Grok usage cache now shows as offline instead of a full 100% quota, and no longer flickers between the old value and 100% after the weekly reset.
• Widget Placement on Smaller Displays: Popped-out widgets now stay inside the visible screen area; on shorter displays the fourth widget wraps into a second column instead of opening off-screen.
• Dock Icon Reopens the Dashboard: Clicking the Dock or app icon now restores the main window after it was closed.
• Orb Subtitles: Subtitle lines now follow the same order as the rings and timers, with matching colored indicator dots.

Also included

• This build also ships the 0.3.7 changes, which were not published as a separate GitHub release: the Antigravity Gemini 4 gauge (third inner ring with its own remaining percentage and reset countdown) and weekly quota gating (when the weekly quota is exhausted, Claude and Codex orbs show WAIT RESET instead of a misleading full five-hour window).

Full changelog: https://aiusageball.com/changelog

v0.3.6

Fix: in-app Buy now uses live checkout.

v0.3.5

Added

• Gemini 4 in Antigravity now gets its own usage gauge: a third ring on the Antigravity orb with its own remaining percentage and reset countdown.

AI Usage Ball 0.3.4

Fixed

• Codex now shows READY TO GO until the current five-hour allowance is actually used.
• Once usage starts, the five-hour countdown runs normally; weekly usage, weekly reset, and reset credits remain visible.

AI Usage Ball 0.3.3

Added

• Codex now shows five-hour and weekly remaining usage as dual liquid rings.
• Codex now shows separate five-hour and weekly reset countdowns, plus reset credits left below the orb.

Fixed

• Codex usage polling now reads the weekly secondary window from the ChatGPT usage endpoint and clears it after the weekly reset.

AI Usage Ball 0.3.2

Fixed

• The liquid in desktop widgets would stop animating after a while — sometimes one orb, sometimes all of them — and clicking or hovering wouldn't bring it back. The animation was being driven frame-by-frame from JavaScript, which macOS is free to throttle or suspend for windows that sit behind everything else, so the countdown kept ticking while the liquid sat frozen. It now plays natively, which nothing can stall, and uses a fraction of the CPU.
• A widget whose liquid video dropped out (for example after the app's background service restarted) would stay frozen permanently. It now recovers on its own.

AI Usage Ball 0.3.1

Fixed

• Desktop widgets could overlap each other by a sliver (window height was taller than the spacing between them), so the middle widget could silently steal clicks meant for its neighbors. Widgets are now spaced far enough apart that this can't happen.

AI Usage Ball 0.3.0

Added

• Team View: see 2-3 teammates' remaining usage alongside your own during a pairing session. Opt-in and local-network only — turn on sharing right from the "Share" button under your orbs (or in Settings → General), then pin teammates who show up automatically, or add one by local IP if your WiFi isolates devices. Nothing ever leaves your Mac except a name and three percentages, and only when you've explicitly turned it on.

Built for uri_yap on Product Hunt, who asked for exactly this.

v0.2.3

Fixed

• Popped-out desktop widgets: the liquid still didn't react to hovering, only to clicking. Widgets now watch the cursor natively and start the flow after it rests over the orb for a couple of seconds.

AI Usage Ball 0.2.2

AI Usage Ball 0.2.2 fixes desktop widget behavior on macOS and opens the founding-user beta.

What's changed:

• Desktop widgets now stay behind regular app windows, like true desktop widgets.
• Hover and click input now works immediately on inactive widget windows.
• The public website now uses clean canonical URLs and consistent sitemap links.
• The first 100 beta users can request a free lifetime personal license at https://aiusageball.com.

The Apple Silicon build supports macOS 12 or later. It is signed with Developer ID, notarized by Apple, and includes automatic updates. Usage is read locally from your existing sessions and is not proxied through an AI Usage Ball server.