Omarchy × Muse
Your laptop,
reachable from your Muse.
Musarchy connects an Omarchy laptop to your Muse. Pair once in the Muse app. Then your Muse can run commands on the laptop, move files, check its health, list your open windows, and show notifications on your screen. From your phone.
Alpha. The installer has not run on live hardware yet. See the setup guide.
How it works
- Install Omarchy 4 on the laptop, from the official ISO.
- Run the musarchy installer. It sets up the device agent,
creates a locked-down
museaccount for it, and starts the service. - Pair in the Muse app. Settings → Devices → Developer mode → Add Device. It reconnects on its own after reboots.
What your Muse can do
| Command | What it does |
|---|---|
system.run | Run a shell command. Returns stdout, stderr, exit code. |
file.read / file.write | Read and write files in chunks. |
device.health | Uptime, load, memory, disk, temperature. |
desktop.run | Run a command inside your graphical desktop session. |
desktop.windows | List open windows: app, title, workspace, focus. |
desktop.notify | Show a notification on your screen. |
Not a fork
Musarchy is a layer, not a fork. Omarchy stays stock. Meta's device SDK stays pinned to one upstream commit. Musarchy is the glue between them: an installer ported to Arch, a plugin that adds the desktop commands, and a hardened service setup.
Security in one paragraph
Your Muse gets the permissions of the muse account: no sudo,
no password login, no access to your files. There is no command allowlist.
If you ask it to do something destructive as that account, it can. Pair on
a network you trust. The full model is in
docs/SECURITY.md.