/gsd-settings
Interactive six-section configuration wizard.
Syntax
config.json, presents your existing values, merges your answers, and writes the updated config with a confirmation display and quick command references. Use /gsd-config for advanced knobs and integration settings.
/gsd-config
Configure GSD settings — common toggles, advanced knobs, integrations, and model profiles.
Syntax
/gsd-settings. With --advanced it exposes power-user knobs across planning, execution, discussion, cross-AI, git, and runtime settings. With --integrations it manages third-party API keys, code-review CLI routing, and agent-skill injection. With --profile it switches your model profile without any interactive prompts.
Flags
Open the advanced settings wizard covering planning granularity, timeouts, branch templates, cross-AI execution configuration, and runtime tuning.
Open the integrations settings wizard covering API keys (Brave, Firecrawl, Exa), review CLI routing, and agent-skill injection configuration.
Switch the active model profile without interactive prompts. Accepted values:
quality, balanced, budget, inherit./gsd-surface
Toggle which skill commands are surfaced without reinstalling GSD.
Syntax
~/.claude/.gsd-surface.json and re-staging the active skills directory in place. Use this to reduce context token usage from skill definitions by disabling clusters you don’t need, or to switch between surface profiles.
Valid cluster names: core_loop, audit_review, milestone, research_ideate, workspace_state, docs, ui, ai_eval, ns_meta, utility
Subcommands
Show all enabled and disabled clusters and skills with their approximate token cost.
Alias for
list, plus a summary of the base profile and install-time profile.Switch the base surface profile. Accepted values:
core, standard, full. Comma-separate profile names to compose multiple profiles (no spaces), e.g., profile core,audit_review.Add a cluster to the disabled list and immediately remove its skills from the active surface.
Remove a cluster from the disabled list and restore its skills to the active surface.
Delete
.gsd-surface.json and return to the install-time profile defaults./gsd-update
Update GSD to the latest version with changelog display.
Syntax
@latest.
Flags
Sync managed GSD skills across all runtime roots. Use after an update if you work across multiple runtimes and want to keep skill definitions aligned. Supports
--from, --to, --dry-run, and --apply sub-flags.Reapply local modifications after a GSD update. Performs a three-way merge between the pristine baseline, your user-modified backup, and the newly installed version to recover your customizations.
Target the
@next release-candidate dist-tag instead of @latest. Use to install or refresh a release candidate (e.g., 1.4.0-rc.1). Also accepted as --rc./gsd-workspace
Manage isolated GSD workspace environments.
Syntax
.planning/ directories and repo copies. Workspaces use either a git worktree strategy (faster, shares object store) or a full clone strategy (fully isolated, higher disk usage).
Flags
Create a new isolated workspace. Combine with
--name, --repos, and --strategy to configure it.List all active GSD workspaces in
~/gsd-workspaces/ with their status and current phase.Remove a named workspace and clean up any associated worktrees. Pass the workspace name as the next argument.
Name for the new workspace. Used with
--new.Comma-separated list of repositories to include in the workspace. Used with
--new.Isolation strategy for the new workspace. Accepted values:
worktree— git worktree (faster, shares object store)clone— full clone (fully isolated, higher disk usage)
/gsd-workstreams
Manage parallel workstreams for concurrent milestone work.
Syntax
milestones/. Defaults to list when no subcommand is provided.
Subcommands
List all workstreams with name, status, current phase, and progress.
Create a new workstream. After creation, run
/gsd-new-milestone --ws [name] to set up its milestone.Show detailed phase breakdown and state information for the named workstream.
Set the named workstream as active for the current session.
Show a progress summary across all workstreams.
Archive the named workstream to
milestones/.Set the named workstream as active and prompt you to run
/gsd-resume-work --ws [name]./gsd-capture
Capture ideas, tasks, notes, and seeds to their destination.
Syntax
--note it appends a timestamped note. With --backlog it adds to the ROADMAP.md backlog section with 999.x numbering. With --seed it plants a forward-looking idea with trigger conditions in .planning/seeds/.
Flags
Create a structured todo in
.planning/todos/.Zero-friction idea capture. Appends a timestamped note, lists existing notes, or promotes a note to a todo or phase.
Add an idea to the ROADMAP.md backlog parking lot with 999.x phase numbering.
Capture a forward-looking idea with trigger conditions as
.planning/seeds/SEED-NNN-slug.md.Open an interactive todo browser and action router for pending todos.
/gsd-thread
Manage persistent context threads for cross-session work.
Syntax
List all threads. Add
--open to show only open threads, or --resolved to show only closed ones.Show the current status and context summary for a thread identified by its slug.
Mark a thread as resolved.
Resume a thread by restoring its context into the current session.
/gsd-quick
Execute an ad-hoc task with GSD guarantees but skip optional agents.
Syntax
STATE.md tracking — using a shorter pipeline than full phase execution. Quick tasks live in .planning/quick/ and update the “Quick Tasks Completed” table in STATE.md, not ROADMAP.md. By default, research, discussion, plan-checking, and verification agents are all skipped.
Flags
Enable the complete quality pipeline: discussion + research + plan-checking + post-execution verification. One flag for everything.
Enable plan-checking (max 2 iterations) and post-execution verification only, without discussion or research.
Run a lightweight discussion phase before planning to surface assumptions and clarify gray areas.
Spawn a focused research agent before planning to investigate implementation approaches, library options, and pitfalls.
List all quick tasks with slug, date, and status (complete, in-progress, or abandoned).
Show the status, plan description, and last action for a specific quick task by slug.
Resume a specific in-progress quick task by slug, restoring plan context and continuing execution.
/gsd-fast [task]
Execute a trivial inline task with no planning overhead.
Syntax
/gsd-quick for anything that needs research, multi-step planning, or verification.
/gsd-undo
Safe git revert for phase and plan commits.
Syntax
Show the most recent
N GSD commits for interactive selection. You choose which to revert from the list.Revert all commits for phase
NN. Uses the phase manifest first, then falls back to git log pattern matching.Revert all commits for a specific plan identified by phase number and plan number (e.g.,
03-02 for phase 3, plan 2)./gsd-cleanup
Archive phase directories and prune stale branches.
Syntax
.planning/milestones/v{X.Y}-phases/. Use this when .planning/phases/ has accumulated directories from past milestones and you want to keep the working directory clean. Always shows you a dry-run summary of what will be moved and waits for confirmation before archiving.
/gsd-help
Show available GSD commands and usage guidance.
Syntax
One-page tour of all GSD commands with short descriptions and common usage patterns.
Single-line refresher per command. Fastest lookup when you just need a syntax reminder.
Complete reference output covering every command, every flag, and all usage notes.
Display the reference section for a single topic, e.g.,
/gsd-help workflow or /gsd-help ship.Signature plus a one-line summary for a single topic. Compact scoped lookup — e.g.,
/gsd-help --brief plan-phase.