AI Usage Check
name: ai-usage
by bshandley · published 2026-03-22
$ claw add gh:bshandley/bshandley-ai-usage---
name: ai-usage
description: |
Check AI usage across Anthropic and other providers.
Use when:
1. User asks about AI usage, token usage, or quota
2. User says "what's my AI usage" or "how much have I used"
3. User asks about Anthropic/Claude usage or limits
4. User asks about costs or spending on AI
5. Monitoring usage during heartbeats (daily check)
---
# AI Usage Check
Quick Start
python3 scripts/usage_check.py # Pretty report with gauges
python3 scripts/usage_check.py --json # JSON output for scriptingRequirements
What It Shows
**Anthropic (real quota from OAuth API):**
**Other Providers (from OpenClaw session logs):**
**OpenClaw Anthropic breakdown:**
How It Works
Environment Variables
| Variable | Default | Description |
|----------|---------|-------------|
| `OPENCLAW_SESSIONS_DIR` | `~/.openclaw/agents/main/sessions` | OpenClaw session log directory |
| `CLAUDE_CREDENTIALS_PATH` | `~/.claude/.credentials.json` | Claude Code credentials file |
Tips
More tools from the same signal band
Order food/drinks (点餐) on an Android device paired as an OpenClaw node. Uses in-app menu and cart; add goods, view cart, submit order (demo, no real payment).
Sign plugins, rotate agent credentials without losing identity, and publicly attest to plugin behavior with verifiable claims and authenticated transfers.
The philosophical layer for AI agents. Maps behavior to Spinoza's 48 affects, calculates persistence scores, and generates geometric self-reports. Give your...