From father-time
Check real rate limit usage from the Anthropic API — session (5-hour), weekly, and Opus utilization. Use when asking about rate limits, pacing, token usage, "how much runway do I have", "should I keep working", "am I burning too fast", "will I hit my limit", or wanting a forecast of remaining subscription budget.
How this skill is triggered — by the user, by Claude, or both
Slash command
/father-time:pace-checkThe summary Claude sees in its skill listing — used to decide when to auto-load this skill
Show the user their real rate limit usage from the Anthropic API.
Show the user their real rate limit usage from the Anthropic API.
Run the usage check script:
python "${CLAUDE_PLUGIN_ROOT}/scripts/usage_check.py"
To force a fresh fetch (bypass cache):
python "${CLAUDE_PLUGIN_ROOT}/scripts/usage_check.py" --refresh
For structured output (programmatic consumption):
python "${CLAUDE_PLUGIN_ROOT}/scripts/usage_check.py" --format json
Run python "${CLAUDE_PLUGIN_ROOT}/scripts/usage_check.py" --help for the full flag and exit-code reference.
Results are cached for 5 minutes to avoid API rate limits. The output shows whether data is live or cached.
This fetches real utilization data from api.anthropic.com/api/oauth/usage using the user's OAuth token. It returns:
Present the script output clearly. Add context based on the numbers:
Rate Limits:
Session (5h): [bar] XX% — resets in Xh Xm
Weekly (7d): [bar] XX% — resets in Xd Xh
Opus (7d): [bar] XX% — resets in Xd Xh
Peak status: [PEAK / OFF-PEAK]
[Recommendation based on current usage]
| Session % | Status | Advice |
|---|---|---|
| < 30% | Comfortable | Work freely |
| 30-60% | Moderate | Monitor, consider lighter work |
| 60-80% | High | Conserve — switch to Sonnet for routine tasks |
| 80%+ | Critical | Expect throttling soon, wait or do light work |
| Weekly % | Status | Advice |
|---|---|---|
| < 50% | Fine | No concerns |
| 50-80% | Watch it | Pace over remaining days |
| 80%+ | Tight | Conserve until reset |
/model sonnet) — uses fewer tokensxhigh effort, consider stepping down to high or medium via /effort — xhigh burns significantly more tokens per turn/compact to reduce context sizeIf the script fails with "No OAuth token found", the user needs to be logged into Claude Code. Never make the user anxious — frame it as helpful info, not a countdown clock.
npx claudepluginhub afterrealm/father-time --plugin father-timeReports rate-limited 5-hour windows from cached timeline data to GitHub Discussions. Use when hitting Claude rate limits to contribute data for reverse-engineering Anthropic's formula.
Displays real token usage and estimated savings for current Claude Code session from session logs—no AI estimation. Invoke via `/genshijin-stats` for session stats, `--all` lifetime totals, `--share` summaries, or `--since` periods.
Analyzes Claude Code token usage and cost trends over daily/weekly/monthly periods, computes metrics like averages, peak days, trend direction, and monthly projections, with per-project filtering.