tmux workspace manager for Ruby

Install

Install the workspace package separately from the core library.

$ gem install --version 0.1.0.alpha.1 libtmux-workspace

gem "libtmux-workspace", "0.1.0.alpha.1"

libtmux-workspace parses bounded YAML or JSON into an immutable creation plan. validate and offline mplan do not contact tmux. mload and plan --live borrow an existing server selected with --socket.

The manager creates a new session. It does not reconcile, replace, or delete a preexisting workspace. Applying a plan authorizes declared shell commands; their delivery does not prove that the pane programs completed.

Start here¶

• Guides covers validate, mplan, and mload.
• Topics explains the supported format and creation-only model.
• Examples provides a bounded YAML configuration.
• CLI Manual documents commands, flags, output and exit statuses.
• Language API documents the workspace gem.

The source-owned workspace guide is staged from the same revision as the generated reference.