v0.3.1

What's Changed

• Auto-detect Claude plan from keychain by @Priyans-hu in #5
• Remove legacy Tauri/JS code by @Priyans-hu in #6
• Add GitHub Actions CI and release workflow by @Priyans-hu in #7
• Add Homebrew cask support by @Priyans-hu in #8
• Add community files and LLM helper docs by @Priyans-hu in #9
• Fix range picker label rendering vertically by @Priyans-hu in #10
• Add landing page by @Priyans-hu in #11
• Add star prompt to README and install script by @Priyans-hu in #12
• Fix repeated keychain prompts during session by @Priyans-hu in #13

Full Changelog: v0.3.0...v0.3.1

v0.3.0

What's New

• Real rate limits — fetches actual utilization from Anthropic API via Claude Code's OAuth token (Keychain)
• Rate limit notifications — macOS alerts when session or weekly usage hits 80%
• Usage heatmap — hour-by-day activity grid with 7/14/30 day range
• Hover details — token breakdown (input/output) shown on hover over rate limit bars
• App icon — new icon for the app bundle
• Pricing fixes — corrected Opus 4.5 ($5/$25/MTok) and Haiku ($1/$5/MTok) pricing
• Request deduplication — prevents 2-3x token inflation from multi-line JSONL entries
• Fallback mode — local JSONL estimates when Keychain/API unavailable

Install

curl -fsSL https://raw.githubusercontent.com/Priyans-hu/tokenmeter/main/install.sh | bash

Or download the zip below and extract TokenMeter.app to /Applications.

On first launch, macOS will ask to access "Claude Code-credentials" in your keychain — enter your Mac password and click "Always Allow".

v0.2.0

What's New

Rate Limits

• Weekly rate limit window (7-day) alongside the existing 5-hour session window
• Pace indicator — shows if you're Behind/On Track/Ahead of your token consumption rate

UI Redesign

• Cleaner vertical layout (CodexBar-inspired) — less cramped, more breathing room
• Session + Weekly rate limit bars with progress percentage and reset time
• Cost section as vertical list rows with token count alongside cost
• Dynamic window height — compact when loading, expands to fit content

Quick Links

• Usage Dashboard → opens Anthropic console
• Status Page → opens status.anthropic.com
• Both accessible from dashboard and tray right-click menu

Auto-Update Check

• Checks GitHub releases on startup for newer versions
• Shows a dismissable update banner with link to download

Vibrancy Fix

• Switched to HudWindow material for consistent dark frosted glass appearance

Download

curl -fsSL https://raw.githubusercontent.com/Priyans-hu/tokenmeter/main/install.sh | bash

Or download TokenMeter-v0.2.0-macos-aarch64.zip below.

v0.1.0 — Initial Release

TokenMeter v0.1.0

macOS menu bar app for Claude Code token usage visualization.

Features

• System tray app (no dock icon)
• Native macOS vibrancy (frosted glass popover)
• 5-hour context window tracker with progress bar, token count, active sessions, reset timer
• Cost summary: today / this week / this month
• Daily cost bar chart (7/14/30 day range)
• Model breakdown donut chart (Opus, Sonnet, Haiku)
• Auto-refresh every 5 minutes (configurable)
• Click outside to close, single instance enforcement
• Cached data persists across app restarts

Install

Quick install:

curl -fsSL https://raw.githubusercontent.com/Priyans-hu/tokenmeter/main/install.sh | bash

Manual:

1. Download TokenMeter-v0.1.0-macos-aarch64.zip below
2. Extract and move TokenMeter.app to /Applications
3. Right-click → Open (first launch, to bypass Gatekeeper)

Prerequisites

• macOS (Apple Silicon)
• ccusage: npm install -g ccusage
• Claude Code installed and used