ReddRadar
Agent skill
quota-tracker
Track Claude Code quota usage via Anthropic API rate limit headers. Shows 5h and 7d utilization, reset times, and quota status. Works with both subscription and API key auth.
Install this agent skill to your Project
npx add-skill https://github.com/sonichi/sutando/tree/main/skills/quota-tracker
SKILL.md
Quota Tracker
Monitor your Claude Code quota in real time by intercepting Anthropic API rate limit headers.
When to Use
- "How much quota do I have left?"
- "Am I close to the rate limit?"
- "When does my quota reset?"
- Before starting expensive tasks
How It Works
A credential proxy sits between Claude Code and the Anthropic API. It reads anthropic-ratelimit-unified-* headers from every API response and writes quota state to a JSON file.
Quick Check
# Read current quota state
cat quota-state.json
Output includes:
anthropic-ratelimit-unified-5h-utilization— % of 5-hour window usedanthropic-ratelimit-unified-7d-utilization— % of 7-day window usedanthropic-ratelimit-unified-5h-reset— when the 5h window resets (epoch)anthropic-ratelimit-unified-7d-reset— when the 7d window resets (epoch)anthropic-ratelimit-unified-status— "allowed" or "rejected"
Setup
1. Start the credential proxy
npx tsx "$SKILL_DIR/scripts/credential-proxy.ts"
This starts on port 7846 and reads OAuth credentials from macOS keychain.
2. Route Claude Code through the proxy
ANTHROPIC_BASE_URL=http://localhost:7846 claude ...
Or add to your voice agent's launchd plist:
<key>ANTHROPIC_BASE_URL</key>
<string>http://localhost:7846</string>
3. Read quota state
python3 "$SKILL_DIR/scripts/read-quota.py" # human readable
python3 "$SKILL_DIR/scripts/read-quota.py" --json # machine readable
python3 "$SKILL_DIR/scripts/read-quota.py" --gate # exit 1 if exhausted
Requirements
- macOS (reads OAuth from keychain)
- Claude Code logged in (subscription or API key)
- Node.js with tsx
Recommended Agent Skills
Expand your agent's capabilities with these related and highly-rated skills.
sonichi/sutando
x-twitter
Post tweets, search, read mentions, and check engagement on X (Twitter) via API v2.
sonichi/sutando
schedule-crons
sonichi/sutando
claude-codex
Use the local Codex CLI from Claude Code with the user's existing Codex login or API key. Use for Codex reviews, second-opinion analysis, implementation delegation, or non-interactive Codex runs in the current workspace.
sonichi/sutando
phone-conversation
Make conversational phone calls and join Zoom meetings via Twilio + Gemini. Multi-turn AI conversations on the phone on behalf of the user.
sonichi/sutando
screen-record
sonichi/sutando
proactive-loop
Start Sutando's autonomous proactive loop. Monitors tasks, runs health checks, and builds missing capabilities on a recurring schedule.
Didn't find tool you were looking for?