Keyboard Shortcuts

Complete list of keyboard shortcuts for efficient session management

Schaltwerk is designed to be driven from the keyboard. All shortcuts are available system-wide.

Quick Reference

Session Management

Shortcut	Action	Description
⌘N	Create Session	Start spec as running session
⌘⇧N	Create Spec	New markdown spec
⌘⇧R	Refine Spec	Open spec in orchestrator for refinement
⌘R	Mark Reviewed	Flag session for merge
⌘⇧M	Merge to Main	Direct merge reviewed session
⌘⇧P	Create PR	Create GitHub pull request
⌘S	Convert to Spec	Pause session, keep notes
⌘D	Cancel Session	Remove worktree
⌘⇧D	Force Cancel	Force cancel without confirmation
⌘B	Promote Version	Promote best session version
⌘Y	Reset Session	Reset session or orchestrator
⌘P	Switch Model	Open model selection dialog

Common Workflows

Review Running Sessions

1. Switch to Running filter with ⌘←/→
2. Navigate sessions with ⌘↑/↓
3. For each session:
   • ⌘G to open git diff viewer
   • Add comments if needed
   • ⌘Enter twice to accept and paste comments

Review and Test Sessions

1. Switch to Reviewed filter with ⌘←/→
2. Navigate sessions with ⌘↑/↓
3. For each session:
   • ⌘T to focus agent terminal (prompt agent to run tests)
   • OR ⌘/ to focus your terminal (test manually)
   • Review results before merging

Switch Between Project Tabs

Use ⌘⇧←/→ to jump between project tabs (e.g., frontend ↔ backend)

Quick Session Access

Use ⌘1–9 for instant session switching instead of scrolling

Customizing Shortcuts

All shortcuts can be customized in Settings → Keyboard Shortcuts:

Click Record to capture a new key combination, Reset to restore defaults, or Clear to remove a binding.

Notes

Some shortcuts may conflict with macOS system shortcuts. Check System Settings → Keyboard → Keyboard Shortcuts if they don’t work as expected.

• Common conflicts: ⌘1–9 (app switching)
• Context-aware: Some shortcuts like ⌘Enter and ⌘F behave differently based on active context (terminal, diff viewer, etc.)