claude-code - 💡(How to fix) Fix [DOCS] Remote Control docs omit that claude.ai renames persist to the local CLI session title [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#48868Fetched 2026-04-16 06:48:44
View on GitHub
Comments
0
Participants
1
Timeline
3
Reactions
0
Author
Participants
Timeline (top)
labeled ×3

Root Cause

Add a short note to the Remote Control page stating that session title changes made from claude.ai/code or the Claude mobile app persist back to the local CLI session because both surfaces are controlling the same session.

RAW_BUFFERClick to expand / collapse

Documentation Type

Missing documentation (feature not documented)

Documentation Location

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

Section/Topic

"Work from both surfaces at once" and "Connect from another device" session naming behavior for Remote Control sessions

Current Documentation

The Remote Control page currently says:

  • Work from both surfaces at once: the conversation stays in sync across all connected devices, so you can send messages from your terminal, browser, and phone interchangeably

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

If you didn't set an explicit name, the title updates to reflect your prompt once you send one.

The session naming workflow page also says:

Sessions created by claude -p or SDK invocations do not appear in the picker, but you can still resume one by passing its session ID or custom name to claude --resume <session-id-or-name>. Custom names set with --name or /rename are accepted in addition to session IDs.

What's Wrong or Missing?

Changelog v2.1.110 includes:

Fixed Remote Control session renames from claude.ai not persisting the title to the local CLI session

The docs explain CLI-side naming (--name, /rename) and how a Remote Control session gets its initial title, but they do not explain that renaming the session from claude.ai/code updates the same underlying local CLI session title.

That leaves an important cross-surface behavior undocumented: a user can rename a Remote Control session in the web UI, and that rename should persist back to the local CLI session rather than staying web-only. The docs also do not say whether the renamed title becomes the local resumable session name.

Suggested Improvement

Add a short note to the Remote Control page stating that session title changes made from claude.ai/code or the Claude mobile app persist back to the local CLI session because both surfaces are controlling the same session.

Suggested content outline:

  • Under the Remote Control naming section, clarify that renames from the web/mobile UI update the local session title as well.
  • State that the updated title is the session name Claude Code uses locally (prompt bar, resume flows, and other name-based session references).
  • In the general session naming docs, add a cross-reference noting that Remote Control sessions can also be renamed from claude.ai/code, not only with --name and /rename.

Impact

Medium - Makes feature difficult to understand

Additional Context

Affected Pages:

PageContext
https://code.claude.com/docs/en/remote-controlRemote Control cross-device sync and session title behavior
https://code.claude.com/docs/en/common-workflowsSession naming and claude --resume <name> behavior
https://code.claude.com/docs/en/commands/rename command reference
https://code.claude.com/docs/en/cli-reference--name, --remote-control, and resume-by-name flags

Total scope: 4 pages affected

Source: Changelog v2.1.110

Exact changelog entry: Fixed Remote Control session renames from claude.ai not persisting the title to the local CLI session

extent analysis

TL;DR

Update the Remote Control documentation to clarify that session title changes made from the web or mobile UI persist back to the local CLI session.

Guidance

  • Add a note to the Remote Control page explaining that renames from the web/mobile UI update the local session title.
  • Specify that the updated title is used as the session name in the local CLI for prompts, resume flows, and other name-based references.
  • Consider adding a cross-reference in the general session naming documentation to mention that Remote Control sessions can be renamed from claude.ai/code, in addition to using --name and /rename.
  • Review the affected pages (Remote Control, common workflows, commands, and CLI reference) to ensure consistency in documenting session naming behavior.

Example

No code snippet is necessary for this documentation update, but an example of the added note could be:

"Note: Renaming a Remote Control session from the web or mobile UI will also update the title in your local CLI session, ensuring consistency across all surfaces."

Notes

The suggested improvement aims to clarify the cross-surface behavior of Remote Control session renaming, addressing a medium-impact issue that makes the feature difficult to understand. The update should be applied to four affected pages to ensure comprehensive documentation.

Recommendation

Apply the suggested documentation workaround to improve user understanding of Remote Control session naming behavior, as it directly addresses the identified issue and enhances the overall documentation clarity.

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