Command Palette

The command palette is Spruce's universal keyboard-driven opener. Press ⌘K (macOS) or Ctrl+K (Windows/Linux) from anywhere in the app to bring it up.

What it finds

• Artifacts in the current project, fuzzy-matched on title.
• Templates: every template in the project (jump straight to its definition).
• Views: every saved view, plus the By type views in the sidebar.
• Files in linked code repositories, fuzzy-matched on path.
• Commands: open a project, create an artifact, change theme, sync, switch view, run an action.

Type a few characters and the palette filters across all of them. Use ↑/↓ to move, Enter to pick, Esc to dismiss.

Command palette open with search results across artifacts and files

Common workflows

• Jump to an artifact: SPR-abc or just a few chars of the title.
• Open a file: type a partial path like api/user.ts.
• Create a feature: type "new feature" and pick the command.
• Switch project: type "open project" or the project name.
• Run an action: type the action's name (e.g. Plan, Implement, Run tests); Spruce launches it in a terminal session inside the artifact's worktree.
• View a code diff: type "diff" or part of the file path to jump straight to the diff in the artifact's Git tab.

Scoping

By default the palette searches across the current project. To jump between projects, use the project switcher in the sidebar header or search for the project name as a command.

Related

• The Sidebar — browsing rather than searching, and where the project switcher lives.
• Keyboard Shortcuts — the full shortcut table.