Add rate limit information to statusline data

Resolved 💬 3 comments Opened Jan 14, 2026 by klauskaan Closed Feb 28, 2026

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!

View original on GitHub ↗

This issue has 3 comments on GitHub. Read the full discussion on GitHub ↗