Runtime and configuration support
libtmux-workspace 0.1.2-SNAPSHOT · Source
tmux-workspace is the Java command for loading and capturing tmux
workspaces. The installation guide builds the
documented source revision and runs a session on a private socket. The
walkthroughs require tmux 3.3a or newer. A daemon older than 3.3a is refused before any effect; see tmux support.
Runtime and execution¶
Use JDK 25 or newer. Keep the generated application distribution together; its launcher depends on the adjacent libraries. Native services handle loading, capture, discovery, search, conversion, import and editing.
Plugins, custom builders and shell need the optional tmuxp 1.74.0 environment
selected by TMUX_WORKSPACE_PYTHON. Extension append refuses a document
containing before_script to preserve its borrowed session on failure.
The CLI validates execution fields before changing tmux. Use the separate workspace library reference when constructing sessions from Java code.
Configuration and failure handling¶
Read configuration for the CLI’s fields. Unsupported execution fields fail visibly; generic conversion preserves document values without proving that they can be executed.
Use machine output for automation and check both the process status and any retained effects. Capture reads live tmux state; it cannot recover original command arguments, scripts, comments or application state.
Examples provide complete starter documents. Their pane commands can need additional applications and directories when adapted. Use library internals for the programmatic builder.