Indexing Files

Indexing Files

Where can search the files in folders you choose. It never looks anywhere else.

Add a folder

Settings → Indexed folders → Add a folder, or Ctrl K → Index a folder. To put the folder in a project (so its files show up with that project's tasks and notes), find the folder in Where, open it and use Move to a project. From the Command Line: where-cli index <folder> -p <project>.

What Where reads

For each file: name, path, type, size, dates and a fingerprint (BLAKE3 hash) to notice changes. Pictures and videos are recognised as such.

Where does not read what's inside your files (yet). It never moves, changes, deletes or uploads them.

What's skipped

• Hidden files and folders (names starting with .)
• Folders that are almost always clutter: node_modules, target, build, dist, .git, __pycache__, .dart_tool, Pods
• Very large files are listed but not fingerprinted

Keeping it up to date

Where doesn't watch your folders in the background. When things change, click Refresh all (Settings or Files page). Refreshing is fast: unchanged files are skipped, and files you deleted from disk disappear from Where.

Removing a folder

There's no one-click remove folder button yet (Roadmap). Until then, open the folder in Where and choose Remove from Where. That only affects Where. Your real files stay exactly where they are.

Tips

• Index project folders (e.g. Documents\Website), not your whole drive. Results stay useful and indexing stays quick.
• Files has a filter box (Filter by name or path…) and a Show in folder button for each file.