Claude Quota Checker

How much Claude do you have LEFT?

Most tools tell you how much you spent. This one tells you how much you have remaining — the question that actually matters when you're working and worried about hitting limits.

Checks your Claude Max/Pro subscription quota by automating the /usage command via tmux. No API keys needed, no Admin keys, no complex setup.

How It Works

Creates a temporary tmux session with a scratch git repo
Launches Claude Code CLI
Handles the "trust this folder" prompt automatically
Sends /usage command
Captures and parses the output
Cleans up tmux session

Usage

bash ./scripts/check-usage.sh

Note: Run from the skill directory, or use the full path based on where you installed this skill. The script auto-detects its own location.

Output

Plan type: Pro or Max (e.g., "Opus 4.6 — Claude Max")
Session usage: current session % used
Weekly usage: all models % and Sonnet-only %
Reset time: when the weekly quota resets

Error Handling

| Problem | Symptom | Fix | |---------|---------|-----| | tmux not installed | command not found: tmux | brew install tmux | | Claude CLI not in PATH | Session hangs | Install Claude Code CLI, ensure claude is in PATH | | Auth expired | "Please log in" in output | Run claude manually and re-authenticate | | Git not installed | Script fails at git init | brew install git |

If the script hangs for >15 seconds, it likely means Claude CLI couldn't start. Kill with: tmux kill-session -t cu-*

Requirements

macOS or Linux
tmux installed
claude CLI in PATH
Active Claude Code authentication (Pro or Max subscription)
git installed (for scratch repo)

Performance

~8-10 seconds (bottleneck: Claude Code CLI startup time).

Limitations

Only checks subscription usage (Pro/Max), not API billing
Requires a running terminal environment (won't work in sandboxed containers)
Output parsing depends on Claude Code CLI's /usage format — may break if Anthropic changes the output layout