[DOCS] Status line docs outdated about context-low warning location

Documentation Type

Incorrect/outdated documentation

Documentation Location

https://code.claude.com/docs/en/statusline

Section/Topic

"Notifications share the status line row"

Current Documentation

The docs currently say:

Notifications share the status line row System notifications like MCP server errors, auto-updates, and token warnings display on the right side of the same row as your status line Enabling verbose mode adds a token counter to this area * On narrow terminals, these notifications may truncate your status line output

What's Wrong or Missing?

Claude Code v2.1.97 changed the context-low warning UI: it now shows as a transient footer notification instead of a persistent row item.

That makes the current status line documentation outdated. The page still tells users that token warnings display on the same row as the status line, which no longer matches the documented low-context warning behavior from the v2.1.97 changelog.

Users reading the status line docs to understand why their custom status line is being truncated or displaced can come away with the wrong mental model about where this warning appears.

Suggested Improvement

Update the "Notifications share the status line row" section to distinguish the context-low warning from notifications that still occupy the status line row.

Suggested minimum fix:

The context-low warning appears as a transient footer notification rather than a persistent status-line-row item.

If other notifications such as MCP server errors or auto-update notices still share the status line row, keep those documented separately so the page reflects the current UI accurately.

Impact

Medium - Makes feature difficult to understand

Additional Context

Affected Pages:

| Page | Context |
|------|---------|
| https://code.claude.com/docs/en/statusline | The troubleshooting section still says token warnings display on the same row as the status line, which conflicts with the v2.1.97 context-low warning UI change |

Total scope: 1 page affected

Source: Changelog v2.1.97

Exact changelog entry:

Improved context-low warning to show as a transient footer notification instead of a persistent row