Skip to main content
cmux is available for macOS 13 (Ventura) and later. Choose your preferred installation method below. 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.Drag cmux to Applications
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: 
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