[FEATURE] Built-in status line with rate limit usage bars

Resolved 💬 10 comments Opened Mar 3, 2026 by ch4ngo88 Closed May 23, 2026

Preflight Checklist

  • [x] I have searched existing requests and this feature hasn't been requested yet
  • [x] This is a single feature request (not multiple features)

Problem Statement

Currently, users have to discover, install, and configure third-party scripts to see their rate limit usage in the status line. This is critical information that every Pro/Max user wants at a glance.

The fact that so many community projects exist for this proves the demand:

External scripts need to handle OAuth token resolution, caching, cross-platform date parsing, and tool availability (e.g. jq missing on Windows/Git Bash) — this complexity belongs in the core product.

Proposed Solution

A built-in default status line showing:

  • Model name (compact, e.g. Op4.6 / So4.6)
  • Working directory + git branch
  • Token usage — current/total with percentage (e.g. 22k/200k 11%)
  • 5-hour and 7-day rate limit bars with color coding (green → yellow → orange → red) and compact reset times
  • Extended thinking status
  • Extra usage credits (if enabled)

Essentially what the community projects above already do — but built into Claude Code as the default experience, with no setup required.

Alternative Solutions

The current workaround is using the statusLine.command setting with a custom bash script. This works but requires:

  1. Finding the script (Reddit, GitHub, etc.)
  2. Installing dependencies (jq, curl)
  3. Handling cross-platform differences (macOS BSD date vs GNU date, Windows Git Bash PATH issues)
  4. Managing OAuth token resolution across macOS Keychain, Linux credential files, and GNOME Keyring
  5. Implementing caching to avoid API rate limits on the usage endpoint itself

All of this is doable but fragile — every user reinvents the same wheel.

Priority

Medium - Would be very helpful

Feature Category

Interactive mode (TUI)

Use Case Example

  1. User installs Claude Code and opens a session
  2. The status line immediately shows: Op4.6 | myproject@main | 22k/200k 11% | 5h ●●○○○ 38% @15:00 | 7d ●●●○○ 62% @6/3 07:00
  3. As the user works, they can see at a glance how much of their rate limit is consumed
  4. When approaching limits (bar turns orange/red), they can pace their usage or switch to a lighter model
  5. No setup, no scripts, no jq installation — it just works

Additional Context

The usage data is already available via https://api.anthropic.com/api/oauth/usage and Claude Code already has the OAuth token internally. The only missing piece is rendering it in the status line by default.

A reference implementation (cross-platform bash script handling all edge cases) is available and battle-tested on both macOS and Windows/Git Bash.

View original on GitHub ↗

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