AI Usage Tracker

A small Windows desktop robot that shows your current Claude Code and Codex CLI usage limits at a glance. Windows only.

Requirements

• Windows 10/11
• Logged-in CLIs: claude auth login and codex login

Install

• Portable — run LimitUsageRobot.exe (self-contained, no .NET install needed).
• Installer — AIUsageTracker-Setup.exe (Start-menu shortcut, uninstall entry, optional autostart).

Usage

• Click the robot to slide the panel out or in; drag it to reposition.
• Tray icon: quick values, manual refresh, show/hide.
• Gear icon → settings: language (English/Polski, applied instantly), robot animations, CLI paths.
• Auto-refresh every 1 / 5 / 15 / 30 min. Alerts at 80% (amber) and 95% (red), once per reset cycle.
• The account email is blurred by default — click the badge to reveal it.

Privacy

Uses your existing local Claude and Codex sessions. Tokens are read into memory only for the request — never written to settings, cache, logs, or the UI. Settings and the limits cache live in %LOCALAPPDATA%\LimitUsageRobot\.

Build

dotnet test .\LimitUsageRobot.slnx -c Release
dotnet publish .\src\LimitUsageRobot.App\LimitUsageRobot.App.csproj -c Release -r win-x64 --self-contained true -o .\publish
iscc .\installer\AIUsageTracker.iss   # optional installer, requires Inno Setup 6 (ISCC on PATH)