Browse referenceWhat's New
What's New in tmux 3.7c
The fixes in tmux 3.7c and the headline features from tmux 3.4 through 3.7, with config examples to try.
The current stable release is tmux 3.7c, released August 17, 2026. This page covers the latest fixes and the most useful additions since 3.4 — see the full release notes and the version history for everything else.
tmux 3.7c
This maintenance release keeps the 3.7 feature set and fixes five issues:
- Scrollbars now appear correctly on newly created windows.
- Creating a floating pane from a zoomed window first unzooms it, preventing a crash.
message-formatusesmessage-styleas its default style again.- Loops check the time periodically to reduce repeated checks.
- macOS builds use jemalloc to work around an apparent
callocbug.
See the official 3.7c changelog and the installation guide for the stable source tarball and upgrade steps.
As of September 22, 2026, tmux 3.8-rc is a prerelease for testing. This guide targets the stable 3.7c release.
tmux 3.7
Floating panes
Since 3.7 The new new-pane command (alias newp) opens a floating pane
that sits above the tiled layout — like a popup, but it isn't modal and behaves like a regular pane.
It's bound to Prefix * by default.
# Prefix * opens a floating pane, or from a shell:
tmux new-pane # floating shell
tmux new-pane 'htop' # run a command in a floating paneFloating panes are an early feature: in 3.7 they can only be moved and resized with the mouse.
Line numbers in copy mode
Since 3.7 Copy mode can now show line numbers — handy for pairing or referencing
scrollback. Numbering can be default (0 is the top visible line), absolute, relative to the
cursor, or hybrid.
set -g copy-mode-line-numbers hybrid
# set -g copy-mode-line-number-style 'fg=#8b949e'
# set -g copy-mode-current-line-number-style 'fg=#00e68a,bold'Messages that overlay the status line
Since 3.7 Messages and prompts are now drawn as a single format
(message-format), so they can occupy just part of the status line instead of replacing the whole
thing. Note that message-style now needs fill to cover the full width (the default includes
fill=yellow).
Focus follows mouse
Since 3.7 Make the pane under the mouse pointer the active pane automatically:
set -g mouse on
set -g focus-follows-mouse onMore 3.7 additions: kill-session -g to kill a whole session group,
run-shell arguments as #{1}, new copy-mode commands (
recentre-top-bottom, scroll-to-mouse,
scroll-exit-on/off/toggle), tree-mode-preview-format, the
get-clipboard option, OSC 9;4 progress bar forwarding, and seconds in clock mode.
tmux 3.6
Pane scrollbars
Since 3.6 Panes can now show a scrollbar so you can see where you are in the scrollback history at a glance.
set -g pane-scrollbars on
set -g pane-scrollbars-position right # left or right
# set -g pane-scrollbars-style 'bg=#30363d,fg=#00e68a'Automatic dark / light theme
Since 3.6 tmux now supports terminal mode 2031, so it can detect and report whether the terminal is in dark or light mode (falling back to a guess from the background colour). Applications running inside tmux can adapt their colours automatically.
Copy-mode styling
Since 3.6 Style the selection and the position indicator in copy mode.
set -g copy-mode-selection-style 'bg=#00e68a,fg=#000000'
set -g copy-mode-position-style 'bg=#13161d,fg=#8b949e'More 3.6 additions: codepoint-widths to fix Unicode width issues,
tiled-layout-max-columns, no-detach-on-destroy, the new
selection-mode command, and initial-repeat-time.
tmux 3.5
Copy-mode hyperlinks
Since 3.5 OSC 8 hyperlinks are shown in copy mode, and the
copy_cursor_hyperlink format gives the link under the cursor so you can copy or open it.
Mirrored layouts
Since 3.5 New mirrored main-horizontal and main-vertical layouts put the main
pane at the bottom or right instead of the top or left.
Snappier defaults
Since 3.5 The default escape-time dropped to 10ms, a new prefix-timeout
option cancels a half-entered prefix, and extended (CSI u) keys were overhauled with a new
extended-keys-format option.
# Already the default in 3.5+, shown explicitly for older versions:
set -sg escape-time 10tmux 3.4
SIXEL images
Since 3.4 When built with --enable-sixel, tmux can display SIXEL graphics
inside panes — image previews, plots and more in supported terminals.
Shell prompt marking (OSC 133)
Since 3.4 tmux understands OSC 133 prompt markers, so you can jump between shell
prompts in copy mode with next-prompt and previous-prompt.
bind -T copy-mode-vi '[' send -X previous-prompt
bind -T copy-mode-vi ']' send -X next-promptStyled menus & hyperlinks
Since 3.4 menu-style and menu-border-style theme popup menus, and OSC 8
hyperlinks are supported throughout.
Upgrading? Existing tmux servers keep running the old version. Save your work and finish
running jobs before restarting: tmux kill-server terminates all sessions and programs
on that server. See the upgrade steps.