Ruby workspace guides

Edit this page on GitHub

libtmux-workspace 0.1.0.alpha.1 · Source

Validate without tmuxLink to section

Validation reads and bounds the configuration without starting or contacting a tmux server.

$ libtmux-workspace validate workspace.yaml

Inspect an offline planLink to section

An offline plan lists the ordered creation operations. JSON output includes configured commands and paths, so treat it as application data rather than a redacted diagnostic.

$ libtmux-workspace plan \
    --json \
    workspace.yaml

Load on an explicit socketLink to section

Start an application-owned server, then pass its socket path to load.

$ libtmux-workspace load \
    --socket "$TMUX_SOCKET" \
    --json \
    workspace.yaml

plan --live requires the same selector. --compensate enables guarded cleanup of positively identified created state after failure; it cannot undo shell effects. Attach and client switching are explicit post-apply choices, not defaults.

Source-owned CLI guide