§ Tools

Command palette.

Cmd-K navigation across projects, phases, and pages.

The command palette is the keyboard-first way to navigate SpecGraph. Open it from anywhere with ⌘ K (macOS) or Ctrl K (Windows / Linux). The search button in the top nav opens the same panel.

What's in it #

The palette searches across:

  • Projects in the current workspace, grouped by their owning workspace if you belong to more than one
  • Phases within the project you're currently viewing (jump straight to P-04 without going via the rail)
  • Navigation shortcuts — Dashboard, Portfolio, Knowledge Base, Team, Settings
  • Theme toggle — flip between light and dark
  • Workspace switcher — every workspace you belong to

Results are fuzzy-matched on every word in the query. Typing arch matches "Technical Architecture"; typing port matches "Portfolio."

Keyboard #

KeyAction
⌘ K / Ctrl KOpen the palette from anywhere
/ Move selection up / down
EnterRun the selected action / open the selected page
EscClose

You can also click any result with the mouse.

What it doesn't do #

  • Run actions other than navigation. Locking a phase, accepting a wish, etc., aren't in the palette — they live on the surfaces that own them. The palette is for getting somewhere, not doing something.
  • Search across content. It searches names and labels, not the body of phase content. To find a string inside a project, open the project and use the browser's ⌘ F.
  • Show things you can't access. Restricted projects don't appear in your palette unless you're on their allowlist. Sensitive KB entries don't appear without a grant.

Why it exists #

After about three projects, scrolling the dashboard to find one becomes annoying. The palette is the fix — most return visits to a project should take two keypresses (⌘ K then a few letters) and one Enter.