Commands
124 commands across 15 categories. Click any card to expand for details. Use the filter bar to narrow by category.
Session Commands
/gsd quick
Execute a quick task with GSD guarantees (atomic commits, state tracking) without full planning overhead
/gsd pause
Pause auto-mode (preserves state, /gsd auto to resume)
/gsd widget
Cycle dashboard widget: full / small / min / off
/gsd dispatch
Dispatch a specific phase directly (research, plan, execute, complete, reassess, uat, replan)
/gsd history
View execution history (supports --cost, --phase, --model filters)
/gsd forensics
Full-access GSD debugger — structured anomaly detection, unit traces, and LLM-guided root-cause analysis for auto-mode failures
/gsd export --html
Generate self-contained HTML report for current or completed milestone
/gsd export --html --all
Generate retrospective reports for all milestones at once
/gsd rate
Rate last unit's model tier (over/ok/under) — improves adaptive routing
/gsd changelog
Show categorized release notes
/gsd remote
Control remote auto-mode
/gsd help
Categorized command reference with descriptions for all GSD subcommands
Configuration & Diagnostics
/gsd mode
Switch workflow mode (solo/team) with coordinated defaults for milestone IDs, git commit behavior, and documentation
/gsd doctor
Runtime health checks with auto-fix — issues surface in real time across widget, visualizer, and HTML reports (v2.40)
/gsd inspect
Show SQLite DB diagnostics
/gsd init
Project init wizard — detect, configure, bootstrap .gsd/
/gsd setup
Global setup status and configuration
/gsd skill-health
Skill lifecycle dashboard — usage stats, success rates, token trends, staleness warnings
/gsd skill-health --declining
Show only skills flagged for declining performance
Milestone Management
/gsd undo-task
Reset a specific task's completion state (DB + markdown)
/gsd reset-slice
Reset a slice and all its tasks (DB + markdown)
/gsd park
Park a milestone — skip without deleting
/gsd unpark
Reactivate a parked milestone
Discard milestone
Available via /gsd wizard → "Milestone actions" → "Discard"
Parallel Orchestration
/gsd parallel start
Analyze eligibility, confirm, and start workers
/gsd parallel status
Show all workers with state, progress, and cost
/gsd parallel stop [MID]
Stop all workers or a specific milestone's worker
/gsd parallel pause [MID]
Pause all workers or a specific one
/gsd parallel resume [MID]
Resume paused workers
/gsd parallel merge [MID]
Merge completed milestones back to main
Workflow Templates (v2.42)
/gsd start
Start a workflow template (bugfix, spike, feature, hotfix, refactor, security-audit, dep-upgrade, full-project)
/gsd start resume
Resume an in-progress workflow
/gsd templates
List available workflow templates
/gsd templates info <name>
Show detailed template info
Custom Workflows (v2.42)
/gsd workflow new
Create a new workflow definition (via skill)
/gsd workflow run <name>
Create a run and start auto-mode
/gsd workflow list
List workflow runs
/gsd workflow validate <name>
Validate a workflow definition YAML
/gsd workflow pause
Pause custom workflow auto-mode
/gsd workflow resume
Resume paused custom workflow auto-mode
Extensions
/gsd extensions list
List all extensions and their status
/gsd extensions enable <id>
Enable a disabled extension
/gsd extensions disable <id>
Disable an extension
/gsd extensions info <id>
Show extension details
cmux Integration
/gsd cmux status
Show cmux detection, prefs, and capabilities
/gsd cmux on
Enable cmux integration
/gsd cmux off
Disable cmux integration
/gsd cmux notifications on/off
Toggle cmux desktop notifications
/gsd cmux sidebar on/off
Toggle cmux sidebar metadata
/gsd cmux splits on/off
Toggle cmux visual subagent splits
GitHub Sync (v2.39)
/github-sync bootstrap
Initial setup — creates GitHub Milestones, Issues, and draft PRs from current .gsd/ state
/github-sync status
Show sync mapping counts (milestones, slices, tasks)
Git Commands
/worktree (/wt)
Git worktree lifecycle — create, switch, merge, remove
Session Management
/clear
Start a new session (alias for /new)
/exit
Graceful shutdown — saves session state before exiting
/kill
Kill GSD process immediately
/model
Switch the active model
/login
Log in to an LLM provider
/thinking
Toggle thinking level during sessions
/voice
Toggle real-time speech-to-text (macOS, Linux)
Keyboard Shortcuts
Ctrl+Alt+G
Toggle dashboard overlay
Ctrl+Alt+V
Toggle voice transcription
Ctrl+Alt+B
Show background shell processes
Ctrl+V / Alt+V
Paste image from clipboard (screenshot → vision input)
Escape
Pause auto mode (preserves conversation)
CLI Flags
gsd
Start a new interactive session
gsd --continue (-c)
Resume the most recent session for the current directory
gsd --model <id>
Override the default model for this session
gsd --print "msg" (-p)
Single-shot prompt mode (no TUI)
gsd --mode <text\
json\
gsd --list-models [search]
List available models and exit
gsd --web [path]
Start browser-based web interface (optional project path)
gsd --worktree (-w) [name]
Start session in a git worktree (auto-generates name if omitted)
gsd --no-session
Disable session persistence
gsd --extension <path>
Load an additional extension (can be repeated)
gsd --append-system-prompt <text>
Append text to the system prompt
gsd --tools <list>
Comma-separated list of tools to enable
gsd --version (-v)
Print version and exit
gsd --help (-h)
Print help and exit
gsd sessions
Interactive session picker — list all saved sessions for the current directory and choose one to resume
gsd --debug
Enable structured JSONL diagnostic logging for troubleshooting dispatch and state issues
gsd config
Set up global API keys for search and docs tools (saved to ~/.gsd/agent/auth.json, applies to all projects). See [Global API Keys](./configuration.md#global-api-keys-gsd-config).
gsd update
Update GSD to the latest version
gsd headless new-milestone
Create a new milestone from a context file (headless — no TUI required)
Headless Mode
--timeout N
Overall timeout in milliseconds (default: 300000 / 5 min)
--max-restarts N
Auto-restart on crash with exponential backoff (default: 3). Set 0 to disable
--json
Stream all events as JSONL to stdout
--model ID
Override the model for the headless session
--context <file>
Context file for new-milestone (use - for stdin)
--context-text <text>
Inline context text for new-milestone
--auto
Chain into auto-mode after milestone creation
Getting Started
/gsd rethink
Conversational project reorganization
/gsd mcp
MCP server status and connectivity
Alt+V
Paste clipboard image (macOS)
gsd headless [cmd]
Run /gsd commands without TUI (CI, cron, scripts)
gsd headless query
Instant JSON snapshot — state, next dispatch, costs (no LLM)
gsd --worktree (-w)
Launch an isolated worktree session for the active milestone