Documentation
Four trees: the haus layer your Mac is built on, and the small native apps that live inside it and mostly run fine without it.
A Mac you can describe in one file and rebuild from it on any machine you own, and the small native tools that live inside it. Two kinds of thing are documented here: the layer, and the apps.
haus
The layer. One file describes your Mac, one command makes the Mac match it: apps, windows, the bar, the shell, the colours. Twelve rooms you turn on and off.
pounce
The launcher you teach. One keypress, your apps and your own commands in one list, and a command is just a shell script in a folder. Free, MIT, no Nix required.
perch
The shelf in the notch. Start dragging, flick up, and a shelf drops down to catch it, then carry the lot somewhere else in one motion. One brew command, no permissions.
trill
Notifications, filtered. In the incubator: nothing to install yet, and this page says what it is rather than what it does.
haus is the machinery; the rest are things that run on it, and run perfectly well on a Mac that has never heard of it. pounce and perch install from Homebrew with no Nix anywhere, and haus can install either for you instead. trill installs from nowhere yet: it is in the incubator, and its page says so before it says anything else.
The switcher at the top of the sidebar moves between the trees, and its glyph tells you which one you're reading at a glance: the layer, the launcher, the shelf, the compositor.
Looking for a desktop (hacker and the rest)? A desktop is a set of values for haus's own options rather than a project of its own, so it is documented with the layer: choosing one compares the four, and each has a page of its own: hacker, everyday, minimal.
Reading this with an AI tool? These docs publish themselves in machine-readable
form: /llms.txt is a table of contents with one-line
descriptions, for something that fetches selectively, and
/llms-full.txt is every page inlined, for something that
would rather read the lot. On a machine that already has haus, prefer the haus
skill; it is generated from the revision you actually run.
Changing your Mac with an agent covers it.