Support new rate_limits field for accurate usage display

[ChrisOr-Dev]

Feature Request

Claude Code 2.1.80 introduced a new /usage status dialog that exposes rate_limits data. This provides accurate usage information that claude-hud could leverage for its usage display.

Available Data

The new rate_limits field provides:

• 5-hour window: used_percentage + resets_at
• 7-day window: used_percentage + resets_at

Current Behavior

claude-hud (v0.0.10) has display.showUsage but doesn't yet integrate with this new rate limits API.

Proposed Enhancement

Use the rate_limits data to display real-time usage info in the HUD, e.g.:

5h: 25% (resets 14:30) | 7d: 10% (resets Mon)

Or with bar style (usageBarEnabled: true):

██░░░░░░░░ 25% (1h 30m / 5h) | 7d: 10%

This would give users at-a-glance visibility into their rate limit consumption without needing to run /usage manually.

[Astro-Han]

I've been working with the rate_limits field since 2.1.80 landed. A few implementation notes that might save you time:

• used_percentage comes as a float (e.g. 7.000000000000001), needs flooring before any arithmetic
• resets_at is a Unix timestamp, not ISO 8601 like the /usage API returns
• The field is null/absent until the first model response in a session, so you need a guard for the initial state
• Only present for Claude.ai subscribers, not API-key users

I implemented this in a Bash statusline script if useful as a reference for the field handling: https://github.com/Astro-Han/claude-lens

[miguelmanlyx]

Hey, that looks like a anthropic rate limit failure. Maybe run npx ai-doctor. It usually helps surface the failure point.