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)

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:

  • Layout di finestre, workspace e pannelli
  • Directory di lavoro
  • Cronologia del terminale (best effort)
  • URL del browser e cronologia di navigazione
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.

Requisiti

  • macOS 14.0 o successivo
  • Mac Apple Silicon o Intel