Add weekly usage and reset times to statusline JSON data
Resolved 💬 3 comments Opened Jan 28, 2026 by AspiringPolyglot Closed Feb 1, 2026
Feature Request
Currently, the statusline script receives JSON data that includes context window usage (context_window.used_percentage), but it does not include:
- Session usage percentage - the current session's quota usage
- Session reset time - when the current session quota resets
- Weekly usage percentage - visible in
/status→ Usage tab - Weekly reset time - when the weekly quota resets
Use Case
Users who configure custom statuslines (via PowerShell, bash, etc.) want to display their quota usage at a glance without having to open the /status menu. This is especially useful for users on usage-limited plans who need to monitor their consumption.
Current Behavior
The statusline JSON includes:
{
"context_window": {
"used_percentage": 11,
"remaining_percentage": 89
}
}
Requested Behavior
Add usage quota information to the statusline JSON:
{
"usage": {
"session": {
"percent_used": 15,
"resets_at": "2025-01-28T18:00:00Z"
},
"weekly": {
"percent_used": 42,
"resets_at": "2025-02-03T00:00:00Z"
}
}
}
This would allow statusline scripts to display something like:
Opus 4.5 | MyProject | Context: 11% | Session Usage: 15% (resets 18:00:00) | Weekly Usage: 42% (resets Mon 00:00:00)
Thank you!
This issue has 3 comments on GitHub. Read the full discussion on GitHub ↗