tmuxp 1.74.0 pairs a libtmux upgrade with a documentation overhaul. It bumps libtmux to 0.61.0 — hardening tmux 3.7 patch-line support — and teaches tmuxp debug-info to report the exact tmux patch release (3.7a/3.7b) instead of the numeric-normalized version. The docs also gain theme-aware inline diagrams and a concept-first rewrite that leads with what each feature is before its configuration.
Highlights
libtmux 0.61.0
The libtmux floor moves from ~=0.60.0 to ~=0.61.0, hardening tmux 3.7 patch-line support. libtmux's Pane.break_pane() now keeps tmux's own default window name on tmux 3.7a/3.7b instead of forcing libtmux, and a new get_version_str() helper exposes the raw tmux version string. tmux 3.2a–3.6 are unaffected.
tmuxp debug-info reports the exact tmux patch release
tmuxp debug-info now shows tmux's full version, keeping the point-release letter (for example 3.7a) that was previously normalized away to 3.7. Because tmux patch releases can differ in behavior, the precise release is what a bug report needs.
Themed diagrams across the docs
Diagrams now render as theme-aware inline graphics that follow the site's light/dark palette and code styling, replacing the old static ASCII art. The workspace-builders guide gains a load → build → attach flow diagram, and the examples page shows each pane example as a faithful tmux window layout.
Concept-first documentation pass
The docs now open with what each feature is before its configuration, in a consistent second-person voice, with advanced and Python-only material marked opt-in. New diagrams trace the plugin hook lifecycle, the CLI request flow, the workspace hierarchy, and what tmuxp load does inside an existing session.
Development
The build-time mermaid diagram renderer, previously bundled with the docs, now comes from the reusable sphinx-gp-mermaid package. Rendered output is unchanged.
What's Changed
- Docs: build-time mermaid + tmux-layout diagram rendering by @tony in #1071
- docs: voice-guide compliance pass, diagrams, and fixes by @tony in #1072
- Docs: consume sphinx-gp-mermaid, drop the vendored renderer by @tony in #1073
- libtmux 0.61.0 by @tony in #1074
Full Changelog: v1.73.0...v1.74.