Opinionated Arch Linux desktop, configured as a product.
Opens with seven task guides and keeps most of its detail in other files.
This file points the agent at 10 other documents in the repository. Open any of them to read it here, as it was at this commit.
├── agents │ └── skills │ ├── │ ├── │ ├── │ ├── │ ├── │ ├── │ └── ├── default │ └── agents │ └── skills │ └── omarchy │ └── └── docs ├── └──
File measured on quattro at commit 1c8f728. Analysis written 2026-09-14. Star count is a snapshot from September 2026.
The first section is a table of links, each naming a kind of work and the guide to read before starting it. Documentation is split into three trees by audience, and a section of helper commands replaces the equivalent raw shell tools.
Quoted lines are verbatim from the file. Open one to see it where it sits.
Router files
Seven links open the file, covering command metadata, install scripts, the desktop shell, the icon font, acceptance tests, visual verification and migrations. Work that touches migrations loads the migrations guide; work that does not, does not pay for it.
Task procedure, system reference and end-user documentation each have their own directory, with the audience stated for each. The user manual carries an explicit exclusion.
A list maps project commands onto the tools they replace: a package helper rather than pacman, a notification helper rather than notify-send. The wrappers handle cases the raw commands do not.
Hard prohibitions
Commands from the default package set are stated to be runtime invariants, so presence checks around them are wrong. Presence helpers are reserved for genuinely optional dependencies and code that can run before the default set is installed, with a listed set of exceptions.
Pointing at the source of truth
The command prefix section gives common examples, then points at the array in the router as authoritative, with the stated reason that a second copy drifts.
The config refresh helper interpolates its argument into two paths and checks only for existence, so a path containing a traversal resolves and writes outside the config directory. The file states the behavior rather than describing the helper as validating.
Omarchy's file tells an agent how the codebase works. It cannot tell it which bug three customers hit this week. Modem keeps that context current and attaches it to the work.