AI Usage Barometer
A refined macOS battery-style gauge monitoring quota for Claude, Codex, and Gemini in real time. Keep track of remaining limits and reset countdowns across menu bar, Dock icon, or floating bar.
Your Claude, Codex & Gemini limits, always in sight
AI Usage Barometer is an Apple Developer ID signed and notarized native macOS application providing unified real-time monitoring of 5h and 1w usage quotas across Claude, Codex, and Gemini (Antigravity Desktop 2.0 & IDE). Choose between Menu Bar, Dock Icon, and Floating Bar placements with zero telemetry and 100% local operation.
Stop coding flow interruptions from unexpected quota limits
Claude's 5-hour and 1-week windows, Codex dynamic limits, and Gemini quotas are rolling windows. Stopping your work to check multiple dashboards breaks focus. An always-visible gauge eliminates sudden quota lockouts.
Scattered Across Multiple Tools
Claude, Codex, and Gemini quotas are fragmented across different apps, with no single native indicator to view them together.
Context Switching Friction
Digging through web consoles or CLI commands every time you wonder what's left disrupts your deep work flow.
Unexpected Mid-Session Lockouts
Hitting a hard rate limit right before shipping a critical fix stalls progress. A proactive gauge prevents surprises.
Battery-style multi-gauge tailored for 3 major AIs
Service-specific brand colors, unified 1-line compact status, reset countdowns, and strictly local reads.
Filled blocks represent remaining quota and dots show consumed usage across Claude, Codex, and Gemini in a single sleek line.
Claude Orange (#C66D28), Codex Cyan (#1A8BA6), and Gemini Emerald (#158F6A), dynamically shifting to warning and critical shades.
Display in your Menu Bar, directly on your Dock Icon (0px screen footprint), or as a draggable Floating Bar.
Reads tokens from macOS Keychain and Antigravity local RPC. No accounts, no telemetry, and nothing leaves your Mac.
Thoughtfully crafted for pro developers
Lightweight, ultra-fast, rock-solid security, and macOS native elegance.
Claude, Codex & Gemini 3-in-1
Full support for Claude Code (5h & 1w), Codex CLI (dynamic rolling windows), and Gemini (Antigravity Desktop 2.0 & IDE).
Service-Specific High-Contrast Palette
Distinct vector rendering with Claude Orange (#C66D28), Codex Cyan (#1A8BA6), and Gemini Emerald (#158F6A).
Menu Bar, Dock & Floating Bar
Choose between the standard Menu Bar, a Dock icon gauge with zero screen footprint, or a draggable Floating Bar.
Apple Notarized Native Mac App
Ready-to-run Apple Developer ID signed & notarized native Mac app with zero Homebrew or Xcode dependencies.
Auto-Update Alerts & 1-Click Upgrade
Automatically checks GitHub Releases and surfaces update alerts in the menu for instant, seamless in-place upgrades.
Rate-Limit Friendly & Smart Caching
Smart caching and backoff protect against API rate limits and gracefully handle temporary 429 errors.
One line in Terminal
Install the Apple-signed & notarized native Mac app with a single terminal command.
Native Mac App
Zero dependencies — no Homebrew or Xcode needed. Apple Developer ID signed & notarized. Choose between Menu Bar, Dock Icon, and Floating Bar.
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/taka-avantgarde/ai-usage-barometer/main/install-app.sh)"Requires macOS 13 (Ventura) or later. Intel & Apple Silicon (Universal Binary).
Frequently asked questions
Is AI Usage Barometer free?
Yes. It is open source under the MIT license and completely free. It only connects to your existing Claude Code, Codex CLI, and Antigravity (Gemini) sessions without any added cost.
Do I need Homebrew or Xcode installed?
No. AI Usage Barometer is a standalone Apple-signed and notarized native Mac app requiring no Homebrew or Xcode, supporting Menu Bar, Dock Icon, and Floating Bar placements out of the box.
Are my tokens and credentials safe?
Yes, completely safe. It reads Claude Code tokens from macOS Keychain, Codex from local CLI helpers, and Gemini via Antigravity local RPC/SQLite. Zero telemetry, no external server calls.
What do the colors mean?
Claude uses Orange (#C66D28), Codex uses Cyan (#1A8BA6), and Gemini uses Emerald (#158F6A). Under 70% used is healthy, 70–89% shifts to warning, and 90–100% displays critical red. Filled blocks represent remaining quota, dots represent consumed usage.
How does Gemini (Antigravity) integration work?
It fully supports both Antigravity Desktop App 2.0 and Antigravity IDE (VS Code based). Quota is fetched locally without external API calls via Language Server Connect RPC, SQLite (state.vscdb), and cached state fallbacks.
Put Claude, Codex & Gemini limits on your desktop
Install in one line, then never be surprised by a usage limit again. Free and open source.
