Musarchy lets your Muse run commands on your laptop. That is the point of the project. It is also the entire risk.
Everything the muse account can do. That account is deliberately boring:
no sudo rights, no password login, a normal home directory. Your Muse can
run shell commands, read and write files, list your windows, and show
notifications as that account. It cannot touch other users' files. It cannot
install system packages. It cannot read the device credentials in
/var/lib/musegadget (root-only).
If you override the account with --run-as and pick one with sudo, your
Muse gets sudo too. The installer warns you when that is the case.
- Dedicated account. The default is a fresh
museuser, not you. Upstream's installer defaults to the installing user, which on Omarchy usually has sudo. - Service sandbox. A systemd drop-in restricts the service process
itself. Commands are unaffected. They run as the
museaccount either way. - Token storage. The SDK token lives at
/var/lib/musegadget/sdk_token, readable only by root. - Bluetooth. The installer caps the GATT MTU at 256 (the Android app
breaks above 512) and disables BlueZ's battery plugin so phones are never
asked to bond. Pairing opens only when you run the installer or
sudo musegadget pairon the machine itself.
- Physical and network trust. Pairing has no manufacturer verification. It cannot stop an active man-in-the-middle. Pair on a network you trust.
- Malicious commands. There is no allowlist. If your Muse is
compromised, or you ask it to do something destructive as the
museaccount, it can. Keep backups. - The
museaccount's own data. Anything that account can read, your Muse can read. Do not store secrets in its home directory.
Open an issue on GitHub. Do not post SDK tokens, pairing files, or logs containing them.