claude-code - 💡(How to fix) Fix [FEATURE] Remote Control session resume is undiscoverable in the CLI [2 comments, 2 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#56294Fetched 2026-05-06 06:31:56
View on GitHub
Comments
2
Participants
2
Timeline
5
Reactions
0
Timeline (top)
labeled ×3commented ×2
RAW_BUFFERClick to expand / collapse

Preflight Checklist

  • I have searched existing requests and this feature hasn't been requested yet
  • This is a single feature request (not multiple features)

Problem Statement

Summary

Resuming a previously-active Remote Control (RC) session — so a phone client can reconnect to the existing conversation — is currently undiscoverable. The interactive --resume picker silently hides RC sessions, the working command isn't documented, and the underlying flag is hidden from --help. A user who has had a phone session disconnect (network drop, laptop sleep, server timeout) has no obvious path back to their conversation.

Steps that fail

  1. claude --resume → picker shows local-terminal sessions only. RC sessions are absent with no explanation.
  2. claude --remote-control --resume → same picker as #1. The --remote-control flag does not change which sessions are listed.
  3. claude --help → the --remote-control flag itself is hidden (only --remote-control-session-name-prefix appears), so a user can't even confirm the flag exists from --help.
  4. From the phone client, when the server has died, there's no "reconnect to your last session" affordance — the user has to know to go to their Mac and restart something.

What actually works (undocumented)

claude --remote-control --resume <uuid-of-prior-rc-session>

Where <uuid> has to be hunted manually: ls -lt ~/.claude/projects/<encoded-project-path>/*.jsonl

…and identified by inspecting the .jsonl contents. There's no in-CLI affordance for finding the right UUID for an RC session.

Proposed Solution

Suggested improvements (any of these would help)

  1. Show RC sessions in --resume pickers, perhaps with an [RC] tag, so the user can pick one without manual UUID lookup. Or add a separate --resume-rc / --resume --remote-control filter that actually filters to RC sessions.
  2. Document --remote-control --resume (or whatever the canonical resume-RC command is) in the Remote Control docs. Today the docs imply RC sessions can't be resumed at all.
  3. Surface --remote-control in claude --help.
  4. Phone-side "reconnect to last session" — when the phone client can't reach the server, offer a clear path that triggers the right command on the paired machine.
  5. At minimum: when claude --resume filters out RC sessions, print a one-line hint like "N Remote Control sessions hidden. Use claude --remote-control --resume <uuid> to resume one."

Environment

  • macOS
  • Claude Code 2.1.128

Alternative Solutions

No response

Priority

Medium - Would be very helpful

Feature Category

CLI commands and flags

Use Case Example

No response

Additional Context

I think this is self-explanatory. My remote-control sessions die all the time and I need an easier way of restarting the correct session.

extent analysis

TL;DR

The most likely fix is to modify the --resume picker to show Remote Control (RC) sessions, and document the --remote-control --resume command.

Guidance

  • Modify the claude --resume picker to include RC sessions, possibly with an [RC] tag, to allow users to select and resume RC sessions without manual UUID lookup.
  • Document the --remote-control --resume command in the Remote Control documentation to provide a clear path for resuming RC sessions.
  • Consider adding a separate --resume-rc filter to simplify the process of resuming RC sessions.
  • Update claude --help to surface the --remote-control flag, making it easier for users to discover the available options.

Example

No code snippet is provided as the issue focuses on CLI command and flag improvements rather than code changes.

Notes

The proposed solution involves modifying the existing CLI commands and documentation to improve the user experience for resuming Remote Control sessions. The exact implementation details may vary depending on the underlying codebase and development priorities.

Recommendation

Apply workaround: Modify the --resume picker and document the --remote-control --resume command to provide a clear and user-friendly way to resume Remote Control sessions. This approach addresses the primary issue and provides a more discoverable solution 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

claude-code - 💡(How to fix) Fix [FEATURE] Remote Control session resume is undiscoverable in the CLI [2 comments, 2 participants]