[DOCS] Status line docs missing workspace trust requirement

Documentation Type

Missing documentation (feature not documented)

Documentation Location

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

Section/Topic

The status line page overall, specifically the troubleshooting/behavior section. The page documents when the status line hides (autocomplete, help menu, permission prompts) but does not mention workspace trust as a prerequisite.

Current Documentation

The status line page documents the feature setup, configuration, and several conditions where the status line hides. The troubleshooting section mentions slow scripts blocking the status line. No mention of workspace trust appears anywhere on the page.

The settings page notes that disableAllHooks disables the custom status line, but similarly omits the workspace trust requirement.

What's Wrong or Missing?

Changelog v2.1.79 fixed "custom status line showing nothing when workspace trust is blocking it." This reveals that workspace trust acceptance is a prerequisite for the status line to function. Prior to this fix, users who configured a statusLine without accepting workspace trust for the directory would see a blank status line with no explanation. Even after the fix (which presumably now shows a meaningful fallback), the docs should explain this dependency so users understand why their status line might not run.

A security fix in v2.1.51 noted that statusLine commands could execute without workspace trust acceptance, confirming that workspace trust intentionally gates the status line — but this constraint was never documented.

Suggested Improvement

Add a note to the status line page under the setup or troubleshooting section:

Note: The custom status line requires workspace trust to be accepted for the current directory. If workspace trust has not been accepted, the status line command will not execute. Accept workspace trust when prompted on first launch in a directory.

Also consider adding a troubleshooting entry:

Status line shows nothing: Verify that you have accepted workspace trust for the current directory. The status line command only runs in trusted workspaces.

Impact

Medium - Makes feature difficult to understand

Additional Context

Affected Pages:

| Page | Context |
|------|---------|
| https://code.claude.com/docs/en/statusline | Primary status line documentation; no mention of workspace trust |
| https://code.claude.com/docs/en/settings | statusLine setting description; no workspace trust note |

Total scope: 2 pages affected

Source: Changelog v2.1.79

Fixed custom status line showing nothing when workspace trust is blocking it