Skip to content
TakoAPI
Back to skills

claude-usage

by lemodigital

Coding Agents & IDEs
685Downloads reported by clawskills.sh
0Views
0 likesSign in to like this skill
—Not yet rated
Your rating

Brief

Calculate Claude Max subscription usage from OpenClaw session data.

Description

What This Skill Does

Calculates Claude Max subscription usage from OpenClaw session data using a reverse-engineered credits formula. Shows weekly budget consumption, 5-hour rate limit window status, and per-session token breakdowns across Opus, Sonnet, and Haiku models.

Exposes the actual credits math behind Claude Max plans so you can see real consumption before hitting an unexpected rate limit.

When to Use It

  • Checking how much weekly budget remains before hitting limits
  • Identifying which sessions consumed the most credits
  • Monitoring the 5-hour sliding window before rate limiting
  • Comparing credit usage across Pro, 5x, and 20x plans
  • Getting a per-model token breakdown for a specific session

Example Workflow

INPUT

User asks: how much of my weekly Claude budget have I used?

AGENT
  1. 1

    Run claude-usage.py with saved config to fetch session JSONL data

  2. 2

    Calculate credits consumed per session using the input/output token rates for each model

  3. 3

    Sum credits across all sessions in the current weekly window

  4. 4

    Compare total against the plan budget and render a progress bar

  5. 5

    Check the 5-hour sliding window and flag if approaching the rate limit

OUTPUT

Weekly summary showing 12,400,000 / 41,666,700 credits used (29%), 5-hour window at 18%, and top sessions ranked by consumption

Requirements

  • Claude Max subscription (Pro $20, 5x $100, or 20x $200)
  • Weekly reset time from claude.ai Settings > Usage

Installation

clawhub install lemodigital/claude-usage

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

Links