f8c6ab0c54
* fix(vscode): add extensionKind and error handler for Remote SSH support * fix(vscode): reject failed RPC startup * docs: consolidate docs, remove stale artifacts, and repo hygiene - Remove docs-internal/ (duplicate of docs/); update pr-risk-check.mjs path - Sync 9 diverged files to latest content (commands, config, troubleshooting, etc.) - Fix pi --web → gsd --web naming in docs/README.md - Copy FRONTIER-TECHNIQUES.md and ADR-004 to docs/ before removal - Delete orphaned PR screenshot folders (pr-876/, pr-1530/) — unreferenced - Remove committed pnpm-lock.yaml files (project uses npm) - Move PLAN.md → .plans/doctor-cleanup-consolidation.md - Move web/left-native-tui-main-session-plan.md → .plans/ - Delete .DS_Store and vscode-extension/dist/ from disk Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com> --------- Co-authored-by: Claude Opus 4.6 <noreply@anthropic.com>
66 lines
2.6 KiB
Markdown
66 lines
2.6 KiB
Markdown
# Web Interface
|
|
|
|
> Added in v2.41.0
|
|
|
|
GSD includes a browser-based web interface for project management, real-time progress monitoring, and multi-project support.
|
|
|
|
## Quick Start
|
|
|
|
```bash
|
|
gsd --web
|
|
```
|
|
|
|
This starts a local web server and opens the GSD dashboard in your default browser.
|
|
|
|
### CLI Flags (v2.42.0)
|
|
|
|
```bash
|
|
gsd --web --host 0.0.0.0 --port 8080 --allowed-origins "https://example.com"
|
|
```
|
|
|
|
| Flag | Default | Description |
|
|
|------|---------|-------------|
|
|
| `--host` | `localhost` | Bind address for the web server |
|
|
| `--port` | `3000` | Port for the web server |
|
|
| `--allowed-origins` | (none) | Comma-separated list of allowed CORS origins |
|
|
|
|
## Features
|
|
|
|
- **Project management** — view milestones, slices, and tasks in a visual dashboard
|
|
- **Real-time progress** — server-sent events push status updates as auto-mode executes
|
|
- **Multi-project support** — manage multiple projects from a single browser tab via `?project=` URL parameter
|
|
- **Change project root** — switch project directories from the web UI without restarting the server (v2.44)
|
|
- **Onboarding flow** — API key setup and provider configuration through the browser
|
|
- **Model selection** — switch models and providers from the web UI
|
|
|
|
## Architecture
|
|
|
|
The web interface is built with Next.js and communicates with the GSD backend via a bridge service. Each project gets its own bridge instance, providing isolation for concurrent sessions.
|
|
|
|
Key components:
|
|
- `ProjectBridgeService` — per-project command routing and SSE subscription
|
|
- `getProjectBridgeServiceForCwd()` — registry returning distinct instances per project path
|
|
- `resolveProjectCwd()` — reads `?project=` from request URL or falls back to `GSD_WEB_PROJECT_CWD`
|
|
|
|
## Configuration
|
|
|
|
The web server binds to `localhost:3000` by default. Use `--host`, `--port`, and `--allowed-origins` to override (see CLI Flags above).
|
|
|
|
### Environment Variables
|
|
|
|
| Variable | Description |
|
|
|----------|-------------|
|
|
| `GSD_WEB_PROJECT_CWD` | Default project path when `?project=` is not specified |
|
|
|
|
## Node v24 Compatibility
|
|
|
|
Node v24 introduced breaking changes to type stripping that caused `ERR_UNSUPPORTED_NODE_MODULES_TYPE_STRIPPING` on web boot. This is fixed in v2.42.0+ (#1864). If you encounter this error, upgrade GSD.
|
|
|
|
## Auth Token Persistence
|
|
|
|
As of v2.42.0, the web UI persists the auth token in `sessionStorage` so it survives page refreshes (#1877). Previously, refreshing the page required re-authentication.
|
|
|
|
## Platform Notes
|
|
|
|
- **Windows**: The web build is skipped on Windows due to Next.js webpack EPERM issues with system directories. The CLI remains fully functional.
|
|
- **macOS/Linux**: Full support.
|