cmux-resume-sessions

Restoring cmux workspaces from a saved JSON snapshot reads the layout metadata, creates workspaces via cmux new-workspace, and renames them to the saved names. It optionally starts Claude Code with --resume or --continue to pick up where you left off.

Resuming Claude Code conversations during cmux session rehydration is supported by optionally starting Claude Code with --resume or --continue per workspace. You can also use the --no-claude flag to skip launching Claude Code entirely.

Missing or duplicate workspaces in the cmux snapshot are handled with clear warnings and safe skips. The restoration preserves the rest of the layout by ignoring non-existent or duplicate entries while rehydrating the valid workspaces.

Restoring saved workspace sessions requires both jq and cmux as dependencies. The tool uses cmux to create and rename workspaces from the JSON snapshot, while jq processes the snapshot metadata to rehydrate the planned layout.

Restoring cmux sessions is ideal when you intentionally saved a layout and want to rehydrate workspaces on startup, across machines, or after a workflow pause. It enables deterministic rehydration of a planned layout without crash context.

Restoring cmux workspaces across machines is supported by reading the saved JSON snapshot metadata. The tool recreates workspaces with their saved names and working directories, allowing you to resume your planned layout on a new environment.