> ## Documentation Index
> Fetch the complete documentation index at: https://docs.mutual-dissent.dev/llms.txt
> Use this file to discover all available pages before exploring further.

# dissent serve

> Start the web UI server

Start the Starlette web interface. Provides a live debate view with WebSocket streaming, a transcript dashboard, and a settings page for provider and model configuration.

## Usage

```bash theme={null}
dissent serve [OPTIONS]
```

## Options

| Option      | Default     | Description                       |
| ----------- | ----------- | --------------------------------- |
| `--port`    | `8080`      | Port to bind to (1–65535)         |
| `--host`    | `127.0.0.1` | Host address to bind to           |
| `--no-open` | off         | Suppress automatic browser launch |

## Examples

```bash theme={null}
# Default — binds to localhost:8080 and opens browser
dissent serve

# Custom port
dissent serve --port 9000

# Bind to all interfaces (e.g. for remote access)
dissent serve --host 0.0.0.0 --port 8080 --no-open
```

## Web UI Features

**Debate view** — run debates from the browser with live streaming. Each model's response appears as it arrives via WebSocket.

**Research dashboard** — browse saved transcripts, view convergence and influence charts, inspect cost breakdowns per model.

**Config panel** — view and edit provider keys and routing configuration from the UI.

## Notes

* `dissent serve` blocks until the server is stopped (Ctrl+C)
* Navigating away from an in-progress debate will orphan the running asyncio task — results will not be recoverable. Stay on the debate page until synthesis completes.
* The web UI reads transcripts from `~/.mutual-dissent/transcripts/` — transcripts from CLI debates appear in the dashboard automatically