#Per iniziare

cmux è un terminale macOS nativo e leggero basato su Ghostty per gestire più agenti di codice IA. Dispone di tab verticali, un pannello notifiche e un'API di controllo basata su socket.

#Installazione

#DMG (consigliato)

Scarica per Mac

Apri il .dmg e trascina cmux nella cartella Applicazioni. cmux si aggiorna automaticamente tramite Sparkle, quindi devi scaricare solo una volta.

#Homebrew

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

Per aggiornare in seguito:

brew upgrade --cask cmux

Al primo avvio, macOS potrebbe chiederti di confermare l'apertura di un'app da uno sviluppatore identificato. Clicca su Apri per procedere.

#Verifica dell'installazione

Apri cmux e dovresti vedere:

Una finestra terminale con una barra laterale di tab verticali a sinistra
Un workspace iniziale già aperto
Il terminale Ghostty pronto per l'input

#Configurazione del CLI

cmux include uno strumento a riga di comando per l'automazione. Nei terminali cmux funziona automaticamente. Per usare il CLI al di fuori di cmux, crea un link simbolico:

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

Poi puoi eseguire comandi come:

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

#Aggiornamenti automatici

cmux verifica automaticamente gli aggiornamenti tramite Sparkle. Quando un aggiornamento è disponibile, vedrai una pillola di aggiornamento nella barra del titolo. Puoi anche controllare manualmente tramite cmux > Controlla aggiornamenti nella barra dei menu.

#Ripristino sessione (comportamento attuale)

Dopo il riavvio, cmux ripristina solo il layout e i metadati:

cmux non ripristina ancora lo stato dei processi attivi. Le sessioni di applicazioni terminale attive come Claude Code, tmux e vim non vengono riprese dopo il riavvio dell'app.

See the session restore guide for agent hook setup and the supported resume matrix.

#Requisiti

macOS 14.0 o successivo
Mac Apple Silicon o Intel