Releases: TechPreacher/TokenMonitor
Release list
TokenMonitor 1.1.0
What's new
Active Claude Code sessions with context-window gauges
The panel now lists every Claude Code session with recent transcript activity (last 5 minutes), each with a neon gauge showing how full its context window is (e.g. 533.9K / 1M tokens). Sessions are sorted by latest activity, background Agent SDK sessions (e.g. claude-mem helpers) are filtered out, and two parallel sessions in the same project are disambiguated with a short session id.
Live context windows from the Models API
Per-model context windows are fetched from the Anthropic Models API using your Claude Code OAuth credentials (1M for the Claude 5 family and Opus/Sonnet 4.6+, 200k for Haiku), with a built-in fallback table for offline use — new model launches get correct windows without an app update.
Panel improvements
- Panel height now auto-fits its content, growing and shrinking with the session list while staying anchored under the menu-bar icon
- Panel position is clamped on-screen when a menu-bar manager (Ice, Bartender) parks the status icon in an offscreen overflow row
Signed with Developer ID and notarized by Apple — download, unzip, and drag to Applications.
Full changes: #1
TokenMonitor 1.0.0
TokenMonitor 1.0.0
First release. A macOS menu-bar app showing Claude Code subscription usage and Anthropic API spend in a floating, pinnable cyberpunk "Neon HUD" panel.
Features
- Subscription usage — 5-hour session %, weekly %, and per-model weekly limits with reset countdowns
- Local token counts — parsed from
~/.claude/projectstranscripts (today + current 5h window) - API spend — month-to-date USD via the Anthropic Admin API (optional admin key, validated live in Settings, stored in Keychain)
- Pinnable panel — floats above all windows when pinned; closes on outside click when not
- Menu-bar native — no Dock icon; left-click opens the panel, right-click shows About/Quit
- Auto-refresh: local scan every 30 s, network every 60 s, exponential backoff on failures
Install
Download TokenMonitor.zip below, unzip, drag TokenMonitor.app to Applications. The app is signed with Developer ID and notarized by Apple — no Gatekeeper warnings.
First launch: allow access to the "Claude Code-credentials" Keychain item (Always Allow) so the app can read your Claude Code OAuth token.
Requirements
- macOS 15.0+
- Claude Code installed and logged in (for subscription usage)
Caveats
The subscription usage endpoint is undocumented and may change without notice; the app degrades gracefully to local transcript data if it breaks.