claude-usage-monitor

Claude Code statusline plugin that shows your quota usage, context, tokens, and reset countdowns directly in the terminal.
No API keys. No telemetry. No dependencies. Runs locally.

Real-time usage tracking - green to yellow to red as your session progresses.

Quickstart

Windows PowerShell

irm https://raw.githubusercontent.com/aiedwardyi/claude-usage-monitor/v0.2.1/install.ps1 | iex

macOS / Linux

curl -fsSL https://raw.githubusercontent.com/aiedwardyi/claude-usage-monitor/v0.2.1/install.sh | bash

What you get

After install, restart Claude Code. Your statusline now shows:

◆ Opus │ my-project/main
▰▰▰▰▱ 75% │ ↑50k ↓12k │ 5h: ▰▰▰▰▱ 80% (1h) │ 7d: ▰▰▱▱▱ 34% │ 2m0s

• 5h / 7d quota - see how much is left before you hit limits
• Context % - see when you're running low before Claude tells you
• Token counts - input and output for the current session
• Reset countdown - know when your quota replenishes

Uses your existing Claude Code OAuth session. No extra API key or Python packages needed. Windows launches Python directly - no Git Bash requirement.

Prefer to audit first

git clone https://github.com/aiedwardyi/claude-usage-monitor.git
cd claude-usage-