[FEATURE] Built-in status line with rate limit usage bars
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:
- https://github.com/daniel3303/ClaudeCodeStatusLine
- https://github.com/sirmalloc/ccstatusline
- https://github.com/Owloops/claude-powerline
- https://github.com/levz0r/claude-code-statusline
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:
- Finding the script (Reddit, GitHub, etc.)
- Installing dependencies (
jq,curl) - Handling cross-platform differences (macOS BSD date vs GNU date, Windows Git Bash PATH issues)
- Managing OAuth token resolution across macOS Keychain, Linux credential files, and GNOME Keyring
- 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
- User installs Claude Code and opens a session
- The status line immediately shows:
Op4.6 | myproject@main | 22k/200k 11% | 5h ●●○○○ 38% @15:00 | 7d ●●●○○ 62% @6/3 07:00 - As the user works, they can see at a glance how much of their rate limit is consumed
- When approaching limits (bar turns orange/red), they can pace their usage or switch to a lighter model
- No setup, no scripts, no
jqinstallation — 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.
This issue has 10 comments on GitHub. Read the full discussion on GitHub ↗