claude-usage-checker
by aligurelli
AI & LLMsBrief
Check Claude Code / Claude Max usage limits.
Description
What This Skill Does
Launches the Claude CLI interactively via PTY and reads the /usage command output to report Claude Code and Claude Max quota. Shows session usage, weekly token consumption by model, and extra usage spending with reset times.
Automates the manual steps of launching the Claude CLI, running /usage, and reading the output, returning a formatted table without switching terminals.
When to Use It
- Checking remaining quota before starting a long coding session
- Verifying weekly usage before hitting a model limit
- Monitoring extra usage spending against a dollar budget
- Confirming when weekly or session quota resets
- Comparing Sonnet-specific usage against total weekly consumption
Example Workflow
User asks: How much Claude usage do I have left this week?
- 1
Launch claude CLI with PTY
- 2
Wait for welcome screen to load
- 3
Send /usage command and poll for output
- 4
Parse usage percentages and reset times for each category
- 5
Exit the CLI and return a formatted table
Table with current session, weekly (all models), weekly (Sonnet only), and extra usage rows, each showing percentage used and reset time
Requirements
- Claude CLI installed (npm i -g @anthropic-ai/claude-code)
- Claude Max or Claude Code subscription with active login
Installation
clawhub install aligurelli/claude-usage-checkerRun the CLI command, or paste the prompt into Claude Code, Cursor, Codex or whichever coding agent you use.