gsd-remove-workspace

Remove a GSD workspace and its member worktrees after confirmation.

1|Updated Apr 7, 2026
One-click install
npx skills add https://github.com/TruCol270/salty-pickle --skill gsd-remove-workspace-trucol270
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: gsd-remove-workspace
Source: https://github.com/TruCol270/salty-pickle/tree/main/.claude-skills/gsd-remove-workspace
Command: npx skills add https://github.com/TruCol270/salty-pickle --skill gsd-remove-workspace-trucol270

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Safely remove a GSD workspace and clean up all associated worktrees, preventing leftover configurations and confusion in multi-repo setups.

Core Features & Use Cases

  • Safely remove the targeted workspace directory after explicit confirmation
  • For worktree setups, remove each member repo's worktree before deleting the workspace
  • Fail safely if any repository has uncommitted changes to prevent data loss

Quick Start

Confirm the workspace name and run the remove-workspace command to delete the specified workspace and all associated worktrees.

Frequently Asked Questions about gsd-remove-workspace

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I safely remove a git worktree and clean up the workspace directory?

Removing a workspace fails safely and aborts the operation if any member repository has uncommitted changes. This safety check prevents data loss by ensuring all work is committed before worktrees are torn down.

How does workspace cleanup work in a multi-repo environment?

You need workspace cleanup when tearing down obsolete or test workspaces in multi-repo setups. Removing worktrees and deleting the workspace prevents leftover configurations, avoids confusion, and keeps your repository structure clean.

What happens if a repository has uncommitted changes during worktree removal?

If a repository has uncommitted changes, the workspace removal process will abort. This safety check prevents data loss by ensuring no uncommitted work is accidentally discarded during the git worktree removal step.

Do I need to confirm the workspace name before deleting a GSD workspace?

Yes, you need to confirm the workspace name before deleting a GSD workspace. Workspace name validation and explicit user confirmation are required safeguards to ensure the correct workspace and its associated worktrees are targeted for removal.

Can I remove multiple worktrees from a multi-repo setup at once?

Yes, you can remove multiple worktrees from a multi-repo setup at once by running the remove-workspace command. It executes git worktree remove for every member repository, ensuring each worktree is removed before the workspace itself is deleted.