Skip to content
TakoAPI
Back to skills

claude-usage-checker

by aligurelli

AI & LLMs
580Downloads reported by clawskills.sh
0Views
0 likesSign in to like this skill
—Not yet rated
Your rating

Brief

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

INPUT

User asks: How much Claude usage do I have left this week?

AGENT
  1. 1

    Launch claude CLI with PTY

  2. 2

    Wait for welcome screen to load

  3. 3

    Send /usage command and poll for output

  4. 4

    Parse usage percentages and reset times for each category

  5. 5

    Exit the CLI and return a formatted table

OUTPUT

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-checker

Run the CLI command, or paste the prompt into Claude Code, Cursor, Codex or whichever coding agent you use.

Links