← 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 listprints 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.
createreports the workspace as stopped and namesresume, 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-loginto its address. - Registering an existing repo.
swamp workspace importon the host's machine does that, and plan item 19 makes the host recognize it.
02Bog Flow
Shipped
Click a lifecycle step above to view its details.
03Sludge Pulse
Sign in to post a ripple.