Files
msd-core/get-shit-done/workflows/remove-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

2.1 KiB

Remove a GSD workspace, cleaning up git worktrees and deleting the workspace directory.

<required_reading> Read all files referenced by the invoking prompt's execution_context before starting. </required_reading>

1. Setup

Extract workspace name from $ARGUMENTS.

INIT=$(node "$HOME/.claude/get-shit-done/bin/gsd-tools.cjs" init remove-workspace "$WORKSPACE_NAME")
if [[ "$INIT" == @file:* ]]; then INIT=$(cat "${INIT#@file:}"); fi

Parse JSON for: workspace_name, workspace_path, has_manifest, strategy, repos, repo_count, dirty_repos, has_dirty_repos.

If no workspace name provided:

First run /gsd:list-workspaces to show available workspaces, then ask:

Use AskUserQuestion:

  • header: "Remove Workspace"
  • question: "Which workspace do you want to remove?"
  • requireAnswer: true

Re-run init with the provided name.

2. Safety Checks

If has_dirty_repos is true:

Cannot remove workspace "$WORKSPACE_NAME" — the following repos have uncommitted changes:

  - repo1
  - repo2

Commit or stash changes in these repos before removing the workspace:
  cd $WORKSPACE_PATH/repo1
  git stash   # or git commit

Exit. Do NOT proceed.

3. Confirm Removal

Use AskUserQuestion:

  • header: "Confirm Removal"
  • question: "Remove workspace '$WORKSPACE_NAME' at $WORKSPACE_PATH? This will delete all files in the workspace directory. Type the workspace name to confirm:"
  • requireAnswer: true

If answer does not match $WORKSPACE_NAME: Exit with "Removal cancelled."

4. Clean Up Worktrees

If strategy is worktree:

For each repo in the workspace:

cd "$SOURCE_REPO_PATH"
git worktree remove "$WORKSPACE_PATH/$REPO_NAME" 2>&1 || true

If git worktree remove fails, warn but continue:

Warning: Could not remove worktree for $REPO_NAME — source repo may have been moved or deleted.

5. Delete Workspace Directory

rm -rf "$WORKSPACE_PATH"

6. Report

Workspace "$WORKSPACE_NAME" removed.

  Path: $WORKSPACE_PATH (deleted)
  Repos: $REPO_COUNT worktrees cleaned up