Solo ships with a set of default shortcuts for navigating the app, managing processes, and working in the terminal. The Hotkeys tab in Settings shows configurable shortcuts; fixed shortcuts stay outside that list.
Fixed global shortcuts
These are built in and can't be remapped.
| Shortcut | Action |
|---|---|
Cmd+C (macOS) / Ctrl+Shift+C (Windows/Linux) |
Copy selected text |
Cmd+V (macOS) / Ctrl+Shift+V (Windows/Linux) |
Paste |
Cmd+H (macOS) / Ctrl+H (Windows/Linux) |
Hide Solo (macOS) / minimize the window (Windows/Linux) |
Cmd/Ctrl+Q |
Quit Solo |
General defaults
| Shortcut | Action |
|---|---|
Cmd/Ctrl+K |
Open command palette |
Cmd/Ctrl+Shift+K |
Open the Actions palette |
Cmd/Ctrl+P |
Open quick actions for the current selection |
Cmd/Ctrl+E |
Open Quick jump |
Cmd/Ctrl+Shift+E |
Open Focus jump for unread or favorite processes |
Cmd/Ctrl+Shift+P |
Open the prompt template picker |
Cmd/Ctrl+T |
Open the new agent/terminal picker |
Cmd/Ctrl+W |
Close the selected agent or terminal |
Cmd/Ctrl+Shift+W |
Archive and close — complete the selected todo or archive the selected scratchpad, then navigate back |
Cmd/Ctrl+O |
Add a project (opens the folder picker) |
Cmd/Ctrl+, |
Open settings |
Cmd/Ctrl+Shift+U |
Check for updates |
Ctrl+Shift+Tab |
Switch to the previous workspace open in this window |
Ctrl+Tab |
Switch to the next workspace open in this window |
Cmd/Ctrl+F |
Open search for the active terminal, scratchpad, or todo; terminal search requires a visible terminal |
Cmd/Ctrl+Left |
Focus sidebar |
Cmd/Ctrl+Right |
Focus terminal |
Cmd/Ctrl+[ |
Go back in navigation history |
Cmd/Ctrl+] |
Go forward in navigation history |
Cmd/Ctrl+Shift+[ |
Jump to the previous favorite process |
Cmd/Ctrl+Shift+] |
Jump to the next favorite process |
Cmd/Ctrl+Shift+↑ / Cmd/Ctrl+Shift+↓ |
Move to the previous or next visible sidebar item |
Alt+A / Alt+C / Alt+T |
Jump directly to the Agents, Commands, or Terminals section in the active project |
Cmd/Ctrl+Shift+= |
Increase application font size |
Cmd/Ctrl+Shift+- |
Decrease application font size |
Favorite cycling visits favorites across all projects in the current workspace; see Process favorites. Workspace concepts are covered in Workspaces.
Numbered navigation
| Shortcut | Action |
|---|---|
Option/Alt+1 – 9 |
Select a visible project by its current sidebar order |
Cmd/Ctrl+1 – 9 |
Select a visible top-level process in the active project by its current sidebar order; nested agents are skipped |
Workspace switching by number (Switch to workspace 1–9) exists as a bindable action but ships unbound — assign keys in Settings > Hotkeys if you want it.
Sidebar navigation (sidebar must be focused)
| Shortcut | Action |
|---|---|
↑ / ↓ |
Move selection up or down |
← |
Collapse / move up a level |
→ |
Expand / move into a section or project |
Option/Alt+← |
Jump to the parent project header |
Option/Alt+↑ / Option/Alt+↓ |
Jump to the previous or next section or project header |
Enter |
Invoke the selected sidebar row's primary action |
Project header actions
| Shortcut | Action |
|---|---|
S |
Start auto-start commands |
A |
Start all commands |
P |
Stop all running commands |
R |
Restart running commands |
Process row actions
| Shortcut | Action |
|---|---|
S |
Start or stop the selected command, terminal, or terminal-backed agent |
R |
Restart the selected running command, terminal, or terminal-backed agent; start a trusted stopped command |
C |
Clear output for the selected command or terminal |
Terminal shortcuts
These shortcuts are global across sidebar and terminal focus. Focus and running-item navigation do not fire from ordinary text-entry controls.
| Shortcut | Action |
|---|---|
Cmd/Ctrl+← |
Move focus back to the sidebar |
Cmd/Ctrl+↑ / Cmd/Ctrl+↓ |
Switch to the previous or next running sidebar item |
Cmd/Ctrl+= |
Increase terminal font size |
Cmd/Ctrl+- |
Decrease terminal font size |
Unbound actions you can bind
Examples of actions that ship without a default shortcut are below. Assign one in Settings > Hotkeys:
- Clear terminal — clear the active terminal pane and scrollback without sending input to the process.
- Reset terminal font size — restore the terminal font to its default size.
- Switch to workspace 1–9 — jump directly to a workspace by position.
- Next / previous project group — jump between project groups in the sidebar, skipping runs of collapsed projects.
Notes
- Numbered project shortcuts follow the current visible sidebar order. Numbered process shortcuts follow visible top-level-process order and skip nested agents. Filtering can change which item is
1,2, and so on. - Most configurable shortcuts can be remapped in Settings > Hotkeys.
- Fixed shortcuts like copy, paste, hide, quit, and sidebar up/down navigation aren't editable.
- See Customizing keyboard shortcuts for remapping and disable behavior.
When shortcuts are active
Shortcut routing depends on the current UI context:
- Sidebar shortcuts require sidebar focus. Project header and process row actions additionally require the matching row type to be selected.
- Modal and pane overlays block non-always shortcuts unless a command is explicitly allowed through that overlay.
- Some global navigation shortcuts are ignored while an ordinary input, textarea, or editable text area owns the keystroke. Previous/next visible-item and running-item navigation also require an existing sidebar selection.
- App shortcuts are suspended while Settings > Hotkeys is selected. The platform's physical close gesture is the exception and remains handled by Settings or a modal above it.