cc-token-status

cc-token-status

**Claude Code usage dashboard in your macOS menu bar.**

Costs, plan limits, trends, user level — all in one click. No app to install, no server to run, just a single Python script.

  

Features

Feature	Description
Plan Usage Limits	Live 5h session & 7d weekly quotas with progress bars from Anthropic API
Cost & Token Overview	API-equivalent cost, session count, total tokens
Subscription ROI	How much your Pro/Max/Team plan saves vs API pricing
User Level	🌑→🌒→🌓→🌔→🌕→👑 cultivation rank based on multi-dimension scoring
Today at a Glance	Today's spending, tokens, and message count
Daily Details	Full cost history (newest first, older dates expandable)
Model Breakdown	Per-model usage (Opus / Sonnet / Haiku) with percentages
Hourly Activity	Sparkline charts: ▅▇██▇▄ shows which hours you're most active
Project Ranking	Which projects consume the most tokens
Multi-Machine Sync	iCloud Drive auto-sync across Macs — zero config
Usage Alerts	macOS notifications at 80% and 95% plan limits
Settings Menu	Toggle notifications, auto-update, launch at login, switch plan
Auto-Update	SHA256-verified updates from GitHub, checks daily
Incremental Scan	Caches JSONL parse results, skips unchanged files for instant refresh
Error Hints	Friendly status messages when OAuth token missing or API unreachable
5 Languages	EN, 中文, ES, FR, 日本語 — auto-detected from system
Dark & Light Mode	Adapts color scheme to macOS appearance

User Level System

Multi-dimension scoring based on your Claude Code usage maturity:

🌑 Lv.1  Starter      练气期
🌒 Lv.2  Planner      筑基期
🌓 Lv.3  Engineer     金丹期
🌔 Lv.4  Integrator   元婴期
🌕 Lv.5  Architect    化神期
👑 Lv.6  Orchestrator 大乘期

Scored across 5 dimensions (100 points total):

...