Add rate limit information to statusline data
Feature Request
Summary
Expose rate limit information (5-hour and weekly limits) to custom statusline scripts so users can display their usage status in the status bar.
Current Behavior
The statusline script receives useful data like:
- Context window usage
- Total tokens (input/output)
- Cost information
- Session details
However, rate limit information is only shown via popup notifications when limits are approaching or exceeded.
Requested Enhancement
Please add rate limit data to the JSON input provided to custom statusline scripts:
{
"rate_limits": {
"five_hour": {
"limit": 1000,
"used": 450,
"remaining": 550,
"resets_at": "2026-01-14T18:30:00Z"
},
"weekly": {
"limit": 5000,
"used": 2100,
"remaining": 2900,
"resets_at": "2026-01-20T00:00:00Z"
}
}
}
Use Case
Users want to proactively monitor their rate limit usage in the status bar (similar to how people on Reddit show comprehensive status information). This helps:
- Plan work sessions around rate limits
- Avoid unexpected interruptions
- Better understand usage patterns
- Make informed decisions about when to work on complex tasks
Example Status Bar Output
With this data available, users could display:
[Sonnet 4.5] Context: 87,662/200,000 (43%) | 5hr: 450/1000 (resets in 2:15) | Week: 2,100/5,000 (resets Mon)
Related
This would complement the existing popup notifications while providing persistent visibility into rate limit status.
Thank you for considering this enhancement!
This issue has 3 comments on GitHub. Read the full discussion on GitHub ↗