ai-usage
by bshandley
Coding Agents & IDEsBrief
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
User asks: what's my Anthropic quota usage this week?
- 1
Reads OAuth token from ~/.claude/.credentials.json
- 2
Refreshes the token if expired by invoking Claude Code once
- 3
Calls GET https://api.anthropic.com/api/oauth/usage for live quota data
- 4
Parses OpenClaw session logs for per-model token and cost counts
- 5
Prints a formatted report with utilization gauges and a reset countdown
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-usageRun the CLI command, or paste the prompt into Claude Code, Cursor, Codex or whichever coding agent you use.