[Assem130]

Adds file search (SPEC §8.6). The change is QML and JS only and adds no dependencies.

What it adds

• Files section in root search. After Results, root search lists up to 5 matching files and folders from the home folder. Each row shows the parent folders as the subtitle and the modified date on the right.
• Search Files. A built-in command opens it, and so does a "Search All Files" action on file rows, which carries the query over. The view has a 40/60 list and detail pane. Before you type, it lists recently changed files. The pane previews images and the first 4000 characters of text and code files under 1 MB, then shows Name, Where, Type, Size and Modified.
• Actions. Open File or Open Folder (↵), Show in Files (Ctrl ↵, runs nautilus --select), and Copy Path (Ctrl Shift C).
• Learned ranking. Opening or showing a file records a frecency visit under file:<path>. Those files get a bonus of 15 × log10 of the frecency score, capped at 40.
• omacast doctor reports whether fd is installed and how many files it listed.

How it works

• There is no index and no watcher. When the launcher opens and the listing is more than 30 seconds old, fd and stat list $HOME with fixed arguments. On my machine this takes about 55 ms for about 25,000 entries. Omarchy installs fd in its base packages.
• omacast matches the query in-process, so the query never reaches an argv (ground rule 6).
• fd skips hidden and git-ignored paths. The listing also excludes node_modules, .venv, venv, __pycache__, site-packages, target, .cache and .git, for projects that are not git repositories.
• Ranking puts an exact name first, then a name prefix, a word start, a match inside the name, and a match in the path only. Newer files win ties. Every query word must match, and at least one must match the name.
• Open runs gio open instead of xdg-open. xdg-open starts a Terminal=true default such as nvim without a terminal, so the file never appears. gio opens it in a terminal and picks the same app as a double-click in Files.
• All file text in the UI uses Text.PlainText.

SPEC §8.6 planned a Rust indexer with SQLite and inotify. I noted the change of plan in SPEC §8.6 and in the CLAUDE.md status.

Related fix

Commands or the file listing can arrive after the first search answer, for example right after a reload. The selection now moves to the first row in that case, unless the user moved it. Before this change, a fast ↵ could land on the Google fallback.

Testing

• node --test tests/*.test.js passes all 151 tests, including 16 new file-search tests with expected values worked out by hand.
• omarchy plugin validate . passes.
• I tested on the live launcher (Omarchy 4.5.0, Hyprland 0.56). I checked the Files section and its selection, opening a Markdown file, a plain text file in nvim and an image, Show in Files, Copy Path, and empty queries. In the Search Files view I checked all three preview kinds, carrying the query over, and the ranking after opening a file, also after a reload.