Feature Request: Add plan/rate limit usage to status line JSON

Resolved 💬 3 comments Opened Jan 16, 2026 by rubenheymans-amexio Closed Jan 20, 2026

Summary

Expose plan usage percentage (rate limit) in the status line JSON data, similar to how context_window.used_percentage is already exposed.

Motivation

When using a custom status line script, I want to display how much of my rate limit I've used before it resets. This information is already visible via /usage, but it's not available in the status line JSON.

This is arguably more important than context window usage because:

  • Context window resets every conversation
  • Rate limit affects your ability to work across all sessions
  • Knowing you're at 80% rate limit helps you pace your work

Current behavior

The status line JSON includes:

{
  "context_window": {
    "used_percentage": 66,
    "remaining_percentage": 34,
    ...
  },
  "cost": {
    "total_cost_usd": 39.62,
    ...
  }
}

Requested behavior

Add a usage_limits or plan object:

{
  "usage_limits": {
    "used_percentage": 76,
    "remaining_percentage": 24,
    "resets_in_seconds": 6000,
    "resets_at": "2025-01-16T17:00:00Z"
  }
}

Use case

Custom status line showing plan usage with color coding (green/yellow/red) to help users monitor their rate limit at a glance, without needing to run /usage.

Environment

  • Claude Code version: 2.1.9
  • OS: macOS

View original on GitHub ↗

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