Muxie Get Muxie
Getting started How-to guide

Install Muxie

Download a build for Linux, macOS, or Windows, or build from source. The durable daemon comes bundled — there's nothing else to install.

Muxie ships as a single download per platform. The durable daemon (muxied) and the Ghostty terminal engine are bundled inside the app, so there is nothing else to install and no system terminal required.

Tip: Grab the latest builds from the Releases page.

Linux

Muxie ships as a portable AppImage (x64 and arm64), with .deb and .rpm packages also available on the Releases page.

# download the AppImage from Releases, then:
chmod +x Muxie-*.AppImage
./Muxie-*.AppImage

The AppImage carries the daemon with it. Secrets (such as saved SSH passwords) are stored through your desktop’s secret service — libsecret or KWallet — when one is available.

Note: On KDE and GNOME Wayland sessions, the dock icon resolves from an installed .desktop entry rather than the icon embedded in the AppImage. If you run the AppImage directly and the dock shows a generic icon, install the desktop entry and icon into ~/.local/share/.

macOS

Download the notarized DMG (a universal build for Apple Silicon and Intel), open it, and drag Muxie to Applications. Secrets are stored in the macOS Keychain. Requires macOS 12 Monterey or newer.

Windows

Run the x64 installer. PTYs are created through Windows ConPTY, and secrets are stored with DPAPI. Requires Windows 10 or 11.

Build from source

Muxie is an Electron app with a Go daemon. To run the same workspace the release binaries are cut from:

# clone & install (postinstall rebuilds native node-pty)
git clone https://github.com/vaurdan/cmux-linux
cd cmux-linux && pnpm install

# launch the workspace in development
pnpm dev

# build a distributable for your platform
pnpm build && pnpm dist

You’ll need:

  • Node 22+ and pnpm
  • A Go toolchain (to build the durable daemon)
  • Platform build tools for native modules (the pnpm install postinstall step runs electron-rebuild for node-pty)

Updating

Release builds pull signed updates, so you stay current without re-downloading by hand. After a notable upgrade, the What’s New pane opens to show what changed.

Next

Open Muxie and follow the Quick start to create your first durable session.