[DOCS] Remote Control docs omit session-list "Requires Action" status for permission prompts

Open 💬 4 comments Opened Mar 27, 2026 by coygeek

Documentation Type

Missing documentation (feature not documented)

Documentation Location

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

Section/Topic

"Connect from another device" section, especially the session-list status description for Remote Control sessions in claude.ai/code and the mobile app

Current Documentation

The docs currently say:

Open claude.ai/code or the Claude app and find the session by name in the session list. Remote Control sessions show a computer icon with a green status dot when online.

Earlier on the same page, the docs also say:

While a remote session is active, the terminal shows connection status and tool activity.

This documents only the online indicator and local terminal activity. It does not document any session-list status for a Remote Control session that is waiting on a permission decision.

What's Wrong or Missing?

Changelog v2.1.85 indicates that Remote Control has a user-visible "Requires Action" session status related to permission handling.

The Remote Control docs do not explain:

  • that a session can switch to Requires Action when it is blocked on a permission prompt
  • that this status is shown in the claude.ai/code or mobile session list, not just inside the local terminal
  • that once the permission request is approved or denied, the session should clear that status and return to its normal running/online state

Without this explanation, users monitoring a Remote Control session from another device cannot tell what Requires Action means or why the session needs attention.

Suggested Improvement

Add a short note in the "Connect from another device" section that documents Remote Control session-list states. For example:

Remote Control sessions appear in the claude.ai/code and mobile session list with status indicators. A green dot means the session is online. If the local session is waiting on a permission prompt, the session can show Requires Action so you know it needs attention. After you resolve the prompt, the session returns to its normal state.

If there are other Remote Control-specific session statuses, list them in the same place so users can interpret the session list without trial and error.

Impact

Medium - Makes feature difficult to understand

Additional Context

Affected Pages:

| Page | Context |
|------|---------|
| https://code.claude.com/docs/en/remote-control | Primary Remote Control setup and session-list guidance; currently documents the green online dot but not the permission-related "Requires Action" state |

Total scope: 1 page affected

Source: Changelog v2.1.85

View original on GitHub ↗

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