Install & apps

Muster runs as a desktop app on macOS, Windows, and Linux, as a web app in any browser, and as thin companions on your phone. Every desktop build embeds the harness server — there is no separate server setup.

Current: v1.10.4 macOS · Windows · Linux Web app iOS / Android companions

Desktop downloads

Five artifacts, all on the download page. The download page detects your platform and moves the matching card to the top.

Platform	Artifact	Install
macOS — Apple Silicon	`Muster.dmg`	Drag to Applications.
macOS — Intel	`Muster-intel.dmg`	Same as above.
Windows (x64)	`Muster-setup.exe`	One-click, per-user, no admin rights.
Ubuntu / Debian (x64)	`Muster.deb`	`sudo dpkg -i Muster.deb`
Linux — any distro (x64)	`Muster.AppImage`	`chmod +x Muster.AppImage && ./Muster.AppImage`

Homebrew On Apple Silicon Macs, brew tap orazen/muster && brew install --cask muster installs Muster and clears the quarantine flag automatically — no Gatekeeper prompt.

The Muster CLI

One file, zero dependencies, ~40 KB. It boots the whole stack (muster up), prints the phone-pairing QR, and drives the roster from any terminal — including a VPS over SSH. Works against your local harness or Muster Cloud.

curl -fsSL https://muster.orazen.online/downloads/muster-cli.mjs -o muster
chmod +x muster
./muster help

Requires Node 22+. Every command works the same as from a checkout (node cli/muster.mjs) — up · setup · stop · logs · pair · bots · send · approve · status · receipts · sessions.

First launch on each platform

The desktop builds are unsigned while proper signing and notarization are tracked. Each platform has a one-time first-open step, not a block:

macOS — if Gatekeeper calls the app damaged, run xattr -cr /Applications/Muster.app then open it. Or right-click the app → Open.
Windows — if SmartScreen appears, choose More info → Run anyway. The installer is per-user; nothing needs admin.
Ubuntu — install the .deb with APT (sudo apt install ./Muster.deb) so desktop dependencies resolve, then launch Muster from the GNOME application launcher. The AppImage uses a static runtime and doesn't need libfuse2.

Auto-updates

Packaged desktop apps keep themselves current. On launch the app checks the update feed automatically (first check shortly after startup, then hourly — failures stay silent), and when a new build is found you get an in-app banner. Downloading is one click, and the update installs when you choose Restart to update. Nothing installs without your say-so.

Check the current version on the download page anytime; SHA-256 checksums for every artifact are listed there.

The web app

Nothing to install at all: open /app in any browser and sign up free. It's the same chat UI and roster against a hosted harness — useful from a machine you don't want to install on. For the full stack on your own server instead, see Self-hosting.

Mobile companions

iOS and Android companions are built (store listings are pending developer accounts). They're thin clients: the phone owns nothing — your computer stays the source of truth for transcripts, keys, and events, and the phone streams approvals, replies, and messages over a paired connection.

Pairing uses the same claim flow as the web console: start the server, scan the QR code it prints (or open the /claim#… link), and the phone is in as your device. Claim codes are single-use and expire after 5 minutes. Every sign-in is a tracked session — muster sessions lists them, muster sessions --revoke other kills every device but the one you're on.

System requirements

Platform	Requirement	Notes
macOS	Apple Silicon or Intel Mac	Full capability set, including on-device dictation and local screen control.
Windows	64-bit Windows	Per-user install, no admin.
Linux	Ubuntu 24.04 x64	Beta: chat, engines, approvals, cloud computers work; local screen preview, dictation, and Wayland capture are not claimed yet and fail closed without blocking anything else.
CLI (`muster` — the single-file script above, or `node cli/muster.mjs` from a checkout)	Node 22+	Any machine with Node — including a VPS over SSH.
Engines	At least one agent CLI logged in, or one API provider key	Engines appear in the picker automatically; a free-tier provider key costs nothing.

i Application data stays local in ~/.muster; the desktop app keeps its browser data and window state in the standard XDG config directory on Linux (~/.config/muster). Remove the app and that data is untouched.

Next steps

Installed? Go make your workforce: Quick start takes you from first launch to first bot. Running on a server instead — Self-hosting.