Ripristino sessione in cmux

I workflow nel terminale resistono meglio alle interruzioni quando l’app può ricostruire la forma del lavoro. cmux ora tratta il layout del workspace come stato durevole, non come qualcosa legato a un singolo processo dell’app.

Il confine importante è lo stato dei processi live. cmux ripristina ciò che possiede e ciò che gli strumenti supportati espongono tramite le proprie API di ripresa. Non crea checkpoint di processi di terminale arbitrari.

Se cerchi come ripristinare le sessioni di Claude Code, OpenCode, opencode, Codex, Gemini CLI, Antigravity CLI, Grok Build CLI, Amp, Cursor CLI, Rovo Dev, Copilot, CodeBuddy, Factory, Qoder o Hermes Agent dopo un crash del terminale, installa cmux hooks e mantieni attiva la ripresa degli agenti.

Cosa torna sempre

Dopo un riavvio normale, cmux ripristina lo snapshot di sessione a livello di app:

  • Layout di finestre, workspace e pannelli
  • Directory di lavoro
  • Scrollback del terminale, al meglio possibile
  • URL del browser e cronologia di navigazione

Le sessioni degli agenti richiedono hook

Claude Code, Codex, Grok Build CLI, OpenCode, Pi, Amp, Cursor CLI, Gemini CLI, Antigravity CLI, Rovo Dev, Hermes Agent, Copilot, CodeBuddy, Factory e Qoder possono riprendere quando cmux ha un ID di sessione nativo. Per la maggior parte degli agenti, installa l'integrazione con cmux hooks setup.

cmux hooks setup

Il comando setup installa gli agenti supportati i cui binari sono su PATH e salta gli altri. Claude Code è gestito dal wrapper cmux Claude quando l’integrazione Claude è attiva in Settings.

Come funziona

cmux scrive uno snapshot JSON della sessione in Application Support con albero delle finestre, metadati del workspace, layout dei pannelli, cwd del terminale, dati di replay dello scrollback e stato di navigazione del browser.

Gli hook degli agenti scrivono le mappature di sessione in ~/.cmuxterm. Al ripristino, cmux ricostruisce prima la UI. Se la ripresa automatica degli agenti è attiva, avvia ogni agente supportato con il suo comando nativo di ripresa e l’ID sessione salvato.

Cosa resta fuori ambito

tmux, vim, shell e strumenti non supportati si riaprono come terminali normali, salvo che abbiano un’integrazione cmux che registra un comando nativo sicuro di ripresa. Così il ripristino resta prevedibile ed evita di riprodurre prompt o segreti obsoleti.

Leggi la documentazione sul ripristino sessione per comandi di setup, agenti supportati e risoluzione dei problemi.