Export and reload a session

Edit this page on GitHub

libtmux-workspace 0.0.1-alpha.12-SNAPSHOT · Source

tmuxp compatibility reference. Examples using tmuxp run the Python reference. Local CLI status describes this port’s implemented coverage.

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 native execution support. The native compatibility page records which ports lack capture or lose fields.

tmuxp reference source.