// readme

CCU - Claude Code Usage Monitor

A performant terminal dashboard for monitoring Claude Code usage, built in Go using the Charm family of packages (Bubbletea, Lipgloss, Bubbles).

Features

  • Live Claude API Usage Data - Near real-time usage stats from Anthropic’s servers with exact reset times
  • 5-Hour Session Tracking: Monitor rolling 5-hour usage windows with OAuth utilisation percentage (Pro and Max5; Ultra has no session limit)
  • Weekly Limits: Track 7-day rolling usage overall, plus a separate bar for each model Anthropic applies an individual weekly limit to
  • Real-time Dashboard: Live updating terminal UI with colour-coded progress bars
  • Burn Rate Monitoring: Dual burn rate display - tokens/minute and cost/hour with visual indicators
  • Intelligent Predictions: Cost depletion time with colour-coded warnings (red if before reset, orange if close, green if safe)
  • Plan Support: Pro, Max5, Ultra (formerly Max20)
  • Setup-Token Support: ccu statusline captures plan usage from Claude Code’s status line for CLAUDE_CODE_OAUTH_TOKEN users, who can’t use the OAuth usage API
  • Automatic Fallback: Uses OAuth when available, then status line…