[FEATURE] Remote Control session resume is undiscoverable in the CLI
Preflight Checklist
- [x] I have searched existing requests and this feature hasn't been requested yet
- [x] 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
claude --resume→ picker shows local-terminal sessions only. RC sessions are absent with no explanation.claude --remote-control --resume→ same picker as #1. The--remote-controlflag does not change which sessions are listed.claude --help→ the--remote-controlflag itself is hidden (only--remote-control-session-name-prefixappears), so a user can't even confirm the flag exists from--help.- 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)
- Show RC sessions in
--resumepickers, perhaps with an[RC]tag, so the user can pick one without manual UUID lookup. Or add a separate--resume-rc/--resume --remote-controlfilter that actually filters to RC sessions. - 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. - Surface
--remote-controlinclaude --help. - 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.
- At minimum: when
claude --resumefilters out RC sessions, print a one-line hint like "N Remote Control sessions hidden. Useclaude --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.
6 Comments
Found 3 possible duplicate issues:
This issue will be automatically closed as a duplicate in 3 days.
🤖 Generated with Claude Code
This is not a duplicate issue. Those other issues addressed some other specific issues with Remote Control. The closest was that remote-control is not listed in help. I am addressing several issues here: 1) help is not updated, 2) resume does not recognize remote control sessions unless stated explicitly. 3) asking for general improvement in the ability to reconnect to remote-control sessions
Closing for now — inactive for too long. Please open a new issue if this is still relevant.
+1, the files and transcripts are there but the wiring is lacking to resume them anywhere, either locally on the server or on any of remote devices.
<img width="345" height="167" alt="Image" src="https://github.com/user-attachments/assets/cd95d85d-f183-4bff-ae76-4b576e6c4445" />
I want to echo the original request - this is really obtuse. However there is a way if you know the remote session identifier - you can use
claude --teleport. Additionally, the desktop app lets you copy a terminal command (see above).This issue has been automatically locked since it was closed and has not had any activity for 7 days. If you're experiencing a similar issue, please file a new issue and reference this one if it's relevant.