Predicting when Claude Code will cut you off

What it does

claude-monitor is a terminal dashboard that tracks Claude Code token consumption, message count, and running cost in real time. It renders color-coded progress bars and tables via Rich, and forecasts whether your current session will hit its limit before you finish. The tool supports Claude Pro, Max5, and Max20 tiers, plus a default Custom plan that adapts to your personal usage history.

The interesting bit

The Custom plan analyzes your last eight days of sessions to calculate a P90-based limit tailored to your actual workflow, which the project bills as ML-based prediction. It also auto-detects your terminal background to pick a WCAG-compliant color scheme, which is a nice touch for a tool whose primary job is to tell you that you’re spending too much money.

Key highlights

• ML-based predictions (P90 percentile) for session limit detection and cost forecasting
• Real-time display refresh up to 20 Hz with configurable data polling
• Automatic plan detection and personalized limits based on 192 hours of usage history
• Daily and monthly aggregated views beyond the live dashboard
• Persistent preferences (theme, timezone, refresh rates) stored locally

Caveats

• The README never explains how the tool reads Claude Code usage data; the “auto-detection” mechanism is a black box.
• Token limits for the Pro tier are listed as both 19,000 and 44,000 in different sections, so the exact plan boundaries are unclear.

Verdict

Grab it if you live in Claude Code for hours and have been burned by sudden usage caps. Ignore it if you don’t use Claude Code or already have your own spending alerts set up.