Local-first desktop usage monitor

AI Usage Widget

A compact always-on-top widget for Codex, Claude Code, and Gemini CLI usage on Windows, Ubuntu Desktop, and macOS. It stays local, warns before quotas get tight, and can be recovered from the tray when monitor layouts change.

View on GitHub Download releases
AI Usage Widget screenshot

Why this project

No APIs

Usage data comes from local provider CLIs, not remote quota services.

No credentials

The widget does not collect tokens, API keys, or provider account secrets.

Local detection

Codex, Claude Code, and Gemini are detected through platform-native CLI lookup.

Cross-platform

Tauri bundles target Windows, Ubuntu Desktop, and macOS.

What it gives you

Quota pressure at a glance

The tray icon follows the highest visible usage level, moving through green, yellow, orange, and red as consumption rises.

Sound alerts

Optional local chimes warn once when a visible provider crosses the 75% and 90% usage thresholds.

Manual update checks

Check GitHub Releases from the About panel and open the release page to download the installer that matches your platform.

Single instance

Launching the app again focuses the existing widget instead of creating duplicate windows and tray icons.

Tray recovery

A Center action brings the widget back to a visible monitor after docking, undocking, or display changes.

Readable timestamps

Footer and weekly reset labels include compact time and day information, so stale readings are easier to spot.

Alternatives / comparison

Tool Focus AI Usage Widget
CodexBar Codex status/menu bar Adds Claude Code and Gemini in one local desktop widget, with tray warnings.
ClaudeBar Claude status/menu bar Uses provider adapters so the UI, alerts, and scheduler are not tied to one CLI.
claude-usage-widget Claude usage widget Targets three providers, three desktop platforms, and local-first packaging.
ccusage CLI usage file analysis Shows current status in a floating widget with refresh and tray recovery controls.

Get started

npm ci
npm run tauri:dev

Install Node.js 20+, Rust, and at least one supported provider CLI for real data.