[DOCS] Remote Control docs outdated — bridge session reconnects in seconds, not up to 10 minutes

Open 💬 5 comments Opened Mar 7, 2026 by coygeek

Documentation Type

Incorrect/outdated documentation

Documentation Location

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

Section/Topic

Session interruption and reconnection behavior — limitations section

Current Documentation

remote-control.md describes bridge session reconnection limitations as:

"Extended network outage: if your machine is awake but unable to reach the network for more than roughly 10 minutes, the session times out and the process exits. Run claude remote-control again to start a new session."

And separately:

"Survive interruptions: if your laptop sleeps or your network drops, the session reconnects automatically when your machine comes back online"

The reconnect-on-wake bullet describes automatic reconnection generically but does not quantify the timing.

What's Wrong or Missing?

Changelog v2.1.71 states:

"Improved bridge session reconnection to complete within seconds after laptop wake from sleep, instead of waiting up to 10 minutes"

The documentation does not reflect this improvement. The "Survive interruptions" bullet implies reconnection is fast but gives no timing. Before this fix, reconnection after laptop wake could take up to 10 minutes — a significant usability issue that the documentation did not warn users about.

Now that reconnection completes within seconds after wake, the docs should:

  1. Quantify the reconnection timing (seconds after wake) so users know what to expect.
  2. Distinguish wake-from-sleep reconnection (now fast — seconds) from extended network outage (still results in session timeout after ~10 minutes of no network while awake).

Without this update, users may not know whether to wait after waking their laptop or immediately restart the session.

Suggested Improvement

Update the "Survive interruptions" bullet to reflect the improved timing:

Before:

"Survive interruptions: if your laptop sleeps or your network drops, the session reconnects automatically when your machine comes back online"

After:

"Survive interruptions: if your laptop sleeps, the session reconnects automatically within seconds after wake. If your network drops while awake, reconnection also occurs automatically when connectivity resumes."

Keep the "Extended network outage" bullet (10-minute timeout while awake with no network) unchanged — this is a separate scenario from wake-from-sleep.

Impact

Low - Minor confusion or inconvenience

Additional Context

Affected Pages:

| Page | Context |
|------|---------|
| https://code.claude.com/docs/en/remote-control | Session reconnection timing — "Survive interruptions" bullet needs updating |

Total scope: 1 page affected

Source: Changelog v2.1.71

Exact changelog entry:

"Improved bridge session reconnection to complete within seconds after laptop wake from sleep, instead of waiting up to 10 minutes"

View original on GitHub ↗

This issue has 5 comments on GitHub. Read the full discussion on GitHub ↗