Export and reload a session

tmuxp 1.74.0 · Source

Use the session created by the installation walkthrough. Capture it to a new YAML destination:

$ tmuxp freeze \
    -L workspace-guide \
    --workspace-format yaml \
    --save-to captured-workspace.yaml \
    --yes \
    workspace-guide

Review the output file. Capture cannot reconstruct original scripts, shell history, plugin decisions, comments, or every application’s state. Compare window and pane topology, directories, layouts, environment, and options explicitly.

Replay under a new name on the same dedicated server:

$ tmuxp load \
    -L workspace-guide \
    -d \
    -s workspace-replay \
    captured-workspace.yaml

Inspect the replay:

$ tmux -L workspace-guide list-panes -t '=workspace-replay'

Remove the replay when finished:

$ tmux -L workspace-guide kill-session -t '=workspace-replay'

The freeze reference explains prompts and overwrite behavior. convert changes document representation without validating whether a workspace can be loaded.

tmuxp reference source.