54 lines
2 KiB
Markdown
54 lines
2 KiB
Markdown
# 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) |
|