Restauração de sessão no cmux

Fluxos de terminal resistem melhor a interrupções quando o app consegue reconstruir a forma do seu trabalho. O cmux agora trata o layout do workspace como estado durável, não como algo preso a um único processo do app.

A fronteira importante é o estado de processos vivos. O cmux restaura o que ele controla e o que ferramentas compatíveis expõem por suas próprias APIs de retomada. Ele não cria checkpoints de processos arbitrários do terminal.

Se você está procurando como restaurar sessões do Claude Code, OpenCode, opencode, Codex, Gemini CLI, Antigravity CLI, Grok Build CLI, Amp, Cursor CLI, Rovo Dev, Copilot, CodeBuddy, Factory, Qoder ou Hermes Agent após uma falha do terminal, instale cmux hooks e mantenha a retomada de agentes ativada.

O que sempre volta

Depois de uma reinicialização normal, o cmux restaura o snapshot de sessão no nível do app:

• Layout de janelas, workspaces e painéis
• Diretórios de trabalho
• Scrollback do terminal, no melhor esforço
• URL do navegador e histórico de navegação

Sessões de agentes precisam de hooks

Claude Code, Codex, Grok Build CLI, OpenCode, Pi, Amp, Cursor CLI, Gemini CLI, Antigravity CLI, Rovo Dev, Hermes Agent, Copilot, CodeBuddy, Factory e Qoder podem retomar quando o cmux tem um ID de sessão nativo. Para a maioria dos agentes, instale a integração com cmux hooks setup.

cmux hooks setup

O comando setup instala agentes compatíveis cujos binários estão no PATH e ignora o restante. O Claude Code é tratado pelo wrapper cmux Claude quando a integração Claude está ativada em Settings.

Como funciona

O cmux grava um snapshot JSON de sessão em Application Support com árvore de janelas, metadados do workspace, layout de painéis, cwd do terminal, dados de replay do scrollback e estado de navegação do navegador.

Agent hooks gravam mapeamentos de sessão em ~/.cmuxterm. Ao restaurar, o cmux reconstrói primeiro a UI. Se a retomada automática de agentes estiver ativada, ele inicia cada agente compatível com o comando nativo de retomada e o ID de sessão salvo.

O que fica fora do escopo

tmux, vim, shells e ferramentas sem suporte reabrem como terminais normais, a menos que tenham uma integração cmux que registre um comando nativo seguro de retomada. Isso mantém a restauração previsível e evita reproduzir prompts ou segredos antigos.

Leia a documentação de restauração de sessão para comandos de setup, agentes compatíveis e solução de problemas.