Feature Request: Add promotional/promo status to statusline JSON data

Resolved 💬 3 comments Opened Mar 25, 2026 by satthewmoon Closed Apr 26, 2026

Summary

When Claude Code sends JSON data to the statusLine command, it would be helpful to include information about active promotional periods (e.g., 2x usage limits during off-peak hours).

Current Behavior

The rate_limits object in the statusline JSON only includes:

"rate_limits": {
  "five_hour": {
    "used_percentage": 6,
    "resets_at": 1774458000
  },
  "seven_day": {
    "used_percentage": 17,
    "resets_at": 1774922400
  }
}

There is no way to determine whether a promotional period is currently active from this data alone, since only percentages (not absolute limits) are provided.

Requested Behavior

Add promo/promotional status to the JSON, for example:

"rate_limits": {
  "five_hour": {
    "used_percentage": 6,
    "resets_at": 1774458000,
    "promo": {
      "active": true,
      "multiplier": 2,
      "label": "2X Off-Peak"
    }
  }
}

Or at minimum, expose the absolute limit so users can infer promotional periods:

"five_hour": {
  "used_percentage": 6,
  "limit_tokens": 2000000,
  "resets_at": 1774458000
}

Use Case

Users who customize their statusLine command want to display promotional status in their status bar (e.g., 2X Promo indicator) to know when they have extra capacity available. Without this data in the JSON, it is impossible to detect promotional periods programmatically.

Environment

  • Claude Code version: 2.1.83
  • Platform: WSL2 / Linux

View original on GitHub ↗

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