Lattices for Linux · Hyprland and Omarchy
Lattices on Linux is a desktop app, the lats CLI, a local host and a tray menu. One command installs it on Omarchy. Agents get the API they already use on a Mac, and a Mac and a Linux machine can share one desk.
Omarchy on Arch · Hyprland · systemd user session · x86-64 and ARM64
lattices.sock private IPCQuickshell appBun hostsystemctl --user servicesTailscale optionalInstall
Run it as your own user. The installer uses sudo only to add missing Arch packages, reports clearly when it cannot reach the desktop, and leaves older runtimes in place for recovery.
$ curl -fsSL https://raw.githubusercontent.com/lattices-dev/lattices/main/install.sh | bashInstalls missing Arch packages and Bun. Nothing runs as root except pacman.
Copies the Linux runtime into ~/.local/share/lattices. The source checkout can go afterwards.
Adds lats, lattices and lattices-host to ~/.local/bin and a launcher to the Apps menu.
Enables lattices-host and lattices-tray as systemd user services. Both start at login.
Runs lats doctor and opens the app.
Mac and Linux
The Linux host speaks the Mac daemon’s protocol: the same envelope, method names and window shapes. So a Mac can list, place, see and drive windows on a Linux machine, and lend it a cursor.
Push the Mac’s pointer past the edge that faces the Linux machine. A coral visitor appears on its screens, labelled with your Mac’s name, and your keys type there. Your own cursor never leaves, so nothing can strand it. ⌃⌥⌘ Home brings it back; Bring Cursor Home in the tray does the same from the host.
lats machines lists every machine with its build, displays and pairing. lats @archie runs a command there, and lats --host archie call windows.place moves a window on the other desk. Clicks and keys stage first and act only with treatment: "execute".
host.describe reports the platform, displays and capabilities, so clients branch on what a host has, never on its OS. Action’s remote engine, the hosts MCP toolset and the iOS companion all reach a Linux machine through the gateway.
lats gateway start --tailnetThe host listens only on private sockets. The gateway binds this machine’s Tailscale address, port 9399.
lats --host archie pairThe Mac makes a key and asks for read, screen and act. Add --drive for input, or --read-only for a viewer.
lats gateway approve <client>Check the fingerprint with lats gateway clients first. Approval only works from the host itself.
lats visit pair archie archie:9399 rightThen arrange the two machines in Workspace → Machines, the way you arrange displays.
Visits travel from a Mac to a Linux machine, or between Macs. A Linux machine receives. Remote access needs Tailscale; everything local works without it.
In the app
The Linux app is Quickshell and Qt Quick on top of the host. It keeps the Mac app’s navigation and adds the views a Hyprland desktop asks for.
Every space on a display as one continuous map with live window geometry. Zoom, inspect a space without switching to it, pick a window and place it. A preview draws the planned frame in amber before anything moves.
Save windows into named layers and switch them with In place, Auto, Columns or Master stack. Linux edits the same ~/.lattices/workspace.json the Mac app uses.
One inventory of live windows across spaces plus the windows a layer parked. Filter by title, app, window ID or layer. Enter focuses the row.
Type lats commands and read the receipts in a transcript. --dry-run previews focus, placement and space changes. The console never runs shell text.
A headless 1280 × 800 Sway desktop for agents, with a browser and a terminal preset. Watch it in a floating viewer. The physical pointer and focus stay yours.
displays.create adds a headless output; displays.remove takes only the ones the host made. Hand-made outputs stay yours unless you adopt them.
A StatusNotifierItem in Omarchy’s own tray: Bring Cursor Home, host and companion pairing status, Start and Stop Host. Nothing is written under /usr/share/omarchy.
Hold the Forward button and draw. Left and right move between existing spaces, down shows the overlay, down then left sends Enter. Super+Ctrl+G opens a tester.
The app follows Omarchy’s current colors and light or dark mode within a second. F1 opens a hints pack for Omarchy, layers, sessions and shortcuts; lats hints prints the same pack.
Requirements
Everything lands under your home directory: launchers in ~/.local/bin, the runtime in ~/.local/share/lattices, services in ~/.config/systemd/user, and backups in ~/.local/state/lattices. Saved layers, pairings and captures stay in ~/.lattices, apart from installed code.
Local first