Skip to content

TokenMonitor 1.0.0

Choose a tag to compare

View all tags
@TechPreacher TechPreacher released this 26 Aug 14:20
· 8 commits to main since this release
v1.0.0
ae74c6d

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/projects transcripts (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.

Assets 3
Loading