Installation

AgentMux is available for Windows, macOS, and Linux. The Windows portable package is around 148 MB; the Linux AppImage is around 200 MB. Runtime memory is 150–350 MB depending on session activity.

AgentMux bundles its own Chromium runtime via CEF — there is no system dependency on WebKitGTK or any other browser engine. A standard desktop installation of any supported OS is enough.

macOS (Apple Silicon)

Download the .dmg installer from agentmux.ai or GitHub Releases.

Open the .dmg file.
Drag AgentMux to your Applications folder.
Launch from Applications or Spotlight.

The macOS build is code-signed and notarized.

Windows

Three options available from agentmux.ai:

Installer (.exe)

Download AgentMux_x64-setup.exe and run the Inno Setup installer. Default install location is %LOCALAPPDATA%\AgentMux.

Portable (.zip)

Download agentmux-x64-portable.zip and extract anywhere. No installation required — run AgentMux.exe directly. Ideal for testing a new build alongside an installed version (each instance is fully isolated; see Multi-instance & dev mode).

MSIX

Download AgentMux_x64.msix for Windows-Store-style installation. Sandboxed install (no UAC prompt), uses the same stable data channel as the installer so agents and settings carry over if you switch. Automatic updates require a Store listing — direct .msix downloads must be updated manually.

Note: not yet published to the Store; the MSIX package is available directly from GitHub Releases in the meantime. Store listing is planned for a future release. See Update model for full details on how each distribution receives updates.

Linux

AppImage

# Download
curl -LO https://agentmux.ai/releases/latest/AgentMux_amd64.AppImage

# Make executable
chmod +x AgentMux_amd64.AppImage

# Run
./AgentMux_amd64.AppImage

On first launch the AppImage extracts itself to ~/.local/share/agentmux/extracted/<version>/ (~2–3 s one-time). Subsequent launches start in ~1 s from the cached copy.

FUSE required (for the compressed SquashFS mount). Pre-installed on most desktop distros. If absent: ./AgentMux_amd64.AppImage --appimage-extract && squashfs-root/AppRun

.deb (Debian/Ubuntu)

A .deb package is available from GitHub Releases:

sudo dpkg -i AgentMux_amd64.deb
agentmux

Requirements

Display server: X11 or Wayland. Defaults to XWayland (--ozone-platform=x11); set AGENTMUX_OZONE_PLATFORM=wayland for native Wayland (experimental).
glibc 2.31+ (Ubuntu 20.04 / Debian 11 or newer)

No other system dependencies — AgentMux bundles its own Chromium runtime.

Verify Installation

After launching AgentMux, you should see the workspace with a default terminal pane and the widget bar at the top right. The widget bar lists every pinned widget — Agent, Browser, Terminal, Sysinfo, Editor, Swarm, Drone, Help, Warden — and collapses to icon-only when the title bar is narrow. Settings and DevTools are not widgets; both live in the hamburger menu (≡) at the top of the tab bar.

Next Steps

First Agent Setup — Connect your first AI agent
Configuration — Customize your settings