cmux의 세션 복원

앱이 작업의 형태를 다시 만들 수 있으면 터미널 워크플로는 중단에 더 강해집니다. cmux는 이제 워크스페이스 레이아웃을 하나의 앱 프로세스에 묶인 임시 상태가 아니라 지속 상태로 다룹니다.

중요한 경계는 실행 중인 프로세스 상태입니다. cmux는 자신이 소유한 것과 지원 도구가 자체 resume API로 노출하는 것을 복원합니다. 임의의 터미널 프로세스를 체크포인트로 저장하지는 않습니다.

터미널 충돌 후 Claude Code, OpenCode, opencode, Codex, Gemini CLI, Antigravity CLI, Grok Build CLI, Amp, Cursor CLI, Rovo Dev, Copilot, CodeBuddy, Factory, Qoder 또는 Hermes Agent 세션을 복원하는 방법을 찾고 있다면 cmux hooks를 설치하고 에이전트 재개를 켜 두세요.

항상 돌아오는 것

일반적인 재시작 후 cmux는 앱 수준 세션 스냅샷을 복원합니다.

• 창, 워크스페이스, 패널 레이아웃
• 작업 디렉터리
• 터미널 스크롤백, 최선 노력 방식
• 브라우저 URL과 탐색 기록

에이전트 세션에는 hooks가 필요합니다

Claude Code, Codex, Grok Build CLI, OpenCode, Pi, Amp, Cursor CLI, Gemini CLI, Antigravity CLI, Rovo Dev, Hermes Agent, Copilot, CodeBuddy, Factory, Qoder는 cmux가 네이티브 세션 ID를 가지고 있을 때 재개할 수 있습니다. 대부분의 에이전트는 cmux hooks setup으로 통합을 설치하세요.

cmux hooks setup

setup 명령은 PATH에서 찾을 수 있는 지원 에이전트를 설치하고 나머지는 건너뜁니다. Claude Code는 Settings에서 Claude 통합이 켜져 있으면 cmux Claude 래퍼가 처리합니다.

작동 방식

cmux는 Application Support 아래에 창 트리, 워크스페이스 메타데이터, 패널 레이아웃, 터미널 cwd, 스크롤백 재생 데이터, 브라우저 탐색 상태를 담은 JSON 세션 스냅샷을 씁니다.

에이전트 hooks는 세션 매핑을 ~/.cmuxterm에 씁니다. 복원할 때 cmux는 먼저 UI를 다시 만듭니다. 자동 에이전트 resume이 켜져 있으면 저장된 세션 ID로 각 지원 에이전트의 기본 resume 명령을 실행합니다.

범위 밖의 것

tmux, vim, 셸, 지원되지 않는 도구는 안전한 기본 resume 명령을 기록하는 cmux 통합이 없는 한 일반 터미널로 다시 열립니다. 이렇게 하면 복원이 예측 가능하고 오래된 프롬프트나 비밀값을 재생하지 않습니다.

설정 명령, 지원 에이전트, 문제 해결은 세션 복원 문서를 읽어보세요.