Feature Request: Display usage statistics in CLI terminal
Problem
Currently, Claude Pro users can only see their usage statistics (message limits, rate limits, time until reset) by opening https://claude.ai/settings/usage in a web browser. When working extensively in Claude Code CLI, this creates friction:
- Users hit rate limits unexpectedly without warning
- No way to monitor remaining quota from terminal
- Need to constantly switch to browser to check usage
- Cannot proactively manage conversation length to avoid hitting limits
Today I hit the rate limit and had to wait for reset. If I could see the usage percentage in the terminal, I would manage my session more efficiently.
Proposed Solution
Add usage statistics display in Claude Code CLI, similar to what's available on the web interface:
Option 1: Status line integration
- Display current usage percentage in status line
- Show time until limit reset
- Update in real-time during session
Option 2: CLI command
- Add
/usageor/limitscommand - Show messages used/remaining
- Display countdown to next reset
Option 3: Automatic warnings
- Warning when reaching 50%, 75%, 90% of limits
- Proactive notification before hitting rate limit
Benefits
- Better resource management during long CLI sessions
- Reduced frustration from unexpected limit hits
- No need to switch between terminal and browser
- Improved UX for power users who work primarily in CLI
Current Workaround
Opening https://claude.ai/settings/usage in browser, which breaks CLI workflow.
Additional Context
The /cost command exists but only shows "$0" for Pro subscribers with message "no need to monitor cost". However, we still need to monitor rate limits and usage quotas, which are separate from billing concerns.
This issue has 3 comments on GitHub. Read the full discussion on GitHub ↗