Skip to content
TakoAPI
Back to skills

ai-usage

by bshandley

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

Brief

Check AI usage across Anthropic and other providers.

Description

What This Skill Does

Checks AI token usage and quota across Anthropic and other providers. Reads live quota data from Anthropic's OAuth API using Claude Code's credentials, and parses OpenClaw session logs for per-model token and cost stats from any routed provider.

It pulls real quota percentages directly from Anthropic's OAuth API rather than estimating from logs, so weekly and rolling-window numbers reflect actual limits.

When to Use It

  • Checking remaining Anthropic quota before starting a long task
  • Reviewing end-of-month spending across AI providers
  • Running a daily background heartbeat on token consumption
  • Identifying which models have been called most this week
  • Feeding usage data into a cron job or dashboard via JSON output

Example Workflow

INPUT

User asks: what's my Anthropic quota usage this week?

AGENT
  1. 1

    Reads OAuth token from ~/.claude/.credentials.json

  2. 2

    Refreshes the token if expired by invoking Claude Code once

  3. 3

    Calls GET https://api.anthropic.com/api/oauth/usage for live quota data

  4. 4

    Parses OpenClaw session logs for per-model token and cost counts

  5. 5

    Prints a formatted report with utilization gauges and a reset countdown

OUTPUT

Console report showing weekly utilization %, 5-hour rolling window %, model-specific breakdowns for Sonnet and Opus, and token/cost stats from any other detected providers

Requirements

  • Claude Code installed and authenticated (claude CLI in PATH with valid credentials)

Installation

clawhub install bshandley/ai-usage

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

Links