Skip to main content
← Back to list
01Issue
FeatureShippedSwamp CLIPublic
Assigneeszack

Relationships

#4850 swamp serve workspace commands: create, list, get, suspend, resume and rm

Opened by zack · 11/17/2026· Shipped 11/18/2026

Issue 12 of the execution plan in design/surfaces/serve-workspaces.md. One PR. Depends on swamp-club#4849 (workspace requests on the root).

Problem

The root answers workspace.* requests, but the CLI has no command that sends them.

Change

Add the swamp serve workspace commands. Each is one request to the root at the host's address, given by --server or the repo's server address.

  • swamp serve workspace create <name> makes a workspace and prints its address. It does not start a serve. Its output says the workspace is stopped and names the command that starts it.
  • swamp serve workspace list prints names, addresses and states.
  • swamp serve workspace get <name> prints the state, the restart count and the host's reason when the workspace is not ready.
  • swamp serve workspace suspend <name> stops its serve and keeps everything.
  • swamp serve workspace resume <name> starts its serve. This is how a new workspace is started, and how a suspended one comes back.
  • swamp serve workspace rm <name> stops its serve and removes its folder. It follows the confirmation convention the other destructive commands use.

Every command supports log and json output. The commands load lazily, like the rest of the CLI.

Errors read plainly: an unknown workspace, a taken name, a refused request, a server that is not a host's root, and a token-mode root that refuses create.

Done when

  • Each command has tests in log and json modes against a mocked server.
  • Each error above has a test for its message.
  • create reports the workspace as stopped and names resume, in both output modes.
  • The json-mode fitness rule passes for the new commands.
  • A journey that spawns the binary belongs in swamp-uat.

Out of scope

  • Signing in to a workspace through the root. Until that lands, a person reaches a new workspace with swamp auth server-login to its address.
  • Registering an existing repo. swamp workspace import on the host's machine does that, and plan item 19 makes the host recognize it.
02Bog Flow
✓OPEN✓TRIAGED✓IN PROGRESS✓SHIPPED+ 1 MOREASSIGNED+ 5 MOREREVIEW+ 8 MOREPR_LINKED+ 2 MORESESSION_SUMMARIZED

Shipped

11/18/2026, 7:20:01 PM

Click a lifecycle step above to view its details.

03Sludge Pulse
zack assigned zack11/18/2026, 6:28:02 PM

Sign in to post a ripple.