claude-code - 💡(How to fix) Fix [DOCS] PR review status docs omit immediate footer refresh after in-session PR commands [1 participants]

Documentation Type

Incorrect/outdated documentation

Documentation Location

https://code.claude.com/docs/en/interactive-mode

Section/Topic

PR review status section

Current Documentation

The docs currently say:

When working on a branch with an open pull request, Claude Code displays a clickable PR link in the footer (for example, "PR #446"). The link has a colored underline indicating the review state:

• Green: approved
• Yellow: pending review
• Red: changes requested
• Gray: draft
• Purple: merged

Cmd+click (Mac) or Ctrl+click (Windows/Linux) the link to open the pull request in your browser. The status updates automatically every 60 seconds.

Related workflow docs also say:

When you create a PR using gh pr create, the session is automatically linked to that PR. To return to it later, run claude --from-pr <number> or paste the PR URL into the /resume picker search.

What's Wrong or Missing?

As of changelog v2.1.145, Claude Code updates the footer PR badge immediately after gh pr create and other in-session commands that change PR state. The current docs only describe the 60-second automatic refresh, so they leave readers with an outdated mental model that the footer badge waits for the polling interval even after Claude just changed PR state in the same session.

Suggested Improvement

Update the PR review status documentation to distinguish between the background refresh cadence and immediate refresh triggers.

For example, revise the timing note to say that the badge still refreshes automatically every 60 seconds, but also refreshes immediately after in-session commands that create or change the current branch's pull request state, such as gh pr create.

Impact

Medium - Makes feature difficult to understand

Additional Context

Affected Pages:

Total scope: 2 pages affected

Version context: changelog v2.1.145 says the PR badge in the footer now updates immediately after gh pr create and other PR-state-changing commands run in-session.