What problem does it solve?
This Skill answers whether your Claude Code session is currently allowed, warning, or rejected by reporting real session-quota usage for the 5-hour and 7-day windows.
Core Features & Use Cases
- Quota probe using Anthropic rate-limit headers: Reads
anthropic-ratelimit-unified-* response headers via a minimal 1-token request, matching what Claude Code’s statusline reports.
- Cached, low-cost repeated checks: Caches the probe result for 60 seconds to avoid unnecessary calls, with a
--force option to bypass the cache.
- Structured output for automation: Emits machine-readable lines (
remaining_pct, reset_ts) before a human summary, supporting both manual questions and auto-engineer quota gating.
- Fallback estimation when probing fails: Uses
ccusage to estimate blocks and remaining time when the direct probe cannot retrieve headers, clearly labeling results as estimated.
Quick Start
Run the command bash .claude/skills/usage/probe.sh to get your current 5h and 7d quota utilization, reset times, and status.