singularity-forge/gitbook/reference/keyboard-shortcuts.md
ace-pm 35dc87ef53 chore: sync workspace state after rebrand
- Rebrand commits already in history (gsd → forge)
- Sync pre-existing doc, docker, and CI config updates
- All rebrand artifacts verified in place:
  * Native crates: forge-engine, forge-ast, forge-grep
  * Log prefixes: [forge] across 22+ files
  * Binary: ~/bin/sf-run
  * Workspace scopes: @sf-run/*, @singularity-forge/*
  * Nix flake: Rust toolchain ready

System ready for: nix develop && bun run build:native

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
2026-04-15 14:54:20 +02:00

1.4 KiB

Keyboard Shortcuts

Shortcut Action
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)

Terminal Compatibility

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

{% hint style="tip" %} If Ctrl+V is intercepted by your terminal (e.g. Warp), use Alt+V instead for clipboard image paste. {% endhint %}

iTerm2 Note

If Ctrl+Alt shortcuts trigger the wrong action (e.g., Ctrl+Alt+G opens external editor instead of the dashboard), go to Profiles → Keys → General and set Left Option Key to Esc+. This makes Alt/Option work correctly with Ctrl combinations.

cmux Integration

If you use cmux (terminal multiplexer), SF can integrate with it:

Command Description
/gsd cmux status Show cmux detection and capabilities
/gsd cmux on / off Enable/disable integration
/gsd cmux notifications on/off Toggle desktop notifications
/gsd cmux sidebar on/off Toggle sidebar metadata
/gsd cmux splits on/off Toggle visual subagent splits