Skip to main content
Generaldavepoon

gsd:new-workspace

Create an isolated workspace with repo copies and independent .planning/

Stars
2,987
Source
davepoon/buildwithclaude
Updated
2026-05-26
Slug
davepoon--buildwithclaude--new-workspace
View on GitHubRaw SKILL.md

// install — copy + paste into any project

mkdir -p .claude/skills && curl -fsSL https://raw.githubusercontent.com/davepoon/buildwithclaude/HEAD/plugins/gsd/skills/new-workspace/SKILL.md -o .claude/skills/new-workspace.md

Drops the SKILL.md into .claude/skills/new-workspace.md. Works with Claude Code, Cursor, and any agent that loads SKILL.md files from .claude/skills/.

**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.

@${CLAUDE_PLUGIN_ROOT}/workflows/new-workspace.md @${CLAUDE_PLUGIN_ROOT}/references/ui-brand.md Execute the new-workspace workflow from @${CLAUDE_PLUGIN_ROOT}/workflows/new-workspace.md end-to-end. Preserve all workflow gates (validation, approvals, commits, routing).