Problem
The current keyboard shortcuts feel somewhat arbitrary and could be more intuitive. They should follow macOS conventions more closely and feel natural to someone who's never read the docs.
What needs to happen
- Audit all shortcuts — review every shortcut for consistency and discoverability
- Align with macOS conventions — follow patterns users already know from Finder, Terminal.app, Safari, Xcode
- Resolve conflicts — ensure no shortcut collides with common terminal sequences or system shortcuts
- Simplify modifiers — minimize the use of triple-modifier combos (Ctrl+Shift+key); prefer Cmd-based shortcuts
- Group logically — shortcuts for similar actions should use similar patterns (e.g., all "open X" shortcuts share a modifier)
Places to update when shortcuts change
Per CLAUDE.md, all five of these must stay in sync:
FF2App.swift (menu commands)
TerminalContainerView.swift (workspace tab handling)
HelpView.swift (shortcut reference)
README.md (shortcut table)
website/content/docs.md + translated copies (Keyboard Shortcuts section)
- Website shortcuts partial (
website/layouts/partials/shortcuts.html)
Current shortcuts for reference
Global
| ⌘N | New workstream or project |
| ⌘Shift+N | New project |
| ⌘, | Settings |
| ⌘/ | Help |
Workstream
| ⌘Return | Focus Coding Agent |
| ⌘I | Info panel |
| ⌘E | Environment |
| ⌘T | New Terminal |
| ⌘B | New Browser |
| ⌘W | Close tab |
| ⌘L | Address bar |
| ⌘0 | Back to project |
| ⌘1-9 | Switch tab |
| ⌘Shift+[ / ] | Cycle tabs |
| Ctrl+Shift+R | Rebuild setup |
| Ctrl+Shift+S | Start/restart run |
Navigation
| Ctrl+1-9 | Switch workstream |
| ⌘Shift+O | External browser |
| ⌘Shift+E | External terminal |
Problem
The current keyboard shortcuts feel somewhat arbitrary and could be more intuitive. They should follow macOS conventions more closely and feel natural to someone who's never read the docs.
What needs to happen
Places to update when shortcuts change
Per CLAUDE.md, all five of these must stay in sync:
FF2App.swift(menu commands)TerminalContainerView.swift(workspace tab handling)HelpView.swift(shortcut reference)README.md(shortcut table)website/content/docs.md+ translated copies (Keyboard Shortcuts section)website/layouts/partials/shortcuts.html)Current shortcuts for reference
Global
| ⌘N | New workstream or project |
| ⌘Shift+N | New project |
| ⌘, | Settings |
| ⌘/ | Help |
Workstream
| ⌘Return | Focus Coding Agent |
| ⌘I | Info panel |
| ⌘E | Environment |
| ⌘T | New Terminal |
| ⌘B | New Browser |
| ⌘W | Close tab |
| ⌘L | Address bar |
| ⌘0 | Back to project |
| ⌘1-9 | Switch tab |
| ⌘Shift+[ / ] | Cycle tabs |
| Ctrl+Shift+R | Rebuild setup |
| Ctrl+Shift+S | Start/restart run |
Navigation
| Ctrl+1-9 | Switch workstream |
| ⌘Shift+O | External browser |
| ⌘Shift+E | External terminal |