Open source · MIT · macOS 13+ · Apple Notarized Native App

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.

AI Usage Barometer — Menu bar, Dock icon, and Floating bar
Overview

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.

Why it matters

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.

How it works

Battery-style multi-gauge tailored for 3 major AIs

Service-specific brand colors, unified 1-line compact status, reset countdowns, and strictly local reads.

Battery-Style Quota Bars

Filled blocks represent remaining quota and dots show consumed usage across Claude, Codex, and Gemini in a single sleek line.

3-Tier Service Color Palettes

Claude Orange (#C66D28), Codex Cyan (#1A8BA6), and Gemini Emerald (#158F6A), dynamically shifting to warning and critical shades.

3 Placement Modes

Display in your Menu Bar, directly on your Dock Icon (0px screen footprint), or as a draggable Floating Bar.

Private & Strictly Local

Reads tokens from macOS Keychain and Antigravity local RPC. No accounts, no telemetry, and nothing leaves your Mac.

Features

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.

Install

One line in Terminal

Install the Apple-signed & notarized native Mac app with a single terminal command.

Native Mac App

Recommended · Apple Notarized

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).

FAQ

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.