Expose plan usage limits in status line JSON data

Resolved 💬 3 comments Opened Mar 13, 2026 by russiannaked Closed Mar 17, 2026

Feature Request

Is your feature request related to a problem?

The /usage command shows subscription plan limits (e.g. the 5-hour rolling window cap on Team plans), but this data is not available in the status line JSON schema. Users on Team/Max plans who customize their status line cannot display remaining quota or usage percentage against their plan limit.

Describe the solution you'd like

Add plan/subscription usage fields to the status line JSON, for example:

  • plan.type — subscription tier (Free/Pro/Team/Max)
  • plan.usage_limit — rolling window cap (e.g. "5h")
  • plan.usage_used — time/tokens consumed in current window
  • plan.usage_remaining — remaining quota
  • plan.reset_at — when the rolling window resets

This would allow status line scripts to display something like:

Opus | Context: 12% | Cost: $0.42 | Limit: 2h15m / 5h

Describe alternatives you've considered

  • Using /usage manually — works but requires interrupting workflow
  • Parsing /usage output in a script — not possible, it's a UI dialog

Additional context

The status line already exposes session-level cost and token data. Adding plan-level usage would make it a complete dashboard for power users who monitor their quota.

🤖 Generated with Claude Code

View original on GitHub ↗

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