claude-code - 💡(How to fix) Fix Desktop app sessions don't honor remoteControlAtStartup setting

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…

Sessions launched from the Claude desktop app do not auto-enable Remote Control, even with "remoteControlAtStartup": true set in ~/.claude/settings.json. Only sessions launched from a regular terminal (the claude CLI) respect the setting and become visible from the mobile app / claude.ai/code.

This is a problem because the desktop app is where many users (myself included) do all of their work — so the setting effectively does nothing in practice.

Root Cause

This is a problem because the desktop app is where many users (myself included) do all of their work — so the setting effectively does nothing in practice.

Fix Action

Workaround

Launch sessions from a terminal instead of the desktop app for anything I want on my phone.

Code Example

{"entrypoint":"claude-desktop","version":"2.1.128", ...}

---

{"entrypoint":"cli","version":"2.1.132", ...}
RAW_BUFFERClick to expand / collapse

Summary

Sessions launched from the Claude desktop app do not auto-enable Remote Control, even with "remoteControlAtStartup": true set in ~/.claude/settings.json. Only sessions launched from a regular terminal (the claude CLI) respect the setting and become visible from the mobile app / claude.ai/code.

This is a problem because the desktop app is where many users (myself included) do all of their work — so the setting effectively does nothing in practice.

Repro

  1. Set "remoteControlAtStartup": true in ~/.claude/settings.json.
  2. Open a session in the Claude desktop app (macOS, in my case).
  3. Open Claude Code on phone (or claude.ai/code) signed in with the same account.
  4. Session does NOT appear.
  5. Now run claude from a normal terminal in the same project — that session DOES appear on phone immediately.

Evidence

The session metadata at ~/.claude/sessions/<pid>.json shows the entrypoint differs:

Desktop-launched (not visible on phone):

{"entrypoint":"claude-desktop","version":"2.1.128", ...}

Terminal-launched (visible on phone):

{"entrypoint":"cli","version":"2.1.132", ...}

Two things worth noting:

  • The claude-desktop entrypoint appears to skip whatever wiring reads remoteControlAtStartup.
  • The desktop app pins its own bundled Claude Code version (2.1.128 here), which lags behind the CLI on PATH (2.1.132). If Remote Control needs ≥2.1.51 that's fine, but it does mean fixes ship to the desktop app on a different cadence.

Environment

  • macOS (Darwin 25.4.0)
  • Claude Code CLI: 2.1.132
  • Claude Desktop bundled CLI: 2.1.128
  • ~/.claude/settings.json contains "remoteControlAtStartup": true

Expected

Desktop-app-launched sessions should honor remoteControlAtStartup the same way CLI-launched sessions do, so they appear on the phone without needing a manual /remote-control toggle every time.

Workaround

Launch sessions from a terminal instead of the desktop app for anything I want on my phone.

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