LaunchKit · 2026
Back to Skills

claude-usage-checker

AI & LLMsv1.3.0

Check Claude Code / Claude Max usage limits.

0
580 downloads
by @aligurelli

Setup & Installation

openclaw skills install @aligurelli/claude-usage-checker

Or with the ClawHub CLI, for registry-managed skill folders outside a full OpenClaw workspace:

npx clawhub install claude-usage-checker

Version History

v1.3.0Feb 19, 2026 - Version note by skill developer:

Removed auto-install: claude CLI is a prerequisite, not auto-installed.

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

Here's how your AI assistant might use this skill in practice.

INPUT

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

AGENT
  1. 1Launch claude CLI with PTY
  2. 2Wait for welcome screen to load
  3. 3Send /usage command and poll for output
  4. 4Parse usage percentages and reset times for each category
  5. 5Exit 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

Accounts, API keys, or tools you or your AI assistant may need to set up while using this skill.

Claude CLI installed (npm i -g @anthropic-ai/claude-code)Claude Max or Claude Code subscription with active login