One window. Every place.
Milo opens once and holds everything: Home, the work, your mind, your spaces, the things you make, Milo's own work and its settings. You move between places in one rail. Only a pop-up tied to what is on screen may float.
"One dash with all of these functions … and then special instances where there is a modal or something that is contextual to what's on screen."
James, 2026-09-26 (spelling tidied). Five rules turn that sentence into a system, and a test in the product fails when a new surface breaks them.
- 01One window. Every place is a page of the Milo window. No place is its own window.
- 02Spaces are driven by keys or from the window. The keys switch spaces; the Spaces place names, sorts and shows them. There is no third way.
- 03Only contextual pop-ups float. Each is tied to something on screen — the timer running now, the words just said, one line typed over your work — and carries one line on why it cannot be a page.
- 04Layers sit under or before everything. The desktop art and the first run are not places, so they are not in the window.
- 05Everything else is moving in. A surface that still opens on its own is a debt with a named destination, not a design.
The rail is the map of the product.
Seven groups, two levels at most, one content area. Home leads with one statement: what matters now.
- HomeThe dashboard: one statement, Milo's state, your day, Milo's work, what needs you
- WorkToday · Tasks · Goals · Projects · Calendar · Inbox · Review
- MindMap · Notes · What Milo knows (45)
- SpacesEvery space, its agents, machines and their files
- MakeDesign · Studio · Websites
- MiloConversation · Skills and helpers · Activity · Spend
- SettingsSettings (ten sections, one at a time) · Learn
- ● offline · on this machine — the rail's foot, in Moss: local, and nothing else
Top bar: Milo / <place> · the Moss "local" mark · Search · Ask Milo · Voice · Dark · Close. Search replaces a second index: every place is already in the rail.
Six more places, as the product draws them
Drawn by the installed build on wkgd-macbook, 1280 × 800, copied from offline-os docs/evidence/screens/2026-09-26-install/ and web-sized. Records: assets/product/manifest.json.
A pop-up must be tied to what is on screen.
Five things float, and each says why it cannot be a page. Everything else opens in the window.
| Pop-up | Tied to | Why it floats |
|---|---|---|
| TimeTime card | the timer running now | Drops from the timer's bar item, goes at the first click elsewhere (46) |
| Voice pill | the words you are saying | Low over your work while you speak; never takes the keyboard; leaves once read (11) |
| Ask Milo sheet | whatever is on screen | A sheet on the right edge so your work stays visible beside it; the same conversation as Milo › Conversation |
| Quick capture | the line you want to keep | One line typed over your work, then gone — capture must not pull you into the window |
| Notices | Milo speaking first | Rarely, through Omarchy's own notifier, so it reaches you whatever is on screen |
How Milo appears is the person's choice
Decided 2026-08-29 and asked once, in the first run (47). The Ask key opens whichever was chosen.
Just your voice
A small presence that shows it is listening. Voice is the real interface.
A type bar
One line, centred; everything dims behind it. Fast.
A side panel
Slides in at one side and stays while you work.
Full screen
Your work recedes. A deliberate change of mode.
Under the window, and before it.
Three layers belong to no place: the desktop picture, its glyphs, and the first run.
- L1Live art. The picture on the desktop, breathing, under every window — the ground the whole system sits on.
- L2The glyph layer. Characters over the still picture, under every window. Its design is the Wallpaper section's.
- L3The first run. Before the window exists for you; it sets the system up once, then "Redo setup" lives in Settings (47).
Every key opens a place or a pop-up.
One way in: offline open <place>. Every key, menu row, notice and spoken "go to" uses it.
The key map on Omarchy
| Key | Opens |
|---|---|
| SUPER + D | Milo at Home |
| SUPER + N | Work › Today, the focus task |
| SUPER + A | Work › Goals |
| SUPER + Y | Work › Calendar |
| SUPER + B | Mind |
| SUPER + ALT + P | Spaces (the desktop keys still switch spaces) |
| SUPER + SHIFT + V | Milo › Activity |
| SUPER + E | Milo, with search in focus |
| SUPER + SHIFT + L | Settings › Learn |
| SUPER + ALT + W | Settings, the wallpaper editor docked to the right edge |
| SUPER + I | Quick capture (pop-up) |
| SUPER + M | Ask Milo sheet (pop-up) |
| SUPER + R | Talk to Milo — the voice pill (pop-up) |
| SUPER + ALT + T | TimeTime card (pop-up) |
From offline-os docs/SYSTEM-HIERARCHY.md §4, 2026-09-26. These replace the earlier binds on 13 Omarchy.
Tidy enough for a store.
An installable product, released on Omarchy first and the Mac App Store last, with one engine behind every client.
James, 2026-09-26: "It needs to be extremely tidy and created according to AAA and iOS store standards." Then: "Apple is last … Omarchy Linux Arch standards for release, that's the first place we would start."
- 01Release order. Omarchy, as an Arch package (the AUR, then Omarchy's own Install menu) · other Linux and marketplaces · the Mac App Store last.
- 02One product. One window, one navigation model, one component set; every colour, space, radius and duration from these tokens.
- 03WCAG 2.2 AAA where it can be met. Body text 7:1, 44 px targets, focus clearly visible, no time limits, motion off under reduced motion (15).
- 04One voice in every word on screen (21); no internal ids shown.
- 05One engine, many clients. The Omarchy shell, a Mac client and the web client all speak to the same engine and wear the same tokens and the same traced mark (28.00).
- 06Local first. It works with no account and no network; an account adds sync and the hosted tier.
The hosted tier's engineering is recorded in offline-os docs/adr/0001–0007; this page keeps only what the brand must hold: the same mark and tokens on every client.
REF: https://developer.apple.com/design/human-interface-guidelines/sidebars · https://wiki.archlinux.org/title/AUR_submission_guidelines · https://omarchy.org/manual/other-packages/ · https://www.w3.org/TR/WCAG22/ · https://developer.apple.com/app-store/review/guidelines/