Capture a workspace

tmuxp 1.74.0 · Source

Capture a running tmux session as a starting workspace file. A capture cannot recover original scripts, plugin intent, comments or every application state.

Export a named session¶

After the installation walkthrough creates workspace-guide, choose a new destination:

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

Without a session, format or destination, the command can ask for missing choices. --yes answers yes/no questions; it does not supply every choice. --quiet suppresses explanatory status but can still allow prompts.

An explicit --save-to path bypasses the overwrite confirmation used by the prompted path. Select a new path deliberately. A successful export writes a file; declining a confirmation can return without saving.

Inspect the captured commands and paths before following export and reload.

Command source.