claude-code - 💡(How to fix) Fix [DOCS] Remote Control docs omit session card repo, branch, and working directory details [1 participants]

Official PRs (…)
ON THIS PAGE

Recommended Tools

×6

Utilities matched from this issue’s tags and category — try them while you read without losing context.

GitHub issue graph ai analysis

Paste a GitHub issue URL. We fetch that issue, discover linked issues from bodies/comments/timeline, collect linked pull requests, and produce a structured English report.

The report is written in English Markdown for sharing and archival.

Helpful · Quick feedback

Loading…
GitHub stats
anthropics/claude-code#45479Fetched 2026-04-09 08:04:28
View on GitHub
Comments
0
Participants
1
Timeline
2
Reactions
0
Author
Participants
Timeline (top)
labeled ×2
RAW_BUFFERClick to expand / collapse

Documentation Type

Missing documentation (feature not documented)

Documentation Location

https://code.claude.com/docs/en/remote-control

Section/Topic

"Connect from another device" and the claude.ai/code session list behavior for Remote Control sessions

Current Documentation

The Remote Control docs currently say:

  • Open claude.ai/code or the Claude app and find the session by name in the session list. Remote Control sessions show a computer icon with a green status dot when online.

The remote session title is chosen in this order:

  1. The name you passed to --name, --remote-control, or /remote-control
  2. The title you set with /rename
  3. The last meaningful message in existing conversation history
  4. An auto-generated name like myhost-graceful-unicorn, where myhost is your machine's hostname or the prefix you set with --remote-control-session-name-prefix

The Claude Code on the web docs currently say:

Sessions appear in the sidebar at claude.ai/code. From there you can review changes, share with teammates, archive finished work, or delete sessions permanently.

Neither page mentions that bridge/Remote Control session cards now show the local git repository, branch, and working directory.

What's Wrong or Missing?

Changelog v2.1.97 says: "Improved Bridge sessions to show the local git repo, branch, and working directory on the claude.ai session card."

The current documentation explains how to identify a Remote Control session by its title and online indicator, but it does not mention this new claude.ai/code session card metadata. That leaves a user-visible discovery aid undocumented, especially for people juggling multiple bridge sessions with similar titles or auto-generated names.

Suggested Improvement

Add a short note to the Remote Control page's "Connect from another device" section explaining that claude.ai/code session cards for bridge/Remote Control sessions now show:

  • the local git repository
  • the current branch
  • the local working directory

Explain that these fields help users distinguish between multiple local sessions before opening one.

If the same sidebar card UI is shared across other session-management docs, add a matching note to the Claude Code on the web "Work with sessions" section.

Impact

Medium - Makes feature difficult to understand

Additional Context

Affected Pages:

PageContext
https://code.claude.com/docs/en/remote-controlPrimary documentation for bridge/Remote Control sessions and how to find them in the claude.ai/code session list
https://code.claude.com/docs/en/claude-code-on-the-webShared claude.ai/code session-list/sidebar behavior under "Work with sessions"

Total scope: 2 pages affected

Source: Changelog v2.1.97

Changelog entry: Improved Bridge sessions to show the local git repo, branch, and working directory on the claude.ai session card

extent analysis

TL;DR

Update the Remote Control documentation to include information about the local git repository, branch, and working directory displayed on claude.ai/code session cards for bridge/Remote Control sessions.

Guidance

  • Review the current documentation for Remote Control and Claude Code on the web to identify areas where the new session card metadata can be mentioned.
  • Add a note to the "Connect from another device" section of the Remote Control page explaining the new fields and their purpose in distinguishing between multiple local sessions.
  • Consider updating the Claude Code on the web "Work with sessions" section if the same sidebar card UI is used, to maintain consistency across documentation.
  • Verify the changes by checking the updated documentation and ensuring that the new information is accurately reflected.

Example

No code snippet is necessary for this documentation update, but an example of the updated text could be: "The claude.ai/code session cards for bridge/Remote Control sessions now display the local git repository, branch, and working directory, making it easier to identify and distinguish between multiple sessions."

Notes

The update should be applied to the two affected pages: https://code.claude.com/docs/en/remote-control and potentially https://code.claude.com/docs/en/claude-code-on-the-web.

Recommendation

Apply workaround: Update the documentation to reflect the new features and improvements mentioned in Changelog v2.1.97, specifically the display of local git repository, branch, and working directory on claude.ai/code session cards for bridge/Remote Control sessions. This will improve the usability and understanding of the feature for users.

Vote matrix · Quick signals

Works
Did the solution work? Tap to confirm.
Easy Fix
Was it a quick fix?
Time Saver
Did it save you time?
Blocking
Was it severely blocking?
Common Issue
Are others likely hitting this too?
Flaky / Intermittent
Is it intermittent?
Verified / Reproducible
Can you reproduce it reliably?
Loading…

Still need to ship something?

×6

Another batch ranked right after the header list — different links, same matching logic.

Back to top recommendations

TRENDING