---
title: "Web Sessions"
description: "Launch and control Cody CLI sessions remotely from the web or mobile"
canonical: "https://docs.ainative.studio/docs/cody-cli/web-sessions"
last-updated: "2026-10-22T17:48:46.689Z"
---

# Web Sessions

Source: https://docs.ainative.studio/docs/cody-cli/web-sessions

> Launch and control Cody CLI sessions remotely from the web or mobile

# 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

```bash
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

<Callout type="info" title="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.
</Callout>