/ How it works
Contents

Chapter 2 of 9

How it works

Four steps from typing a query to landing in a directory.

  1. Local first — searches near your cwd, then home (unless --all).
  2. TUI opens immediately — results stream in while you type.
  3. Rank results — exact → prefix → contains → fuzzy. Frecency breaks ties.
  4. Jump — shell wrapper runs cd to the path you pick.
ComponentRole
jump-binRust binary — search TUI + explorer
jump.shShell wrapper — cd after selection
data.jsonHistory, pins, and frecency scores

Skipped by default: hidden dirs, node_modules, target/, build caches, IDE folders.