Docs: How to spawn new remote-control sessions from iOS app?

Resolved 💬 2 comments Opened Mar 15, 2026 by presfunkmann Closed Apr 13, 2026

Question / Documentation Gap

When running claude remote-control --name <name> in server mode, the terminal shows:

Capacity: 1/32 · New sessions will be created in the current directory
space to show QR code · w to toggle spawn mode

This implies the server supports multiple concurrent sessions (up to 32), and that new sessions can be spawned. However, from the iOS app, there doesn't appear to be any way to spawn a new/fresh session against the running remote-control server.

What I've tried

  • Tapping the + button in the Code tab — this creates a new cloud-based session (Claude Code on the Web), not a remote session against the local server
  • Long-pressing on the session in the session list
  • Ending the current session and re-tapping the server entry
  • Pressing w in the terminal to toggle spawn mode
  • Re-scanning the QR code

What I expected

Some way to create a fresh conversation/session against the same remote-control server from the iOS app, utilizing the capacity (e.g., going from 1/32 to 2/32).

Environment

  • Claude Code v2.1.76
  • iOS Claude app (latest)
  • macOS

Request

Could you clarify or document how users are intended to spawn new sessions from the mobile app against a running remote-control server? The remote control docs don't cover this specific workflow.

View original on GitHub ↗

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