# 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](https://cmux.com/it/download/confirmation?dl=1)

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 usarlo da altri terminali, apri la tavolozza comandi (⌘⇧P) ed esegui **Comando shell: installa 'cmux' nel PATH**. Il CLI incluso viene collegato in /usr/local/bin e, se la cartella lo richiede, viene chiesta una password da amministratore.

Oppure crea tu il 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"
```

## Imposta cmux come terminale predefinito

Per aprire in cmux, invece che in Terminale, i link ssh:// e gli script shell dal Finder, scegli **cmux > Make cmux the Default Terminal** nella barra dei menu oppure esegui **Make cmux the Default Terminal** dalla tavolozza comandi.

## 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](https://cmux.com/it/docs/session-restore) for agent hook setup and the supported resume matrix.

## Requisiti

-   macOS 14.0 o successivo
-   Mac Apple Silicon o Intel

Canonical: https://cmux.com/it/docs/getting-started

Documentation index: https://cmux.com/llms.txt