Switching projects and commands

By default, Solo gives you numbered keyboard shortcuts for jumping directly to a visible project or process without reaching for the mouse.

Switching between projects

Default shortcut Action
Option/Alt+1 Select the first visible project
Option/Alt+2 Select the second visible project
Option/Alt+3 Select the third visible project
Option/Alt+4 through Option/Alt+9 Select visible projects 4-9

Selecting a project this way highlights the project header and moves focus to the sidebar.

Project numbers follow the current visible sidebar order. If you reorder or filter the sidebar, the numbering changes to match.

Switching between processes in the active project

Default shortcut Action
Cmd/Ctrl+1 Select the first visible process in the active project
Cmd/Ctrl+2 Select the second visible process
Cmd/Ctrl+3 Select the third visible process
Cmd/Ctrl+4 through Cmd/Ctrl+9 Select visible processes 4-9

"Processes" here includes visible commands, agents, and terminals in the active project. Normally, collapsed or filtered-out items are not counted, and nested child agents are skipped. If the currently selected process is hidden by collapsing its project, section, or parent agent; filtered out; or no longer present in the sidebar, all numbered process shortcuts are unavailable until you select a visible project or process again. Todos, scratchpads, section headers, and add rows are not included.

Practical notes

  • The shortcuts shown on this page are the default bindings. You can remap or disable any of them in Settings > Hotkeys.
  • For larger projects, Cmd+K on macOS or Ctrl+K on Windows and Linux opens the command palette, while Cmd+E on macOS or Ctrl+E on Windows and Linux opens Quick jump. These are the default bindings, and either option is often faster than memorizing numbers. Settings > Hotkeys shows the current bindings.
  • Overlays and modal UI can block these shortcuts until you dismiss them.

Are you an agent? Read this doc via API: /api/v1/docs/keyboard-shortcuts/switching-projects-commands