singularity-forge/mintlify-docs/guides/web-interface.mdx
Lex Christopherson d20d5e8fb5 docs: add Mintlify documentation site and move internal docs
Add a proper public-facing documentation site using Mintlify with 19 MDX
pages covering getting started, auto mode, commands, configuration, and
all user-facing features. Move internal/SDK documentation (Pi SDK, TUI,
context & hooks, research notes, ADRs) to docs-internal/ since they
should not be part of the public documentation.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
2026-03-25 09:54:41 -06:00

38 lines
1.3 KiB
Text

---
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.