Przywracanie sesji w cmux

Przepływy pracy w terminalu lepiej znoszą przerwy, gdy aplikacja potrafi odtworzyć kształt pracy. cmux traktuje teraz układ workspace jako trwały stan, a nie coś powiązanego z jednym procesem aplikacji.

Ważną granicą jest stan działającego procesu. cmux przywraca to, co posiada, oraz to, co obsługiwane narzędzia udostępniają przez własne API wznawiania. Nie tworzy checkpointów dowolnych procesów terminala.

Jeśli szukasz sposobu na przywrócenie sesji Claude Code, OpenCode, opencode, Codex, Gemini CLI, Antigravity CLI, Grok Build CLI, Amp, Cursor CLI, Rovo Dev, Copilot, CodeBuddy, Factory, Qoder lub Hermes Agent po awarii terminala, zainstaluj cmux hooks i pozostaw wznawianie agentów włączone.

Co zawsze wraca

Po normalnym ponownym uruchomieniu cmux przywraca migawkę sesji na poziomie aplikacji:

  • Układ okien, workspace i paneli
  • Katalogi robocze
  • Scrollback terminala, najlepiej jak się da
  • URL przeglądarki i historia nawigacji

Sesje agentów wymagają hooks

Claude Code, Codex, Grok Build CLI, OpenCode, Pi, Amp, Cursor CLI, Gemini CLI, Antigravity CLI, Rovo Dev, Hermes Agent, Copilot, CodeBuddy, Factory i Qoder mogą zostać wznowione, gdy cmux ma natywny identyfikator sesji. Dla większości agentów zainstaluj integrację poleceniem cmux hooks setup.

cmux hooks setup

Polecenie setup instaluje obsługiwanych agentów, których binaria są na PATH, i pomija resztę. Claude Code obsługuje wrapper cmux Claude, gdy integracja Claude jest włączona w Settings.

Jak to działa

cmux zapisuje migawkę sesji JSON w Application Support z drzewem okien, metadanymi workspace, układem paneli, cwd terminala, danymi odtwarzania scrollbacku i stanem nawigacji przeglądarki.

Hooks agentów zapisują mapowania sesji w ~/.cmuxterm. Podczas przywracania cmux najpierw odbudowuje UI. Jeśli automatyczne wznawianie agentów jest włączone, uruchamia każdego obsługiwanego agenta jego natywnym poleceniem resume i zapisanym ID sesji.

Co jest poza zakresem

tmux, vim, powłoki i nieobsługiwane narzędzia otwierają się ponownie jako zwykłe terminale, chyba że mają integrację cmux zapisującą bezpieczne natywne polecenie resume. Dzięki temu przywracanie jest przewidywalne i nie odtwarza starych promptów ani sekretów.

Przeczytaj dokumentację przywracania sesji, aby poznać polecenia setup, obsługiwanych agentów i rozwiązywanie problemów.