Skip to main content
← Back to list
01Issue
FeatureOpenSwamp CLIPublic
AssigneesNone

Relationships

#4914 The dashboard switcher lists a serve host's workspaces, read from workspace.list on the root

Opened by zack · 11/19/2026

Issue 18 of the execution plan in design/surfaces/serve-workspaces.md. One PR. Depends on swamp-club#4849 (workspace requests on the root), shipped, and swamp-club#4913 (dashboard sign-in under a workspace segment).

Problem

The dashboard's workspace switcher reads the local hub's list at /api/local/workspaces (packages/dashboard/src/client/workspace_list.ts). A serve host has no hub, so under a host the switcher has nothing to show. A person moves between a host's workspaces by editing the address.

Change

Under a host, the switcher lists what workspace.list on the root returns. The design section is Dashboard.

  • The list. Each workspace's name and state, from the root. The root itself is an entry, and choosing it opens /dashboard/.
  • Switching opens /dashboard/w/<name>/, as the local dashboard's switcher does. The page reloads, and the workspace asks for its own sign-in if the browser has no session there.
  • State. A workspace that is stopped, starting or failed is listed and marked as such. Choosing it opens its page, which says the same.
  • The current workspace is always shown, whether or not the list could be read.
  • The local dashboard is unchanged. It still reads the hub's list.

workspace.list needs an authenticated principal on the root, so the switcher can read it only in a browser that is signed in to the root.

Decisions this issue makes

The PR states what it chose and updates the design doc.

  • A browser signed in to a workspace and not to the root. The expected answer is that the switcher shows the current workspace and a link to sign in to the root, and makes no request the root would refuse.
  • How the page reaches workspace.list. A second connection to the root with the root's session, or another way. A workspace page's own connection goes to the workspace.
  • How often the list is read. States change as workspaces are resumed and suspended.

Done when

  • Under a host, a browser signed in to the root sees every workspace workspace.list returns, each with its state, and the root.
  • Choosing a workspace opens its dashboard, and choosing the root opens the root's.
  • A browser not signed in to the root sees the current workspace and the link, and the root's audit log shows no refused workspace.list from it.
  • A workspace created or resumed while the page is open appears, or changes state, at the next read the PR chose.
  • The local dashboard's switcher lists the hub's workspaces as before.
  • The dashboard package's tests cover the host list, the local list and the not-signed-in case.

Out of scope

  • Creating, suspending or resuming a workspace from the dashboard.
  • Marking registered workspaces. swamp-club#4865 adds that to workspace.list.
  • Signing in to several workspaces at once.
02Bog Flow
◉OPEN○TRIAGED○IN PROGRESS○SHIPPED

Open

11/19/2026, 6:54:34 PM

No activity in this phase yet.

03Sludge Pulse

Sign in to post a ripple.