How superset-sh/superset works
Superset is a desktop workspace for running coding agents in parallel and reviewing their work. The documented workflow is to add a repository, create a workspace, launch an agent, inspect and revise its changes, preview the app, then commit or push. The tree supports the desktop’s workspace, Git, browser, and terminal layers; README-described capabilities such as scheduled automations and mobile are represented where matching runtime paths are visible. Several feature paths are unsampled, so uncertain implementation links are omitted.
Main entry points: $workspaceId Agent workspace UI · route.ts API service · setup.ts Desktop app · useBranchPickerController.ts Workspace creation
Components 17
Workspace management
- Desktop app
apps/desktop/src/lib/electron-app/factories/app/setup.ts - Workspace creation
apps/desktop/src/renderer/routes/_authenticated/components/DashboardNewWorkspaceModal/components/DashboardNewWorkspaceForm/PromptGroup/hooks/useBranchPickerController/useBranchPickerController.ts - Workspace operations
apps/desktop/src/lib/trpc/routers
Agent sessions
- Terminal sessions
apps/desktop/src/lib/trpc/routers - Agent workspace UI
apps/desktop/src/renderer/routes/_authenticated/_dashboard/v2-workspace/$workspaceId - Agent chat
apps/desktop/src/renderer/routes/_authenticated/_dashboard/v2-workspace/$workspaceId/hooks/usePaneRegistry/components/ChatV3Pane/hooks/useSessionClient/useSessionClient.ts
Review and delivery
- Git and worktrees
apps/desktop/src/lib/trpc/routers/changes - Browser preview
apps/desktop/src/lib/trpc/routers/browser/browser.ts - Change review
apps/desktop/src/lib/trpc/routers/changes - Pull requests
apps/desktop/src/lib/trpc/routers/changes/utils/pull-request-discovery.ts
Remote services
- Scheduled agents
apps/api/src/lib/automations - API service
apps/api/src/app/api/route.ts - MCP server
apps/api/src/app/mcp/route.ts - Mobile API
apps/api/src/app/api/mobile/version/route.ts - Remote host service
apps/desktop/src/lib/trpc/routers/host-service-coordinator - Cloud service
apps/api/src/app/api/cloud-workspaces
Other components
- User
Connections 16
- User → Desktop app: uses
- Desktop app → Workspace creation: opens
- Workspace creation → Workspace operations: creates workspace
- Workspace operations → Git and worktrees: manages worktrees
- User → Agent workspace UI: starts task
- Agent workspace UI → Terminal sessions: opens sessions
- Agent workspace UI → Agent chat: prompts agent
- Agent chat → Remote host service: sends chat requests
- User → Change review: reviews changes
- Change review → Git and worktrees: reads changes
- User → Browser preview: previews app
- User → Pull requests: uses PR workflows
- Scheduled agents → API service: dispatches runs
- MCP server → API service: serves requests
- Mobile API → API service: exposes endpoint
- Cloud service → Remote host service: provisions host