Community Tool: cc-token-status — macOS menu bar usage dashboard

Resolved 💬 2 comments Opened Apr 9, 2026 by jayson-jia-dev Closed Apr 12, 2026

Hi! I built a free open-source tool that might be useful for Claude Code users:

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:

  • Plan usage limits — live 5h session & 7d weekly quotas with progress bars from Anthropic API
  • Cost & token overview — API-equivalent cost with accurate per-model pricing (Opus 4.5/4.6 at $5/$25)
  • 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 showing 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 — checks GitHub daily, silently downloads new versions
  • 5 languages — EN, 中文, ES, FR, 日本語 — auto-detected from system
  • Dark & light mode — adapts to macOS appearance

Install (one-liner):

curl -fsSL https://raw.githubusercontent.com/jayson-jia-dev/cc-token-status/main/install.sh | bash

<p align="center">
<img src="https://raw.githubusercontent.com/jayson-jia-dev/cc-token-status/main/.github/screenshot-en.png" width="350" />
<img src="https://raw.githubusercontent.com/jayson-jia-dev/cc-token-status/main/.github/screenshot-zh.png" width="350" />
</p>

GitHub: https://github.com/jayson-jia-dev/cc-token-status

Happy to hear any feedback! ⭐

View original on GitHub ↗

This issue has 2 comments on GitHub. Read the full discussion on GitHub ↗