Python workspace internals

tmuxp 1.74.0 · Source

These pages describe tmuxp’s internal implementation for contributors and extension authors. The Python interfaces have no stability guarantee and may change between releases. Use tmuxp load to launch a workspace from the terminal.

Builder pipeline¶

The CLI reads YAML or JSON, expands shorthand and variables, applies inherited defaults, and passes the result to a workspace builder. The builder uses libtmux to create the session, windows, and panes. The CLI then handles attachment or client switching.

• Topics explain the loader pipeline and builder extension points.
• Examples show expansion and building on an isolated server.
• API links the internal loading, building, and freezing interfaces.

The upstream Internals documentation contains the full architecture and module reference. Use the libtmux Python API for general tmux programming.