Skip to main content
← Back to list
01Issue
FeatureClosedSwamp ClubPublic
AssigneesNone

Relationships

#3448 Docs: choosing where a new workspace is created (--path, start page Location field, workspaces.dir)

Opened by stack72 · 10/14/2026

What changed (swamp-club#3441, PR swamp-club/swamp#3103, released in v20261014.152311.0-sha.c9a86d41)

New workspaces are no longer always created under <data dir>/workspaces/<name>:

  • swamp workspace create <name> --path <dir> creates the workspace in <dir>/<name>. <dir> must already exist; ~ and relative paths work.
  • swamp start --workspace <name> --path <dir> does the same when the name is new. --path needs --workspace and is refused with --json.
  • The swamp start page's new-workspace form has a Location field (with Browse) under Name, and shows the folder that will be created as either field changes.
  • swamp config set workspaces.dir <dir> sets the default folder for new workspaces; swamp config set workspaces.dir default resets it to the data dir.
  • Precedence: --path / the Location field, then workspaces.dir, then <data dir>/workspaces.
  • A workspace created in a chosen folder is listed as created, not imported (Imported: no in swamp workspace get).
  • New refusals: parent_not_found, parent_not_a_folder, parent_not_absolute (page only), parent_unreadable, parent_too_long; a link where the workspace folder would go is refused (not_a_workspace).

Pages to update

  • content/manual/reference/workspace-commands.md: the Created row and the workspace create section say <data dir>/workspaces/<name>; add --path, the precedence, and workspaces.dir.
  • content/manual/how-to/start-a-task-with-swamp-start.md: describe the Location field and the "Creates " preview, and swamp start --workspace <name> --path <dir>.
  • The configuration reference that lists swamp config keys (update.auto, update.cadence, telemetry.collection): add workspaces.dir.

In-repo design docs already updated: design/surfaces/workspace.md, design/surfaces/start.md.

02Bog Flow
✓OPEN○TRIAGED○IN PROGRESS◉CLOSED

Closed

10/14/2026, 5:21:19 PM

No activity in this phase yet.

03Sludge Pulse
Editable. Press Enter to edit.

stack72 commented 10/14/2026, 5:12:23 PM

Fixed in https://github.com/swamp-club/swamp-club/pull/1349: workspace-commands.md (--path, precedence, Imported: no, parent_* and link refusals), the swamp start how-to (Location field, Creates preview, --path, workspaces.dir section) and the workspaces.dir row in the config key table. Checked against 20261014.161041.

stack72 commented 10/14/2026, 5:21:19 PM

Sign in to post a ripple.