Ruby workspace guides

libtmux-workspace 0.1.0.alpha.3 · Source

Validate without tmux¶

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

$ libtmux-workspace validate workspace.yaml

Inspect an offline plan¶

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 socket¶

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