back to /projects

claude-usage-taskbar

local-first ai coding usage monitor - Lightweight tray app and floating widget that surfaces ai coding-agent usage — percentages, token totals, reset windows, and burn-rate forecasts. Local-only telemetry; no prompt content, credentials, or dashboard scraping.

fig 1 — dashboard, usage + forecasts
commits
28
contributors
1

a small desktop app for keeping an eye on how much ai coding-agent capacity you have left, without any of the usual telemetry trade-offs. it reads local statusline data and on-disk session logs, then renders the same numbers you'd see on a provider dashboard — but locally, in a tray icon and a floating widget you can park on any monitor.

what's in the box

  • a tauri + react desktop app (desktop/) with a rust backend, sqlite history, and a rust statusline sidecar for claude code.
  • the original python tray app (claude_usage_tray.py) still ships alongside the tauri build for parity validation and rollback.
  • provider adapters that translate each safe local data source into a shared usage model — totals for session / today / week / all, availability flags, and a small config note the dashboard surfaces when a provider isn't set up yet.

design notes

the hard rule for adapters is no credential reads, no dashboard scraping, no prompt or response content, and no logging of private paths. anything that wants network access or auth is a separate opt-in feature behind an explicit toggle.

forecasts are estimates unless the underlying statusline message carries a real rate-limit signal — the ui labels them that way so they aren't mistaken for ground truth. session timeline spikes are based on local token deltas, not message content.

why this exists

You shouldn't need to scrape a dashboard or log into a portal to know how close you are to your next rate-limit reset.

what's in the box

  • system tray icon + floating widget (full, compact, minimal)
  • claude code statusline capture with local log fallback
  • optional opt-in codex cli session tracking
  • rolling charts, burn-rate forecasts, timeline spike detection
  • pluggable provider adapters behind a rust backend

built with

taurirustreacttypescriptpythonsqlite