Files
msd-core/commands/gsd/new-workspace.md
Tom Boucher 5c4d5e5f47 feat: add multi-project workspace commands (#1241)
Three new commands for managing isolated GSD workspaces:
- /gsd:new-workspace — create workspace with repo worktrees/clones
- /gsd:list-workspaces — scan ~/gsd-workspaces/ for active workspaces
- /gsd:remove-workspace — clean up workspace and git worktrees

Supports both multi-repo orchestration (subset of repos from a parent
directory) and feature branch isolation (worktree of current repo with
independent .planning/).

Includes init functions, command routing, workflows, 24 tests, and
user documentation.

Closes #1241

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-03-20 17:02:48 -04:00

1.7 KiB

name, description, argument-hint, allowed-tools
name description argument-hint allowed-tools
gsd:new-workspace Create an isolated workspace with repo copies and independent .planning/ --name <name> [--repos repo1,repo2] [--path /target] [--strategy worktree|clone] [--branch name] [--auto]
Read
Bash
Write
AskUserQuestion
**Flags:** - `--name` (required) — Workspace name - `--repos` — Comma-separated repo paths or names. If omitted, interactive selection from child git repos in cwd - `--path` — Target directory. Defaults to `~/gsd-workspaces/` - `--strategy` — `worktree` (default, lightweight) or `clone` (fully independent) - `--branch` — Branch to checkout. Defaults to `workspace/` - `--auto` — Skip interactive questions, use defaults Create a physical workspace directory containing copies of specified git repos (as worktrees or clones) with an independent `.planning/` directory for isolated GSD sessions.

Use cases:

  • Multi-repo orchestration: work on a subset of repos in parallel with isolated GSD state
  • Feature branch isolation: create a worktree of the current repo with its own .planning/

Creates:

  • <path>/WORKSPACE.md — workspace manifest
  • <path>/.planning/ — independent planning directory
  • <path>/<repo>/ — git worktree or clone for each specified repo

After this command: cd into the workspace and run /gsd:new-project to initialize GSD.

<execution_context> @/.claude/get-shit-done/workflows/new-workspace.md @/.claude/get-shit-done/references/ui-brand.md </execution_context>

Execute the new-workspace workflow from @~/.claude/get-shit-done/workflows/new-workspace.md end-to-end. Preserve all workflow gates (validation, approvals, commits, routing).