Export and reload a session

@libtmux/workspace 0.1.0-alpha.12 · Source

Capture the session created by the installation walkthrough to a new YAML file:

$ tmux-workspace freeze \
    -S "$WORKSPACE_TMP/tmux.sock" \
    --json \
    --workspace-format yaml \
    --save-to workspace-export.yaml \
    workspace-guide

Review the saved commands, directories and layout. Capture reads current tmux state; it cannot recover original arguments, shell history, scripts, comments or application state. A captured command may need editing before replay.

Load a second copy¶

Use a fresh session name on the same private server:

$ tmux-workspace load \
    -S "$WORKSPACE_TMP/tmux.sock" \
    -d \
    -s workspace-replayed \
    --json \
    workspace-export.yaml

Inspect the second copy’s panes:

$ tmux -S "$WORKSPACE_TMP/tmux.sock" list-panes -t '=workspace-replayed'

Remove that copy when finished:

$ tmux -S "$WORKSPACE_TMP/tmux.sock" kill-session -t '=workspace-replayed'

Capture explains destination handling. Conversion changes file encoding without proving the document can be loaded.

CLI source.