singularity-forge/docs/commands.md
Tom Boucher 330e5200bc docs: add v2.18/v2.19 feature documentation (#631)
New docs:
- dynamic-model-routing.md — complexity classification, tier models,
  escalation, budget pressure, cost table, adaptive learning
- captures-triage.md — fire-and-forget capture, triage pipeline,
  classification types, dashboard integration, worktree awareness
- visualizer.md — four-tab TUI overlay (progress, deps, metrics,
  timeline), controls, auto-refresh, auto_visualize preference

Updated docs:
- README.md — added links to three new docs
- commands.md — added capture, triage, visualize, knowledge, queue reorder
- configuration.md — added dynamic_routing and auto_visualize settings,
  updated full example with new config options
- auto-mode.md — added capture, visualize sections, dashboard badge,
  dynamic model routing reference
- architecture.md — updated dispatch pipeline (routing + captures steps),
  added key modules table for v2.19
- cost-management.md — added dynamic routing and visualizer tips
2026-03-16 09:00:58 -06:00

2.4 KiB

Commands Reference

Session Commands

Command Description
/gsd Step mode — execute one unit at a time, pause between each
/gsd next Explicit step mode (same as /gsd)
/gsd auto Autonomous mode — research, plan, execute, commit, repeat
/gsd stop Stop auto mode gracefully
/gsd steer Hard-steer plan documents during execution
/gsd discuss Discuss architecture and decisions (works alongside auto mode)
/gsd status Progress dashboard
/gsd queue Queue and reorder future milestones (safe during auto mode)
/gsd capture Fire-and-forget thought capture (works during auto mode)
/gsd triage Manually trigger triage of pending captures
/gsd visualize Open workflow visualizer (progress, deps, metrics, timeline)
/gsd knowledge Add persistent project knowledge (rule, pattern, or lesson)
/gsd prefs Model selection, timeouts, budget ceiling
/gsd migrate Migrate a v1 .planning directory to .gsd format
/gsd doctor Validate .gsd/ integrity, find and fix issues

Git Commands

Command Description
/worktree (/wt) Git worktree lifecycle — create, switch, merge, remove

Session Management

Command Description
/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

Shortcut Action
Ctrl+Alt+G Toggle dashboard overlay
Ctrl+Alt+V Toggle voice transcription
Ctrl+Alt+B Show background shell processes
Escape Pause auto mode (preserves conversation)

Note: In terminals without Kitty keyboard protocol support (macOS Terminal.app, JetBrains IDEs), slash-command fallbacks are shown instead of Ctrl+Alt shortcuts.

CLI Flags

Flag Description
gsd Start a new interactive session
gsd --continue (-c) Resume the most recent session for the current directory
gsd config Re-run the setup wizard (LLM provider + tool keys)