singularity-forge/docs/commands.md

2 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 future milestones (safe during auto mode)
/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)