[FEATURE] Remote Control session resume is undiscoverable in the CLI

[ajogamestudio]

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 Create SECURITY.md #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

Where <uuid> has to be hunted manually:
ls -lt ~/.claude/projects//*.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.

[github-actions]

Found 3 possible duplicate issues:

1. [DOCS] --remote-control flag not listed under --help #54943
2. Remote Control session not visible in session list, cannot reconnect after leaving #28402
3. Remote Control: session should persist across disconnections #36401

This issue will be automatically closed as a duplicate in 3 days.

• If your issue is a duplicate, please close it and 👍 the existing issue instead
• To prevent auto-closure, add a comment or 👎 this comment

🤖 Generated with Claude Code

[ajogamestudio]

Found 3 possible duplicate issues:

1. [DOCS] --remote-control flag not listed under --help #54943
2. Remote Control session not visible in session list, cannot reconnect after leaving #28402
3. Remote Control: session should persist across disconnections #36401

This issue will be automatically closed as a duplicate in 3 days.

• If your issue is a duplicate, please close it and 👍 the existing issue instead
• To prevent auto-closure, add a comment or 👎 this comment

🤖 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

[github-actions]

Closing for now — inactive for too long. Please open a new issue if this is still relevant.

[shivanshB-rb]

+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.

[lukeredpath]

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).