Customizing keyboard shortcuts

Solo lets you remap or disable most keyboard shortcuts to fit the way you work. Some built-in shortcuts stay fixed — things like copy, paste, quit, and basic sidebar arrow navigation can't be changed.

Accessing hotkeys settings#

1. Open Settings. The default shortcut is Cmd+, on macOS and Ctrl+, on Windows and Linux. If you remapped Open settings, use its current binding instead.
2. Go to the Hotkeys tab.

You'll see a list of every configurable command and its current binding.

While Settings > Hotkeys is open, app-level shortcuts and customizable native-menu accelerators are temporarily suspended; the platform Settings-close gesture still closes Settings.

Remapping a shortcut#

1. Find the action you want to remap.
2. Click the current binding.
3. Press the key combination you want to assign.
4. Solo saves the new binding immediately.

That's all there is to it.

Recording a key combination#

When the key recording field is active:

• Press the full key combination you want.
• Solo saves on the first valid key press.
• Press Escape to cancel without saving.
• Modifier-only presses are rejected.

Conflict warnings#

If you assign a shortcut that overlaps another action in a reachable scope, Solo warns you right away. Bindings owned by fixed commands and reserved combinations are rejected instead.

Shortcut dispatch follows scope precedence: always > global > sidebar-process > sidebar-project > sidebar > terminal. Some sidebar-project and sidebar-process shortcuts can share the same key because they apply in different contexts.

If two commands in the same scope use the same key, only the last entry in Solo's saved effective-keymap order runs. Entries saved in the same second are ordered by command ID, so do not rely on assignment order to break that tie.

Shortcuts reserved by fixed commands (copy, paste, quit, sidebar up/down navigation) can't be reassigned. Some shortcut slots are also reserved for system or platform actions.

Disabling a shortcut#

To disable a shortcut entirely:

1. Hover the current shortcut chip.
2. Click the X button.
3. The shortcut is removed for that command.

Most actions are still available from the command palette or context menus even when their shortcut is disabled.

Resetting to defaults#

To revert all customizations:

1. Click Reset all to defaults beside the search field at the top of the Hotkeys tab.
2. Confirm the reset.

All shortcuts return to their default values.

To reset a single shortcut:

1. Find a row that's been customized.
2. Click its Reset button.

Disabled rows keep a Reset button. Use it to restore that command's default binding.

Scope restrictions#

Some shortcuts only fire under certain conditions. For example, sidebar shortcuts only work when the sidebar is focused and text input is not active. Palette launch shortcuts can retarget an already-open palette, but they are blocked by modal and pane overlays. These restrictions are part of Solo's routing system and can't be changed via keybinding customization — the scope is tied to the action, not the key.

See Default keyboard shortcuts reference for which shortcuts have scope restrictions.

Persistence#

Your customizations are stored in Solo's local settings. They're not shared via solo.yml.