Getting Started

cmux is a lightweight, native macOS terminal built on Ghostty for managing multiple AI coding agents. It features vertical tabs, a notification panel, and a socket-based control API.

Install

DMG (recommended)

Download for Mac

Open the .dmg and drag cmux to your Applications folder. cmux auto-updates via Sparkle, so you only need to download once.

Homebrew

brew tap manaflow-ai/cmux
brew install --cask cmux

To update later:

brew upgrade --cask cmux

On first launch, macOS may ask you to confirm opening an app from an identified developer. Click Open to proceed.

Verify installation

Open cmux and you should see:

A terminal window with a vertical tab sidebar on the left
One initial workspace already open
The Ghostty-powered terminal ready for input

CLI setup

cmux includes a command-line tool for automation. Inside cmux terminals it works automatically. To use the CLI from outside cmux, create a symlink:

sudo ln -sf "/Applications/cmux.app/Contents/MacOS/cmux" /usr/local/bin/cmux

Then you can run commands like:

cmux list-workspaces
cmux notify --title "Build Complete" --body "Your build finished"

Auto-updates

cmux checks for updates automatically via Sparkle. When an update is available you'll see an update pill in the titlebar. You can also check manually via cmux → Check for Updates in the menu bar.

Requirements

macOS 14.0 or later
Apple Silicon or Intel Mac