omafiles GitHub

The file explorer Omarchy was missing.

A modern, keyboard-first explorer built for omarchs. Serve a directory in a keystroke, ask an agent about a file, read a diff where the preview goes, find by name and content in one window. It runs on Omarchy's own scripts and tokens, so it looks and behaves like the rest of your desktop.

Install Read the source
why

Why another file explorer?

“We can fix everything.”

The spirit this whole thing runs on.

The macOS explorer has felt outdated for ten years now: the same window, the same limits, nothing that reads as modern. The Linux explorers, capable as they are, lack just a little ambition and visual customization to really fit on Omarchy. They stay too inspired by Apple's and Microsoft's, instead of providing the features that make a developer's life easier.

omafiles starts from the other end: serve a directory in a keystroke, ask an agent about a file, read a diff where a preview goes, find by name and content in one window. And it does all of it through Omarchy's own scripts and tokens, so it feels like part of the system rather than a guest.

features

Everything is a keystroke.

Vim-ish movement, key contexts per pane, a command palette, and a keymap you can rebind from a TOML file. The mouse gets the same verbs, never more.

findOne window for everything below here: recent files when empty, fuzzy names as you type, then content matches via ripgrep, deduplicated./
previewImages, video posters, markdown, and code through tree-sitter. Colored by your palette, expandable over the listing, browsable with j and k.space
gitBranch and change counts in the status bar, markers on entry icons, and a changed file previews as its diff, rendered as the file rather than the patch.^⇧g
serveServe any directory over HTTP in one keystroke. Servers are detached processes: close the window, they keep answering. A globe lists them all.^s
actTerminal here, agent chat about a file, share via LocalSend, copy, paste, zip. All through Omarchy's own scripts, so your defaults hold.t a s z
vertical tabsTabs live in the sidebar, the way modern tools stack them. Each carries its own history and cursor, and everything restores across restarts and syncs across windows.^t
workspacesGroup tabs by project in the sidebar. Drag tabs between groups, collapse a group you are not in, and the one holding your active tab lights up.^n
networkSMB, SFTP, WebDAV through GVfs. A mount is just a directory: the listing, preview and search browse it with no special cases.^⇧n
paletteEvery action by name with its effective binding, including the ones you rebound in keymap.toml.^k
facts

Small, native, honest.

A Rust workspace of three crates: pure token logic, a gpui design system, and the app. The token resolver is conformance-tested against Omarchy's own tooling on all 22 stock themes.

omafiles.toml
[omafiles]
language = "Rust"
ui       = "gpui"          # the toolkit Zed is built on
themes   = 22              # every stock Omarchy theme, live
tests    = 222
license  = "MIT"
keymap   = "~/.config/omafiles/keymap.toml"
install

Install it on your Omarchy.

A prebuilt pacman package for x86_64: one binary, a .desktop entry, and opt-in snippets for the SUPER+SHIFT+F takeover. Nothing writes into your home directory unasked.

❯ curl -LO https://github.com/aloisdeniel/omafiles/releases/latest/download/omafiles-0.0.1-1-x86_64.pkg.tar.zst
❯ sudo pacman -U omafiles-0.0.1-1-x86_64.pkg.tar.zst

Then open it from the launcher, or bind SUPER+SHIFT+F using the snippet in contrib. Prefer to build it yourself? git clone the repo and run makepkg -si in contrib.