AI Usage

Claude Code and Codex quotas — usage, limits, and reset countdowns at a glance.

A tiny always-on-top Windows widget with tray & taskbar mini-gauges and animated character themes.

Always on your taskbar — mini gauges beside the tray, columns aligned by quota type

Pick your companion

Twelve themes — Default plus eleven animated companions — switchable instantly from Settings. The picker and this gallery use the same character groups.

General

Default

VOCALOID

Hatsune Miku

Violet Evergarden

Violet

SPY×FAMILY

Anya & Bond

Gintama

Kagura	Elizabeth

Umamusume: Pretty Derby

Bourbon (Valentine)	Rice Shower (Halloween)	Oguri Cap (Christmas)
Nice Nature (RUN&WIN)	Maruzensky (Summer Night)	Curren Chan (Wedding)

_{Every tile is the widget itself, showing the same sample readout under each theme's frame and animation. The gallery is rebuilt from the current runtime theme packs; source and output hashes are recorded in the gallery manifest.}

Features

• Live quota tracking — Claude (5h session, weekly, per-model weekly, extra credits) and Codex (weekly), each with a usage bar and reset countdown
• Three ways to watch
  • Widget — always on top, drag to move, remembers its position, adjustable opacity and layout, — minimizes to tray
  • Tray icon — dual mini gauges with a tooltip summary; double-click toggles the widget
  • Taskbar gauges (optional) — always visible beside the tray, columns aligned by quota type, auto-hidden during fullscreen apps
• Threshold colors — configurable warning levels (yellow 70% / red 90% by default) and a LIMIT badge when a quota is exhausted
• Used ↔ remaining — click the USED % / LEFT % chip; horizontal or vertical layout
• Character themes — grouped by series in Settings and switchable without a restart
• Runs itself — start with Windows, automatic token refresh, login auto-detection, and recovery after an explorer restart

Getting started

Requirements: Windows 10/11 · .NET 8 Desktop Runtime (not needed for self-contained builds) · a logged-in Claude Code CLI (~/.claude/.credentials.json) and/or Codex CLI (~/.codex/auth.json)

cd QuotaDeck
dotnet run -c Release             # run it

# single-file executable
dotnet publish -c Release -r win-x64 --self-contained false /p:PublishSingleFile=true
# bundle the runtime too (no .NET install required)
dotnet publish -c Release -r win-x64 --self-contained true /p:PublishSingleFile=true

Output: QuotaDeck\bin\Release\net8.0-windows\win-x64\publish\QuotaDeck.exe

Usage

Action	How
Move the widget	Drag anywhere (position is saved)
Used ↔ remaining	Click the USED % / LEFT % chip in the header
Open the official usage page	Click a service name
Menu	Right-click the widget — refresh · layout · settings · hide · quit
Start with Windows	Settings → "Start with Windows" (enable it from the published exe)
Taskbar gauges	Settings → "Show mini gauges in the taskbar"

How it works

• Claude — api.anthropic.com/api/oauth/usage, reusing Claude Code's OAuth token; expired tokens are refreshed and written back to the credential file atomically.
• Codex — chatgpt.com/backend-api/wham/usage, reusing the Codex CLI's OAuth token, falling back to the rate_limits snapshots in ~/.codex/sessions when the API is unreachable.
• Both endpoints are undocumented internal APIs and may change without notice, so every field is parsed defensively. Credentials are never deleted or sent anywhere else.
• Settings live in %APPDATA%\QuotaDeck\settings.json.

License

• Code: MIT
• Character theme assets are not covered by the MIT license and remain subject to their rights holders' terms:
  • This work depicts Crypton Future Media, INC.'s character Hatsune Miku under the Piapro Character License (PCL). Hatsune Miku © Crypton Future Media, INC. www.piapro.net
  • Umamusume: Pretty Derby — Mihono Bourbon, Rice Shower, Oguri Cap, Nice Nature, Maruzensky, and Curren Chan; © Cygames, Inc., Umamusume derivative works guidelines
  • Violet Evergarden — © Kana Akatsuki / Kyoto Animation (non-commercial fan content)
  • SPY×FAMILY (Anya & Bond) — © Tatsuya Endo / Shueisha, SPY×FAMILY Project (non-commercial fan content)
  • Gintama (Kagura, Elizabeth) — © Hideaki Sorachi / Shueisha (non-commercial fan content)