[3.4.0] - 2026-08-30
Added
- Key cheat sheet (
Prefix + ?, tmux'slist-keys): a scrollable
popup listing every effective binding — afterconfig.tomloverrides
and unbinds — grouped into Windows / Panes / Layouts / Scrollback &
selection / Tools / Other, each with the command name and a one-line
description. The legacy[keybindings]keys (history selector,
scrollback, selection) are listed in their own section.j/k,
PgUp/PgDn,g/Gscroll;q,Escor?close. Also
list-keys(lsk) at the command prompt and as a bindable command. - tmux's layout keys:
Prefix + M-1…M-5now apply
even-horizontal,even-vertical,main-horizontal,main-vertical
andtileddirectly (previously only reachable by cycling with
Spaceor viaselect-layout). previous-layout(prevl) cycles the presets backwards; also
available asselect-layout -p(and-nfor next), as a prompt
command and as a bindable command. No default key.move-window/swap-window(tmux window reordering).Prefix + .
then a digit1-9moves the current window to that position; the
status bar shows the prompt and any other key cancels. Both are also
prompt commands (move-window -t <n>/movew,swap-window -t <n>
/swapw) and bindable commands (move-window [-t <n>],
swap-window [-t <n>]; without-tthe key waits for a digit).
Changed
- Window names no longer embed a number: new windows are named
main/
shelland the tab bar prefixes the current display position
(1:main,2:shell), so the number stays correct after windows are
moved, swapped, or closed.rename-windownames show the same way
(3:build). - Automatic pane titles: panes are now titled after their working
directory's last component (e.g.wtmuxfor
D:\home\source\rust\wtmux) and followcdas it happens. Panes in
the same window that end up with the same name are numbered
wtmux,wtmux:2,wtmux:3, … in pane order. - Manual pane renaming was removed: the
rename-paneprompt command
and key binding (Prefix + .), the context menu's "Rename Pane"
item, and right-click-on-title renaming are gone. Window renaming is
unchanged. cwd_prompt_hooknow defaults to on so pane titles can track the
working directory out of the box. Setcwd_prompt_hook = falsein
config.toml(or pass--no-cwd-prompt-hook) to opt out; titles
then stay at each pane's starting directory.