Installation & Setup

Download

Grab the latest release:

Download Latest Release

Install

1. 1. Download Muxy-<version>.dmg from the latest release.
2. 2. Double-click the DMG file to mount it.
3. 3. Drag the Muxy.app to your Applications folder.
4. 4. Double-click the Install mx CLI script in the DMG to install the command-line tool.
5. 5. Eject the DMG volume.

Dependencies

Muxy relies on three external tools. Install them before launching.

• • yabai — window management and focus routing.

  brew install koekeishiya/formulae/yabai

• • iTerm2 — process terminals. Download from iterm2.com or install via brew install --cask iterm2.
• • Google Chrome — browser sessions. Download from google.com/chrome or install via brew install --cask google-chrome.

macOS Permissions

Muxy and yabai need Accessibility permissions to manage windows.

1. 1. Open System Settings → Privacy & Security → Accessibility.
2. 2. Click the lock icon and authenticate.
3. 3. Add Muxy, yabai, and iTerm2 to the list.
4. 4. Ensure each entry has its toggle enabled.

Verify

Confirm the CLI and GUI are working:

mx --version
Muxy

The first command prints the installed version. The second launches the menu bar app.

Auto-Update

Muxy includes a built-in update checker. When a new version is available, you will see a notification in the menu bar with a link to download the update.

Uninstall

To remove Muxy completely:

rm /usr/local/bin/Muxy /usr/local/bin/mx
rm -rf ~/.muxy/