AIUsageTracker v0.4.1

AIUsageTracker v0.4.1

See Claude and Codex quotas in one Windows dashboard, with reset countdowns and per-window alerts.

What's changed

• The README now shows the installed application and links directly to the installer, portable ZIP and setup guide.
• Try the interface with AIUsageTracker.exe --demo. Example data stays in memory, without reading credentials, contacting providers or playing alerts.
• Settings and privacy documentation now explain polling delays, local token estimates and optional event hooks.
• Codex token scanning opens its SQLite database read-only. The mini overlay shows its current value immediately, and Activity filters are easier to read.
• Release packages include third-party notices. Original artwork, mockups and every screenshot review are preserved in the repository.

Downloads

Use AIUsageTracker_Setup_0.4.1.exe for a per-user installation, or extract AIUsageTracker-portable-v0.4.1.zip. The standalone EXE is also available. Compare file hashes with SHA256SUMS.txt.

Windows 10 or 11 is required. Live usage needs a signed-in Claude Code or Codex CLI installation; a browser login alone isn't enough.

The EXE and installer are unsigned. Windows or your organization's policy may warn about them. Don't disable security controls to install the app.

Verification

27 local tests pass. The source GUI, packaged executable and installed application were exercised with offline example data on a private Windows desktop. The installer was installed, byte checked and uninstalled. A check of the 19-package pinned runtime set found no known advisories at release time.

This pass didn't access live provider accounts or exercise actual sound playback, Windows toasts, tray interaction, webhooks, event commands, autostart or extra accounts. Alerts depend on confirmed responses and aren't guaranteed at the exact countdown boundary. Token totals are approximate.

See verification details and the setup and privacy guide.

v0.2.0 — brand logos, premium polish, alarm sounds

What's new in v0.2.0

• Brand logos — Claude (clay sunburst) and Codex (OpenAI hexafoil) tiles now identify each provider, plus a new app/tray mark. All rendered crisply at runtime.
• Selectable alarm sounds — choose from six built-in tones (Chime, Alert, Pulse, Bell, Siren, Arcade) in Settings, with a Test preview button.
• Premium polish pass — a proper design-token system (spacing, typography, radius, borders), card elevation, per-bar severity edges, refined summary + Settings screens, and clearer status/empty/error copy.
• Fix — usage rows no longer stretch to an oversized default height.

Privacy

AIUsageTracker reads the OAuth tokens your local Claude Code / Codex CLIs already store, and talks only to each provider's own usage endpoint. No credentials, tokens, email, or account IDs are ever transmitted elsewhere or committed to this repo.

Install

Download AIUsageTracker.exe below and run it (unsigned; SmartScreen → More info → Run anyway). Requires Claude Code and/or Codex CLI installed and logged in. Also runs from source — see the README.

v0.1.0

First release of AIUsageTracker — a Windows dashboard that monitors your Claude and Codex usage windows and alarms the instant a usage window resets.

Highlights

• Live usage bars for every Claude & Codex limit window (5-hour session, weekly, per-model), colored by severity.
• Reset alarm — looping audible tone + native Windows toast + in-app banner the moment a window resets.
• Per-bar alarm toggles — enable/disable the alarm independently for each usage window.
• Summary cards (highest usage, next reset, connections), a recent-activity feed, and a system-tray background mode.
• Reads the same numbers as claude.ai/settings/usage and the Codex analytics page by reusing the local Claude Code / Codex CLI OAuth tokens — no scraping, no passwords, no browser automation.

Install

Download AIUsageTracker.exe below and run it (unsigned; SmartScreen → More info → Run anyway). Requires Claude Code and/or Codex CLI installed and logged in.

Runs from source too — see the README.