Installation

Install cmux on macOS via DMG or Homebrew

cmux is available for macOS 13 (Ventura) and later. Choose your preferred installation method below.

DMG (recommended)

The DMG installer includes auto-update via Sparkle, so you only need to download once.

1. Download cmux

   Download the latest release:

   Download cmux for macOS

2. Install the app

   Open the downloaded .dmg file and drag cmux to your Applications folder.

   
3. First launch

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

   cmux is notarized by Apple and safe to run. This dialog is standard for apps downloaded from the web.

4. Automatic updates

   cmux will automatically check for updates and notify you in the sidebar when a new version is available. Click the update pill to install.

Homebrew

Install via Homebrew Cask:

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

Updating with Homebrew

To update cmux later:

brew upgrade --cask cmux

Apps installed via Homebrew still receive in-app update notifications, but updates are managed through Homebrew.

Nightly builds

For early access to the latest features, you can download nightly builds:

Download cmux NIGHTLY

cmux NIGHTLY is a separate app with its own bundle ID, so it runs alongside the stable version. It’s built automatically from the latest main commit and auto-updates via its own Sparkle feed.

Nightly builds may contain bugs or incomplete features. Use them for testing and experimentation, not production work.

Enabling nightly updates in stable

You can also opt into nightly builds from the stable app:

1. Open Settings

   Press Cmd+, or select cmux > Settings from the menu bar.

2. Enable nightly channel

   Check the Receive Nightly Builds option in the Updates section.

3. Restart cmux

   Restart the app to check for nightly updates.

System requirements

• macOS 13.0 (Ventura) or later
• Apple Silicon or Intel Mac
• ~100 MB disk space

Ghostty configuration

cmux is compatible with Ghostty and reads your existing configuration:

~/.config/ghostty/config

If you have a Ghostty config file, cmux will automatically use your themes, fonts, colors, and keybindings. If you don’t have one, cmux uses sensible defaults.

cmux uses libghostty for terminal rendering, so all Ghostty configuration options are supported.

Verification

After installation, verify that cmux is working:

Terminal

cmux --version

If the command is not found, the CLI may not be in your PATH. You can add it manually:

ln -s /Applications/cmux.app/Contents/MacOS/cmux /usr/local/bin/cmux

Next steps

Quickstart

Get started with workspaces and notifications

CLI Reference

Explore CLI commands