[FEATURE] Show usage window reset countdown in CLI status line
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
Summary
The Claude Code CLI status line shows usage percentages (e.g. 5h: 64% | 7d: 32%) but does not show when the current usage window resets. The Claude web app shows this as "Resets in 2h 16m" — the CLI has no
equivalent.
## Current behaviour
Status line displays:
ctx: 54% | 5h: 64% | 7d: 32% | $7.54
No indication of when the 5h or 7d window resets.
## Expected behaviour
ctx: 54% | 5h: 64% (resets in 1h 52m) | 7d: 32% | $7.54
Or as a separate field:
ctx: 54% | 5h: 64% | 7d: 32% | $7.54 | reset: 1h 52m
## Why
When usage is high, knowing the reset time helps decide whether to wait or continue. The web app already exposes this — the CLI should too.
## Workaround attempted
Tried to build a script that detects when 5h% drops to ~0% and starts a 5-hour countdown from that timestamp. Blocked because the 5h% value is not accessible programmatically — it is only visible in the
interactive terminal status line and not exposed via any CLI command or JSON output.
Proposed Solution
Suggestion
Either:
- Add the reset timestamp to the status line natively
- Expose raw usage data (tokens used, window start time) via
claude --output-format=jsonor aclaude /usagecommand so users can build their own tooling
Alternative Solutions
_No response_
Priority
High - Significant impact on productivity
Feature Category
CLI commands and flags
Use Case Example
_No response_
Additional Context
_No response_
This issue has 3 comments on GitHub. Read the full discussion on GitHub ↗