[FEATURE] Setting to suppress built-in token/usage warning notifications in statusline
Problem
When using a custom statusLine command, Claude Code still overlays system notifications (like "You've used X% of your weekly limit") on the right side of the same row. For users who already display usage data in their custom statusline, this creates redundant information that clutters the status bar.
The statusline docs confirm this behavior:
"System notifications like MCP server errors, auto-updates, and token warnings display on the right side of the same row as your status line."
Proposed Solution
Add a setting to suppress specific notification categories from the statusline overlay. For example:
{
"statusLine": {
"type": "command",
"command": "~/.claude/statusline.sh",
"suppressNotifications": ["token_warnings"]
}
}
Or a simpler boolean:
{
"statusLine": {
"type": "command",
"command": "~/.claude/statusline.sh",
"suppressTokenWarnings": true
}
}
Why
The custom statusline API is excellent — it gives full control over what's displayed. But the built-in notification overlay can't be suppressed, which means custom statuslines that already show usage data (5-hour and weekly percentages, reset times, etc.) end up with duplicate information competing for the same row space.
Users who have invested in building rich custom statuslines should be able to opt out of the built-in warnings they've already accounted for.
Environment
- Claude Code version: 2.1.52
- OS: macOS (Darwin arm64)
- Plan: Max
This issue has 7 comments on GitHub. Read the full discussion on GitHub ↗