singularity-forge/gitbook/features/web-interface.md
ace-pm 35dc87ef53 chore: sync workspace state after rebrand
- Rebrand commits already in history (gsd → forge)
- Sync pre-existing doc, docker, and CI config updates
- All rebrand artifacts verified in place:
  * Native crates: forge-engine, forge-ast, forge-grep
  * Log prefixes: [forge] across 22+ files
  * Binary: ~/bin/sf-run
  * Workspace scopes: @sf-run/*, @singularity-forge/*
  * Nix flake: Rust toolchain ready

System ready for: nix develop && bun run build:native

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
2026-04-15 14:54:20 +02:00

1.2 KiB

Web Interface

SF includes a browser-based interface for project management and real-time progress monitoring.

Quick Start

gsd --web

This starts a local web server and opens the dashboard in your default browser.

CLI Flags

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 — live updates as auto mode executes
  • Multi-project support — manage multiple projects from one browser tab via ?project= URL parameter
  • Change project root — switch directories from the web UI without restarting
  • Onboarding flow — API key setup and provider configuration in 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 compatibility issues; CLI remains fully functional