Un terminale macOS basato su Ghostty con schede verticali e notifiche per agenti di programmazione AI
English | 日本語 | Tiếng Việt | 简体中文 | 繁體中文 | 한국어 | Deutsch | Español | Français | Italiano | Dansk | Polski | Русский | Bosanski | العربية | Norsk | Português (Brasil) | ไทย | Türkçe | ភាសាខ្មែរ | Українська
▶ Video demo · The Zen of cmux
## Funzionalità
Anelli di notificaI pannelli ricevono un anello blu e le schede si illuminano quando gli agenti di programmazione richiedono la tua attenzione |
|
Pannello notificheVisualizza tutte le notifiche in sospeso in un unico posto, salta alla più recente non letta |
|
Browser integratoDividi un browser accanto al tuo terminale con un'API scriptabile derivata da agent-browser |
|
Schede verticali + orizzontaliLa barra laterale mostra il branch git, lo stato/numero della PR collegata, la directory di lavoro, le porte in ascolto e il testo dell'ultima notifica. Dividi orizzontalmente e verticalmente. |
|
SSHcmux ssh user@remote crea un workspace per una macchina remota. I pannelli del browser vengono instradati attraverso la rete remota, quindi localhost funziona direttamente. Trascina un'immagine in una sessione remota per caricarla via scp.
|
|
Claude Code Teamscmux claude-teams avvia la modalità teammate di Claude Code con un solo comando. I teammate appaiono come divisioni native con metadati nella barra laterale e notifiche. Non serve tmux.
|
|
Apri il file `.dmg` e trascina cmux nella cartella Applicazioni. cmux si aggiorna automaticamente tramite Sparkle, quindi devi scaricarlo solo una volta.
### Homebrew
```bash
brew tap manaflow-ai/cmux
brew install --cask cmux
```
Per aggiornare in seguito:
```bash
brew upgrade --cask cmux
```
Al primo avvio, macOS potrebbe chiederti di confermare l'apertura di un'app da uno sviluppatore identificato. Fai clic su **Apri** per procedere.
## Perché cmux?
Eseguo molte sessioni di Claude Code e Codex in parallelo. Usavo Ghostty con un mucchio di pannelli divisi, e mi affidavo alle notifiche native di macOS per sapere quando un agente aveva bisogno di me. Ma il corpo della notifica di Claude Code è sempre solo "Claude is waiting for your input" senza contesto, e con abbastanza schede aperte non riuscivo nemmeno più a leggere i titoli.
Ho provato alcuni orchestratori di codifica, ma la maggior parte erano app Electron/Tauri e le prestazioni mi infastidivano. Inoltre preferisco semplicemente il terminale dato che gli orchestratori con interfaccia grafica ti vincolano al loro flusso di lavoro. Così ho costruito cmux come app macOS nativa in Swift/AppKit. Usa libghostty per il rendering del terminale e legge la tua configurazione Ghostty esistente per temi, font e colori.
Le aggiunte principali sono la barra laterale e il sistema di notifiche. La barra laterale ha schede verticali che mostrano il branch git, lo stato/numero della PR collegata, la directory di lavoro, le porte in ascolto e il testo dell'ultima notifica per ogni workspace. Il sistema di notifiche rileva le sequenze terminale (OSC 9/99/777) e ha un CLI (`cmux notify`) che puoi collegare agli hook degli agenti per Claude Code, OpenCode, ecc. Quando un agente è in attesa, il suo pannello riceve un anello blu e la scheda si illumina nella barra laterale, così posso capire quale ha bisogno di me tra divisioni e schede. Cmd+Shift+U salta alla più recente non letta.
Il browser integrato ha un'API scriptabile derivata da [agent-browser](https://github.com/vercel-labs/agent-browser). Gli agenti possono acquisire l'albero di accessibilità, ottenere riferimenti agli elementi, fare clic, compilare moduli e valutare JS. Puoi dividere un pannello browser accanto al tuo terminale e far interagire Claude Code direttamente con il tuo server di sviluppo.
Tutto è scriptabile attraverso il CLI e la socket API — creare workspace/schede, dividere pannelli, inviare sequenze di tasti, aprire URL nel browser.
## The Zen of cmux
cmux non prescrive come gli sviluppatori usano i propri strumenti. È un terminale e un browser con un CLI, il resto dipende da te.
cmux è una primitiva, non una soluzione. Ti dà un terminale, un browser, notifiche, workspace, divisioni, schede e un CLI per controllare tutto. cmux non ti obbliga a usare gli agenti di programmazione in un modo predefinito. Quello che costruisci con le primitive è tuo.
I migliori sviluppatori hanno sempre costruito i propri strumenti. Nessuno ha ancora trovato il modo migliore di lavorare con gli agenti, e i team che costruiscono prodotti chiusi non l'hanno trovato nemmeno loro. Gli sviluppatori più vicini alle proprie basi di codice lo troveranno per primi.
Date a un milione di sviluppatori primitive componibili e troveranno collettivamente i flussi di lavoro più efficienti più velocemente di quanto qualsiasi team di prodotto potrebbe progettare dall'alto.
## Documentazione
Per maggiori informazioni su come configurare cmux, [consulta la nostra documentazione](https://cmux.com/docs/getting-started?utm_source=readme).
## Scorciatoie da Tastiera
### Workspace
| Scorciatoia | Azione |
|----------|--------|
| ⌘ N | Nuovo workspace |
| ⌘ 1–8 | Vai al workspace 1–8 |
| ⌘ 9 | Vai all'ultimo workspace |
| ⌃ ⌘ ] | Workspace successivo |
| ⌃ ⌘ [ | Workspace precedente |
| ⌘ ⇧ W | Chiudi workspace |
| ⌘ ⇧ R | Rinomina workspace |
| ⌥ ⌘ E | Modifica descrizione del workspace |
| ⌘ B | Mostra/nascondi barra laterale |
| ⌥ ⌘ B | Mostra/nascondi barra laterale destra |
| ⌘ ⇧ E | Attiva/disattiva il focus della barra laterale destra |
### Superfici
| Scorciatoia | Azione |
|----------|--------|
| ⌘ T | Nuova superficie |
| ⌘ ⇧ ] | Superficie successiva |
| ⌘ ⇧ [ | Superficie precedente |
| ⌃ Tab | Superficie successiva |
| ⌃ ⇧ Tab | Superficie precedente |
| ⌃ 1–8 | Vai alla superficie 1–8 |
| ⌃ 9 | Vai all'ultima superficie |
| ⌘ W | Chiudi superficie |
### Pannelli Divisi
| Scorciatoia | Azione |
|----------|--------|
| ⌘ D | Dividi a destra |
| ⌘ ⇧ D | Dividi in basso |
| ⌥ ⌘ ← → ↑ ↓ | Sposta il focus direzionalmente |
| ⌘ ⇧ H | Lampeggia pannello focalizzato |
### Browser
Le scorciatoie degli strumenti di sviluppo del browser seguono i valori predefiniti di Safari e sono personalizzabili in `Impostazioni → Scorciatoie da tastiera`.
Le scorciatoie di navigazione della palette dei comandi, inclusa ⌃ P, sono anch'esse personalizzabili e possono essere cancellate in modo che la pressione raggiunga il terminale attivo.
| Scorciatoia | Azione |
|----------|--------|
| ⌘ ⇧ L | Apri browser in divisione |
| ⌘ L | Focus sulla barra degli indirizzi |
| ⌘ [ | Indietro |
| ⌘ ] | Avanti |
| ⌘ R | Ricarica pagina |
| ⌥ ⌘ I | Mostra/Nascondi Strumenti di Sviluppo (predefinito Safari) |
| ⌥ ⌘ C | Mostra Console JavaScript (predefinito Safari) |
### Notifiche
| Scorciatoia | Azione |
|----------|--------|
| ⌘ I | Mostra pannello notifiche |
| ⌘ ⇧ U | Vai all'ultima non letta |
| ⌥ ⌘ U | Attiva/disattiva lo stato non letto dell'elemento corrente |
| ⌃ ⌘ U | Segna l'elemento corrente come la non letta più vecchia e salta alla successiva più recente non letta |
### Cerca
| Scorciatoia | Azione |
|----------|--------|
| ⌘ F | Cerca |
| ⌘ ⇧ F | Cerca nella directory |
| ⌘ G / ⌥ ⌘ G | Trova successivo / precedente |
| ⌥ ⌘ ⇧ F | Nascondi barra di ricerca |
| ⌘ E | Usa selezione per la ricerca |
### Terminale
| Scorciatoia | Azione |
|----------|--------|
| ⌘ K | Cancella scrollback |
| ⌘ C | Copia (con selezione) |
| ⌘ V | Incolla |
| ⌘ + / ⌘ - | Aumenta / diminuisci dimensione font |
| ⌘ 0 | Ripristina dimensione font |
### Finestra
| Scorciatoia | Azione |
|----------|--------|
| ⌘ ⇧ N | Nuova finestra |
| ⌘ ⇧ O | Riapri sessione precedente |
| ⌘ , | Impostazioni |
| ⌘ ⇧ , | Ricarica configurazione |
| ⌘ Q | Esci |
## Build Nightly
[Scarica cmux NIGHTLY](https://github.com/manaflow-ai/cmux/releases/download/nightly/cmux-nightly-macos.dmg)
cmux NIGHTLY è un'app separata con il proprio bundle ID, quindi funziona in parallelo alla versione stabile. Compilata automaticamente dall'ultimo commit `main` e aggiornata automaticamente tramite il proprio feed Sparkle.
Segnala i bug delle nightly su [GitHub Issues](https://github.com/manaflow-ai/cmux/issues) o in [#nightly-bugs su Discord](https://discord.gg/xsgFEVrWCZ).
## Ripristino sessione
Alla chiusura, cmux salva la sessione corrente. Al riavvio, cmux ripristina lo stato
gestito dall'app:
- Layout di finestre/workspace/pannelli
- Directory di lavoro
- Scrollback del terminale (best effort)
- URL del browser e cronologia di navigazione
cmux non crea checkpoint per processi attivi arbitrari. tmux, vim, shell e app terminale
non supportate si riaprono come terminali normali.
Le sessioni degli agent supportati possono riprendere quando gli hook hanno salvato un ID
sessione nativo. Installa gli hook dopo aver installato il CLI dell'agente in modo che il suo
binario sia nel `PATH`:
```bash
cmux hooks setup
cmux hooks setup codex
cmux hooks setup --agent opencode
```
`cmux hooks setup` installa gli agent supportati che trova e stampa un riepilogo
degli agent saltati. Le integrazioni di ripristino supportate includono Claude Code, Codex,
Grok, OpenCode, Pi, Amp, Cursor CLI, Gemini, Rovo Dev, Copilot, CodeBuddy,
Factory e Qoder. Claude Code è gestito dal wrapper Claude di cmux quando l'integrazione
Claude è abilitata nelle Impostazioni.
Utenti avanzati e integrazioni possono associare un comando di ripristino personalizzato alla
surface del terminale corrente. È utile per strumenti con stato persistente proprio, come
sessioni tmux o CLI agent personalizzate:
```bash
cmux surface resume set --kind tmux --checkpoint work --shell "tmux attach -t work"
cmux surface resume show --json
cmux surface resume clear --checkpoint work
```
L'associazione resta legata alla surface di cmux. Le associazioni create dal CLI pubblico o dal
socket vengono salvate per ispezione e ripristino manuale, a meno che tu non approvi un prefisso
di comando firmato per il ripristino automatico. I prefissi approvati sono anche legati alla
directory di lavoro e ai valori esatti dell'ambiente, quando presenti. Esamina o modifica le
approvazioni in **Impostazioni > Terminale > Comandi di ripristino**. cmux esegue automaticamente
solo le associazioni di resume che marca come attendibili, per esempio quelle tmux rilevate dai
processi attivi o i prefissi approvati dall'utente. Le chiavi di ambiente sensibili, come token,
password, segreti e chiavi API, vengono scartate prima di salvare un'associazione di resume.
Per mantenere inattivi i terminali degli agent ripristinati invece di eseguire automaticamente i loro comandi di ripristino,
disattiva **Impostazioni > Terminale > Riprendi sessioni agent alla riapertura** o imposta questo in
`~/.config/cmux/cmux.json`:
```json
{
"terminal": {
"autoResumeAgentSessions": false
}
}
```
Questo disattiva solo i comandi di ripristino automatico degli agent. cmux continua a ripristinare il layout salvato,
le directory di lavoro, lo scrollback e la cronologia del browser.
Se devi riapplicare manualmente l'ultima istantanea salvata, usa:
- `File > Riapri sessione precedente`
- `⌘ ⇧ O`
- `cmux restore-session`
Internamente, cmux scrive un'istantanea versionata in
`~/Library/Application Support/cmux/` e gli hook degli agent scrivono le mappature di sessione
in `~/.cmuxterm/`. Al ripristino, cmux ricostruisce prima il layout, poi esegue il comando
di ripristino nativo dell'agent supportato quando il ripristino automatico degli agent è abilitato.
Leggi la guida completa su
WeChat: Scansiona il codice QR per unirti alla community.
