Skip to main content

Web Sessions (Remote Control)

Cody CLI can run in a remote-control mode that lets you monitor and interact with sessions from the AINative web dashboard or mobile app.

Starting a Remote Session​

cody --remote

This starts Cody in spawn mode and registers a session with the AINative backend. A QR code or session URL is displayed — open it in your browser or mobile app to connect.

How It Works​

  1. CLI registers a session via POST /v1/sessions
  2. Events stream bidirectionally over WebSocket at /v1/sessions/ws/{id}/subscribe
  3. Web/mobile UI renders the session and can send messages back

Permissions​

Remote sessions respect all local permission settings. Tool calls that require approval will prompt both the terminal and the remote client. Either can approve or deny.

Use Cases​

  • Monitor a long-running agent task from your phone
  • Approve tool calls remotely while away from your terminal
  • Share a session with a teammate for pair programming
  • Start a session from CI and monitor it from the dashboard
ℹ️Session Security

Remote sessions use your AINative OAuth token for authentication. Sessions are scoped to your account — only you and explicitly invited users can connect.