Feature Request: Include /usage percentages (Session %, Week %) in statusline JSON payload
Resolved 💬 1 comment Opened Dec 19, 2025 by ccn-noh-siyoung Closed Dec 19, 2025
Feature Request
Summary
Please include the usage percentages displayed by the /usage command in the statusline JSON payload.
Current Behavior
The statusline JSON payload currently includes:
cost.total_cost_usd- Session cost in USDcontext_window.current_usage.*- Token counts for context window
However, it does not include:
- Current session usage percentage
- Current week usage percentage
These percentages are only visible via the /usage command.
Requested Behavior
Add the following fields to the statusline JSON payload:
{
"usage": {
"session_percent": 25,
"week_percent": 63
}
}
Or alternatively:
{
"usage": {
"session": {
"used": 12500000,
"limit": 50000000,
"percent": 25
},
"week": {
"used": 315000000,
"limit": 500000000,
"percent": 63
}
}
}
Use Case
Many users create custom statusline scripts to monitor their Claude Code usage in real-time. Having access to the session and weekly usage percentages would allow users to:
- Monitor usage limits - Avoid hitting rate limits unexpectedly
- Budget awareness - Track usage against daily/weekly quotas
- Better planning - Make informed decisions about when to use different models
Example Statusline Output
With this feature, users could display:
🤖 Opus 4.5 ⎇ main 🧠 72% ⚡ Session 25% 📅 Week 63%
Environment
- Claude Code CLI
- Statusline feature with custom bash scripts
Thank you for considering this feature request!
This issue has 1 comment on GitHub. Read the full discussion on GitHub ↗