DocsConfiguration
Custom Shortcuts
Customize keyboard shortcuts to match your workflow
Opening Keybindings Settings#
- Open Settings (Cmd+,)
- Navigate to Keybindings
- Browse or search available commands
Changing a Shortcut#
- Find the command you want to modify
- Click the current shortcut or the empty field
- Press your desired key combination
- The shortcut is saved immediately
Shortcut Format#
Shortcuts use a modifier + key format:
| Modifier | Symbol | Key |
|---|---|---|
| Command | Cmd | ⌘ |
| Option | Option | ⌥ |
| Control | Ctrl | ⌃ |
| Shift | Shift | ⇧ |
Conflict Resolution#
If your new shortcut conflicts with an existing one:
- The conflict is highlighted
- You can either:
- Choose a different shortcut
- Override the existing binding
- Remove the conflicting shortcut first
Removing a Shortcut#
- Find the command with the shortcut
- Click the shortcut
- Press Delete or Backspace
- The shortcut is removed
Resetting to Default#
- Find the command
- Right-click or click the reset button
- Select Reset to Default
Common Customizations#
Vim-like Navigation#
| Command | Suggested Shortcut |
|---|---|
| Move line up | Ctrl+K |
| Move line down | Ctrl+J |
Emacs-like#
| Command | Suggested Shortcut |
|---|---|
| Beginning of line | Ctrl+A |
| End of line | Ctrl+E |
VS Code-like#
Many shortcuts already match VS Code defaults. Add these for consistency:
| Command | Suggested Shortcut |
|---|---|
| Toggle sidebar | Cmd+B |
| Toggle terminal | Ctrl+` |
Tips#
Use Ergonomic Combinations#
- Keep frequently used shortcuts easy to reach
- Avoid awkward modifier combinations
- Consider your keyboard layout
Group Related Commands#
- Use the same modifier for related actions
- Example: All git commands with Cmd+Shift+G+letter
Document Your Changes#
Keep a note of custom shortcuts for reference, especially if you use multiple machines.
Exporting/Importing#
Currently, shortcuts are stored per installation. To transfer:
- Export your settings from one machine
- Import on the target machine
This syncs all preferences including keybindings.
Troubleshooting#
Shortcut Not Working#
- Check for conflicts in Keybindings settings
- Verify the shortcut is saved
- Some shortcuts may be reserved by macOS
macOS System Shortcuts#
Some key combinations are reserved by macOS:
- Cmd+Space (Spotlight)
- Cmd+Tab (App Switcher)
- Ctrl+Arrow (Spaces)
Disable these in System Settings > Keyboard > Shortcuts if needed.