Skip to main content
← Back to list
01Issue
BugOpenSwamp CLIPublicEnterprise
AssigneesNone

Relationships

#4989 Clarify differences between swamp start dashboard and swamp serve dashboard

Opened by tagur · 11/22/2026

Summary Two different dashboards ship with swamp and nothing explains the split. A user who runs a long-lived swamp serve expects the same UI as the swamp start page and gets a different one.

Current behavior

  • swamp start opens a local page on a random port. It has a workspace dropdown, the Swampify page and task start.
  • swamp serve --dashboard serves /dashboard for one repo only (--repo-dir). It has no workspace dropdown and cannot switch repos.
  • swamp dashboard also shows one repo only and does not add it to swamp start workspaces.
  • swamp serve --help and swamp start --help do not mention the other dashboard or the difference.

Expected

  • Opening the dashboard on a swamp serve port gives the same UI as the swamp start page, including the workspace dropdown.

Impact

  • Users who run swamp serve as a service (token auth, reverse proxy, launchd) cannot switch repos in its dashboard. The only option is one serve process per repo, each on its own port.
  • Remote and authenticated access exists only on serve. Workspace switching exists only on start. No single mode gives both.

Requested fix

  1. Merge into one dashboard. Both modes show the same UI, with the workspace dropdown available under serve and its token auth.
  2. Until then, document the split in swamp serve --help, swamp start --help and swamp dashboard --help. State what each dashboard shows and which one to use.
02Bog Flow
◉OPEN○TRIAGED○IN PROGRESS○SHIPPED

Open

11/22/2026, 12:59:42 AM

No activity in this phase yet.

03Sludge Pulse
tagur moved this from a private collective to public11/22/2026, 1:00:07 AM
Editable. Press Enter to edit.

stack72 commented 11/22/2026, 1:01:22 AM

Hey @tagur

This is still expected at this time - currently (as of today!) swamp serve is limited to a single repo but we are working on opening that up right now and have the work in progress! This work will be shipped this coming week as the code is already merged and ready to put into our own test environment

Paul

tagur commented 11/22/2026, 1:05:15 AM

Thanks @stack72. As I created this i wondered if this was still part of ongoing work. Just happened to notice the difference as i was playing with the new dashboard features and swampify.

Sign in to post a ripple.