[DOCS] Agent view docs omit footer PR-badge hyperlink behavior and the `FORCE_HYPERLINK=0` opt-out

Documentation Type

Missing documentation (feature not documented)

Documentation Location

https://code.claude.com/docs/en/agent-view

Section/Topic

The Pull request status section describing the #1234 footer label and the terminal hyperlink requirements.

Current Documentation

The agent-view page currently says:

When a session opens a pull request, a #1234 label appears at the right edge of the row, linked to the pull request in terminals that support hyperlinks.

The statusline page describes clickable links generally as follows:

Links: use OSC 8 escape sequences to make text clickable (Cmd+click on macOS, Ctrl+click on Windows/Linux). Requires a terminal that supports hyperlinks like iTerm2, Kitty, or WezTerm.

The environment-variable reference documents FORCE_HYPERLINK as enabling clickable OSC 8 hyperlinks when support is not auto-detected, or disabling them with 0, but the agent-view PR-badge section does not connect that setting to the footer badge.

What's Wrong or Missing?

Claude Code v2.1.217 improves footer PR-badge links so they are clickable even when terminal support cannot be detected, including over SSH or tmux. It also adds FORCE_HYPERLINK=0 as an opt-out.

The current agent-view wording limits the link description to terminals that “support hyperlinks” and does not explain the detection fallback or the opt-out. A user whose terminal can render OSC 8 but is not recognized cannot tell from the PR-badge documentation why the badge is or is not clickable, nor where to disable the behavior.

Suggested Improvement

Update Pull request status to explain that, as of Claude Code v2.1.217, the footer PR badge is emitted as a clickable hyperlink even when terminal support is not auto-detected, with the usual terminal and transport caveats for OSC 8 sequences. Add a direct link to the FORCE_HYPERLINK environment-variable entry and state that FORCE_HYPERLINK=0 disables the clickable-link behavior.

Also add a short note to the environment-variable or terminal-configuration documentation identifying the footer PR badge as one of the affected link surfaces, so users can discover the setting without starting from agent view.

Impact

Medium - Makes feature difficult to understand

Additional Context

Affected Pages:

| Page | Line(s) | Context |
|------|---------|---------|
| https://code.claude.com/docs/en/agent-view | 148-154 | Pull request status and the footer PR label's hyperlink description |
| https://code.claude.com/docs/en/statusline | 155-160, 202 | General OSC 8 link behavior and the PR badge data surface |
| https://code.claude.com/docs/en/env-vars | 377 | FORCE_HYPERLINK values and terminal auto-detection override |

Total scope: 3 pages should describe the same footer PR-badge link behavior and opt-out.

The relevant release is Claude Code v2.1.217. The release entry is listed in the Claude Code changelog under version 2.1.217.