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.