Setup & Installation
Or with the ClawHub CLI, for registry-managed skill folders outside a full OpenClaw workspace:
Version History
Added session refresh reminder system: self-scheduling cron chain that notifies exactly when 5-hour quota resets. Minimal API calls, zero maintenance. Includes comparison docs for both reminder and polling methods.
What This Skill Does
Queries the Anthropic OAuth API to display Claude Code usage against 5-hour session and 7-day weekly rate limits. Supports text and JSON output, configurable caching, and automated reset notifications via cron.
The Claude Code CLI does not expose quota details directly, so this is the only way to see exact utilization percentages and reset timings without guessing.
When to use it
- Checking remaining session quota before starting a long coding task
- Avoiding rate limit surprises mid-project
- Displaying usage percentage in a terminal statusline
- Getting notified when a 5-hour session quota resets
- Piping quota data as JSON into monitoring scripts
Example Workflow
Here's how your AI assistant might use this skill in practice.
User asks: How much Claude Code usage do I have left?
- 1Retrieves OAuth token from the system keychain
- 2Queries api.anthropic.com/api/oauth/usage with the token
- 3Parses five_hour and seven_day utilization metrics
- 4Calculates time remaining until each quota resets
- 5Renders progress bars and color-coded status indicators
Session (5h): 40% used, resets in 2h 15m. Weekly (7d): 60% used, resets in 3d 8h.
Requirements
Accounts, API keys, or tools you or your AI assistant may need to set up while using this skill.