How search works

Type into the bar and Saiki searches your apps, commands, files, browser, settings and more at once, in one list ordered by how well each thing matches and how often you open it.

What the bar searches

Open the bar and start typing. Every letter searches all of these together:

KindWhat you findMore
ApplicationsEvery app on your MacApplications
CommandsSaiki's own commands, like Clipboard History or Saiki Settings, and window actionsWindow management
Files and foldersAnything in your home folder and iCloud Drive, by nameFiles
Open tabsYour open Chrome tabsTabs
Web pagesPages from your Chrome history and bookmarksHistory and bookmarks
SettingsSaiki's settings and the items inside System SettingsMenu items and System Settings
AnswersMath, conversions, dates and time zonesCalculator
Agent sessionsYour past and live Claude and Codex sessions, from 2 lettersAgents

Each row shows what it is at its right end, such as Application, File, Tab or Web Page.

Two rows are always last whenever you've typed something: Search Google for “…” (or your browser's default engine) and Ask Claude about “…” (or your default AI). So ↵ always does something, even when nothing else matches.

How results are ordered

The best match is at the top and already selected, so most of the time you type a few letters and press ↵.

Matching

A name scores higher the closer your letters fit it. From best to weakest:

  1. The exact name
  2. The start of the name (saf finds Safari)
  3. The start of a word, including a capital inside a name (stack finds OrbStack)
  4. Initials (vsc finds Visual Studio Code)
  5. Letters inside a word, from 2 letters
  6. Letters in order with gaps, if they line up well enough

Case and accents don't matter: cafe finds “Café”. A single letter only matches at the start of a name or word, and loose scattered letters that barely fit are left out.

What comes first

Results that arrive late, such as files found by their contents or a site's icon, never move the selection off the row you're on. ↵ always opens what you were looking at.

It learns what you open

Every time you open something, it moves up for next time. Each open counts, and the count halves about every ten days, so an old habit fades on its own.

Saiki also remembers the last three searches you opened each thing by. If you typed ter and opened Terminal, then ter puts Terminal first for the next 17 days, even if another app matches ter better.

See why a row is there

Hold ⌥ while the bar shows results. Each row's second line changes to say why it's there, for example “start of a word · picked for “ter” · opened 14× · last 2 hr. ago”. On the empty bar it says “pinned” or “suggested”. Let go of ⌥ and the rows go back to normal. Holding it never changes the order.

Change how a row ranks

Select a row, press ⌘K, and use:

These live in the main search only. See Hotkeys and aliases for aliases and hotkeys.

Words that open a scope

Some words, followed by ⇥, switch the bar to search just one thing. The bar hints what ⇥ will do, and the field shows the scope's icon and name. Press ⌫ on an empty field or esc to go back to everything.

Type, then ⇥What opens
appsThe Applications grid (also ⌘1 on the empty bar)
filesThe Files view (also ⌘2 on the empty bar)
tabsYour open Chrome tabs
search, web or ?Web search with suggestions
yt, youtube, gh…A search inside that site
menuThe menu commands of the app you were in
emojiEmoji & Symbols
agentsThe Agents hub
claude or gptA chat with that AI
~/ or /Not a word, but a path: lists that folder (⇥ completes the name)

When ⇥ has nothing else to do, it asks your default AI about what you typed. Turn that off with ⇥ asks AI in Settings → AI & Agents. See Asking and chatting.

Recent searches

Keys in the results

KeyWhat it does
↑ ↓Move the selection (⌃P and ⌃N work too)
↵ or a clickDo what the footer says for the selected row
⌘KEvery action for the selected row; type to filter them
⇥Open the scope, complete the address or path, or run an alias
⌥ (hold)Show why each row is there
escClose ⌘K, leave a scope, clear the field, then close the bar

An action's shortcut, like ⇧⌘C for Copy URL, works without opening ⌘K first.

Turned-off features leave search. When you turn a feature off in Settings, its rows and commands leave the results too. For example, with File Search off, no files show.