[DOCS] Remote Control docs outdated — bridge session reconnects in seconds, not up to 10 minutes
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:
- Quantify the reconnection timing (seconds after wake) so users know what to expect.
- 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"
This issue has 5 comments on GitHub. Read the full discussion on GitHub ↗