---
title: "Web interface"
description: "Browser-based project management with real-time progress and multi-project support."
---

GSD includes a browser-based web interface for project management, real-time progress monitoring, and multi-project support.

## Quick start

```bash
gsd --web
```

### CLI flags

```bash
gsd --web --host 0.0.0.0 --port 8080 --allowed-origins "https://example.com"
```

| Flag | Default | Description |
|------|---------|-------------|
| `--host` | `localhost` | Bind address |
| `--port` | `3000` | Port |
| `--allowed-origins` | (none) | Comma-separated CORS origins |

## Features

- **Project management** — view milestones, slices, and tasks in a visual dashboard
- **Real-time progress** — server-sent events push status updates during auto-mode
- **Multi-project support** — manage multiple projects from a single tab via `?project=` URL parameter
- **Change project root** — switch directories from the web UI without restarting
- **Onboarding flow** — API key setup and provider configuration through the browser
- **Model selection** — switch models and providers from the web UI

## Platform notes

- **macOS/Linux** — full support
- **Windows** — web build is skipped due to Next.js webpack issues. The CLI remains fully functional.
