Restauration de session dans cmux

Les workflows de terminal résistent mieux aux interruptions quand l’app peut reconstruire la forme de ton travail. cmux traite maintenant la disposition du workspace comme un état durable, plutôt que comme quelque chose lié à un seul processus d’app.

La limite importante est l’état des processus en cours. cmux restaure ce qu’il possède et ce que les outils pris en charge exposent via leurs propres API de reprise. Il ne crée pas de checkpoint pour des processus de terminal arbitraires.

Si vous cherchez comment restaurer des sessions Claude Code, OpenCode, opencode, Codex, Gemini CLI, Antigravity CLI, Grok Build CLI, Amp, Cursor CLI, Rovo Dev, Copilot, CodeBuddy, Factory, Qoder ou Hermes Agent après un plantage du terminal, installez cmux hooks et gardez la reprise des agents activée.

Ce qui revient toujours

Après un relancement normal, cmux restaure l’instantané de session au niveau de l’app :

• Disposition des fenêtres, workspaces et panneaux
• Répertoires de travail
• Scrollback du terminal, au mieux
• URL du navigateur et historique de navigation

Les sessions d’agents nécessitent des hooks

Claude Code, Codex, Grok Build CLI, OpenCode, Pi, Amp, Cursor CLI, Gemini CLI, Antigravity CLI, Rovo Dev, Hermes Agent, Copilot, CodeBuddy, Factory et Qoder peuvent reprendre quand cmux possède un ID de session natif. Pour la plupart des agents, installez l'intégration avec cmux hooks setup.

cmux hooks setup

La commande setup installe les agents pris en charge dont les binaires sont sur PATH et ignore les autres. Claude Code est géré par le wrapper cmux Claude quand l’intégration Claude est activée dans Settings.

Fonctionnement

cmux écrit un instantané de session JSON dans Application Support avec l’arbre des fenêtres, les métadonnées du workspace, la disposition des panneaux, le cwd du terminal, les données de relecture du scrollback et l’état de navigation du navigateur.

Les hooks d’agents écrivent des correspondances de session dans ~/.cmuxterm. À la restauration, cmux reconstruit d’abord l’UI. Si la reprise automatique des agents est activée, il lance chaque agent pris en charge avec sa commande native de reprise et l’ID de session enregistré.

Ce qui reste hors périmètre

tmux, vim, les shells et les outils non pris en charge se rouvrent comme des terminaux normaux, sauf s’ils disposent d’une intégration cmux qui enregistre une commande native de reprise sûre. Cela garde la restauration prévisible et évite de rejouer d’anciens prompts ou secrets.

Lis la documentation sur la restauration de session pour les commandes de setup, les agents pris en charge et le dépannage.