Limit Monitor

What It Does

Monitor your Claude usage limits in a unified view. Get proactive notifications before hitting limits. Make informed decisions about which product to use based on current capacity.

Claude Pro, Max, and Team plans have shared usage limits across all products. All three consume from the same rolling 5-hour window, but with different weights:

• Chat: Baseline consumption (1x)
• Claude Code: ~5x heavier (large system prompts, file contexts)
• Cowork: ~10x heavier (multi-step tasks, extended execution)

Features

• ✅ Unified tracking — Single view across all three products
• ✅ Weighted usage — Accounts for different consumption rates
• ✅ Proactive notifications — Alerts at 80%, 90%, 95% thresholds
• ✅ CLI stats tool — Quick status checks from terminal
• ✅ Rolling window — Accurate reset time predictions
• ✅ Cross-platform — Linux, Windows, macOS support
• ✅ Lightweight — ~8MB RAM, minimal CPU
• ✅ Persistent state — Survives daemon restarts

Quick Start

Requirements: Python 3.11+, psutil package, Claude Desktop and/or Claude Code installed

Installation:

1. Install dependencies: pip3 install psutil
2. Copy scripts to your CLAUDE_HOME directory
3. Configure unified-limit-monitor.conf with your plan
4. Test manually: python3 scripts/claude-limit-daemon.py
5. Install as service (systemd on Linux, NSSM on Windows)

Usage

CLI Tool:

claude-stats              # Current status
claude-stats json        # JSON output for scripting
claude-stats reset       # Reset time only

Example output:

Claude Usage Monitor
────────────────────────────────────────
Plan: PRO
Rolling Window (5hr): 32.0/45 (71%)
│████████████████░░░░│

Breakdown:
  Chat     12 events  (12.0 units)
  Code      3 sessions (15.0 units)
  Cowork    1 task     (5.0 units)
────────────────────────────────────────
Total:              16 events  (32.0 units)
Next reset: 2h 15m