No entries match these filters. Clear filters
tmux gains floating panes, modal panes, switch mode, copy-mode refresh/line-numbers, and a theme system︀︄︇︀︅︉︀︅︀︀︃︀︀︅︅︀︅︊︀︄︆︀︃︄
└──▷ TRY IT
Open a floating terminal centred in the current window — useful for a quick command without leaving your layout.
copy
$ tmux new-pane -x50% -y25% -X25% -Y37%
Bind a key to pop up an interactive fuzzy session/window switcher in a floating pane, keeping it hidden once chosen.
copy
$ bind s 'new-pane -x50% -y50% -E; choose-tree -hks'
Set tmux to auto-detect the terminal colour theme and customise the dark-theme accent colours in tmux.conf.
~/.tmux.conf
copy
set -s theme detect
set -s dark-theme-blue '#5588ff'
set -s dark-theme-green '#44cc88'
Adds move-pane -X/-Y absolute positioning and -z/z-index options for floating panes, plus named positions (top-left, centre, bottom-right, front, back, forward-loop, backward-loop, and more).︀︄︇︀︅︉︀︅︀︀︃︀︀︅︅︀︅︊︀︄︆︀︃︄ Not checked yet Adds -W (float) flag to break-pane (-abdPW) to lift a pane out of a tiled layout and make it floating, with -x/-y size and -X/-Y position options. Not checked yet Adds switch-mode command (-kswZ) to put a pane into an interactive fuzzy-match session/window chooser, with -s/-w to list sessions or windows. Not checked yet Adds refresh-on, refresh-off, and refresh-toggle copy-mode commands to enable live automatic refresh of pane output while in copy mode. Not checked yet Adds line-numbers-on, line-numbers-off, and line-numbers-toggle copy-mode commands (emacs key L) to show or hide line numbers in copy mode. Not checked yet
+5 more
show less
Adds source-window option to display-panes to show panes from a different window than the one containing the target pane. Not checked yet Adds theme server option (detect/light/dark) and a full set of dark-theme-* / light-theme-* colour options for palette customisation. Not checked yet Adds choose-tree -G flag to include all sessions in session groups in the tree rather than only the first. Not checked yet Extends capture-pane with -H flag to include hyperlinks per line, separated by spaces. Not checked yet Adds Tab key binding in tree/session chooser to fuzzy-match a new window and session. Not checked yet
Adds move-pane -X/-Y absolute positioning and -z/z-index options for floating panes, plus named positions (top-left, centre, bottom-right, front, back, forward-loop, backward-loop, and more).︀︄︇︀︅︉︀︅︀︀︃︀︀︅︅︀︅︊︀︄︆︀︃︄ Not checked yet Adds -W (float) flag to break-pane (-abdPW) to lift a pane out of a tiled layout and make it floating, with -x/-y size and -X/-Y position options. Not checked yet Adds switch-mode command (-kswZ) to put a pane into an interactive fuzzy-match session/window chooser, with -s/-w to list sessions or windows. Not checked yet Adds refresh-on, refresh-off, and refresh-toggle copy-mode commands to enable live automatic refresh of pane output while in copy mode. Not checked yet Adds line-numbers-on, line-numbers-off, and line-numbers-toggle copy-mode commands (emacs key L) to show or hide line numbers in copy mode. Not checked yet
+2 more
show less
Adds theme server option (detect/light/dark) and a full set of dark-theme-* / light-theme-* colour options for palette customisation. Not checked yet Adds Tab key binding in tree/session chooser to fuzzy-match a new window and session. Not checked yet
3 more in Everything
tmux: Adds -W flag to new-pane to wait for the pane's command to exit and return its exit status.︀︄︇︀︅︉︀︅︀︀︃︀︀︅︅︀︅︊︀︄︆︀︃︄
└──▷ TRY IT
Open a floating choose-tree picker centred in the current window — ideal for quick session/window switching without disrupting the layout.
copy
$ bind s 'new-pane -x50% -y50% -E; choose-tree -hks'
Run a build in a temporary floating pane and capture its exit status to drive CI decisions.
copy
$ tmux new-pane -W 'make test'
echo $?
Force tmux to use the dark theme and customise its red colour for alerts across all clients.
~/.tmux.conf
copy
set -s theme dark
set -s dark-theme-red '#ff5555'
Adds -I flag to new-pane to create an empty pane and forward stdin to it. Not checked yet Adds move-pane with -x/-X, -y/-Y, and -z (z-index) options to reposition floating panes absolutely or to named corners/edges (top-left, centre, bottom-right, front, back, forward-loop, etc.). Not checked yet Adds modal pane support to new-pane: a modal pane is always active and blocks interaction with all other panes; closing on outside click is supported. Not checked yet Adds switch-mode command to interactively choose a session or window via fuzzy matching; supports -s (sessions), -w (windows), -Z (zoom), -k (kill pane on exit), and a custom -F format. Not checked yet Adds refresh-on, refresh-off, and refresh-toggle copy-mode commands to enable automatic pane-content refresh while in copy mode (off by default, scrolls only when cursor is at the bottom, paused during selection). Not checked yet
+8 more
show less
Adds theme server option (detect, light, dark) so tmux auto-detects the client terminal theme or forces light/dark mode. Not checked yet Adds dark-theme-* and light-theme-* colour options (dark-theme-black, dark-theme-white, dark-theme-green, light-theme-black, etc.) for full theme palette customisation. Not checked yet Adds capture-pane -H flag to include hyperlinks in captured output, with multiple hyperlinks on a line separated by spaces. Not checked yet Adds capture-pane flag to dump internal grid data for diagnostics. Not checked yet Adds -a flag to kill-session to clear alerts (bell, activity, silence) in all windows linked to the session. Not checked yet Adds filter support to kill-pane and kill-window to kill only panes or windows for which a format filter evaluates true. Not checked yet Extends server access to support group entries (shown as G) alongside user entries (U), with R/W for read-only/writable; user entry takes precedence when both match. Not checked yet Adds display-panes -k flag to kill the pane when the indicator mode is exited, and -N to start unzoomed. Not checked yet
Adds -I flag to new-pane to create an empty pane and forward stdin to it. Not checked yet Adds modal pane support to new-pane: a modal pane is always active and blocks interaction with all other panes; closing on outside click is supported. Not checked yet Adds switch-mode command to interactively choose a session or window via fuzzy matching; supports -s (sessions), -w (windows), -Z (zoom), -k (kill pane on exit), and a custom -F format. Not checked yet Adds refresh-on, refresh-off, and refresh-toggle copy-mode commands to enable automatic pane-content refresh while in copy mode (off by default, scrolls only when cursor is at the bottom, paused during selection). Not checked yet Adds theme server option (detect, light, dark) so tmux auto-detects the client terminal theme or forces light/dark mode. Not checked yet
+1 more
show less
Adds dark-theme-* and light-theme-* colour options (dark-theme-black, dark-theme-white, dark-theme-green, light-theme-black, etc.) for full theme palette customisation. Not checked yet
7 more in Everything
tmux 3.7 adds floating panes, copy mode line numbers, and configurable message formatting.
└──▷ GET THIS VERSION
copy
$ git clone --branch 3.7 https://github.com/tmux/tmux.git
$ git checkout 3.7
Adds floating panes created via the new-pane command (bound to * by default) which sit above tiled panes like popups but are not modal Not checked yet Adds copy-mode-line-numbers, copy-mode-line-number-style, and copy-mode-current-line-number-style options to show and style line numbers in copy mode Not checked yet Adds message-format option and refactors message drawing so prompts occupy only a portion of the status bar instead of replacing the entire line Not checked yet Adds -g flag to kill-session to kill all sessions in a session group Not checked yet
4 details in Everything
└──▷ BREAKING ON UPGRADE
! The default behavior of message drawing changes: prompts now overlay normal status content rather than replacing the entire line; the message-style option no longer implies full width filling by default (requires fill to cover whole width)
tmux 3.6 adds pane scrollbars, copy-mode styling, SIXEL support flags, and enhanced format expressions
└──▷ GET THIS VERSION
copy
$ git clone --branch 3.6 https://github.com/tmux/tmux.git
$ git checkout 3.6
└──▷ USE IT
Enable scrollbars on the right side of panes and style them cyan.
shell
copy
tmux set-option -g pane-scrollbars on
(tmux set-option -g pane-scrollbars-position right)
(tmux set-option -g pane-scrollbars-style 'fg=black,bg=cyan')
Capture the full copy mode screen buffer to a file for later analysis.
shell
copy
tmux capture-pane -pM > capture.txt
Configure copy mode selection highlighting with custom styles.
shell
copy
tmux set-option -g copy-mode-position-style 'fg=yellow,bold'
(tmux set-option -g copy-mode-selection-style 'bg=red')
Check for SIXEL support in status lines or scripts.
shell
copy
tmux display-message '#{sixel_support}'
Create a popup that closes immediately upon command completion regardless of input.
shell
copy
tmux display-popup -k -e EDITOR=nvim 'echo done'
Add pane-scrollbars, pane-scrollbars-position, and pane-scrollbars-style options to enable side scrollbars for each pane. Not checked yet Add copy-mode-position-style and copy-mode-selection-style options to style the position indicator and selection highlights in copy mode. Not checked yet Add -M flag to capture-pane to capture the copy mode screen instead of the visible pane content. Not checked yet Add sixel_support format variable to check for SIXEL support, returning 1 if available or 0 on OpenBSD. Not checked yet Extend && and || in format expressions to support arbitrarily many arguments, and add ! and !! operators for not and not-not logic. Not checked yet
+1 more
show less
Add -k flag to display-popup to dismiss the popup with any key once the command has exited. Not checked yet
6 details in Everything
tmux 3.5 adds extended key revamp, hyperlinks in copy mode, prefix timeout, and new search/count formats.
└──▷ GET THIS VERSION
copy
$ git clone --branch 3.5 https://github.com/tmux/tmux.git
$ git checkout 3.5
└──▷ USE IT
Configure tmux to use jemalloc for memory management at compile time.
shell
copy
./configure --enable-jemalloc && make
Set the prefix timeout to 10 seconds via configuration file.
shell
copy
set-option -g prefix-timeout 10000
Adds extended-keys-format option to control the format of extended keys (similar to xterm's formatOtherKeys). Not checked yet Adds prefix-timeout option to configure the delay before the prefix key expires. Not checked yet Adds --enable-jemalloc build flag to use the jemalloc memory allocator. Not checked yet Adds -d flag to copy-mode to scroll a page down if already in copy mode. Not checked yet Adds copy_cursor_hyperlink format variable to retrieve the hyperlink under the cursor in copy mode. Not checked yet
+6 more
show less
Adds search_count and search_count_partial format variables in copy mode for search result counts. Not checked yet Adds mirrored versions of main-horizontal and main-vertical layouts (main pane at bottom or right). Not checked yet Adds -M flag to display-menu to always turn mouse on in a menu. Not checked yet Adds -r flag to refresh-client in control mode for OSC 10 and 11 responses. Not checked yet Adds command-error hook triggered when a command fails. Not checked yet Adds allow-set-title option to forbid applications from changing the pane title. Not checked yet
11 details in Everything
tmux 3.4 adds SIXEL graphics, OSC 133 prompt marking, and cgroup pane spawning
└──▷ GET THIS VERSION
copy
$ git clone --branch 3.4 https://github.com/tmux/tmux.git
$ git checkout 3.4
Add options keep-last and keep-group to destroy-unattached to keep the last session whether in a group. Not checked yet Add -t to source-file. Not checked yet Add basic support for SIXEL if built with --enable-sixel. Not checked yet Add a session, pane and user mouse range types for the status line and add format variables for mouse_status_line and mouse_status_range so they can be associated with different commands in the key bindings. Not checked yet Add flag (-o) to next-prompt/previous-prompt to go to OSC 133 command output. Not checked yet
+27 more
show less
Add options and flags for menu styles (menu-style, menu-border-style) similar to those existing for popups. Not checked yet Add support for marking lines with a shell prompt based on the OSC 133 extension. Not checked yet Add flags (-c and -y) to change the confirm key and default behaviour of confirm-before. Not checked yet Set default lock command to vlock on Linux if present at build time. Not checked yet Add support for spawning panes in separate cgroups with systemd and a configure flag (--disable-cgroups) to turn off. Not checked yet Add a format (pane_unseen_changes) to show if there are unseen changes while in a mode. Not checked yet Add an L modifier like P, W, S to loop over clients. Not checked yet Add -f to list-clients like the other list commands. Not checked yet Extend display-message to work for control clients. Not checked yet Add a flag to display-menu to select the menu item selected when the menu is open. Not checked yet Query the client terminal for foreground and background colours and if OSC 10 or 11 is received but no colour has been set inside tmux, return the colour from the first attached client. Not checked yet Add send-keys -K to handle keys directly as if typed (so look up in key table). Not checked yet Add a -l flag to display-message to disable format expansion. Not checked yet Add paste-buffer-deleted notification and fix name of paste-buffer-changed. Not checked yet Do not attempt to connect to the socket as a client if systemd is active. Not checked yet Add scroll-top and scroll-bottom commands to scroll so cursor is at top or bottom. Not checked yet Add a -T flag to capture-pane to stop at the last used cell instead of the full width. Restore the previous behaviour by making it default to off unless -J is used. Not checked yet Add message-line option to control where message and prompt go. Not checked yet Notification when a paste buffer is deleted. Not checked yet Add a Nobr terminfo(5) capability to tell tmux the terminal does not use bright colours for bold. Not checked yet Change g and G to go to top and bottom in menus. Not checked yet Add a third state all to allow-passthrough to work even in invisible panes. Not checked yet Add support for OSC 8 hyperlinks. Not checked yet Store the time lines are scrolled into history and display in copy mode. Not checked yet Add a %config-error reply to control mode for configuration file errors since reporting them in view mode is useless. Not checked yet A new feature flag (ignorefkeys) to ignore terminfo(5) function key definitions for rxvt. Not checked yet Pass through first argument to OSC 52 (which clipboards to set) if the application provides it. Not checked yet
32 details in Everything
tmux 3.3 adds server ACLs ACLs An access control list, a set of rules allowing or denying operations for particular users, services or network addresses. It decides who can use a resource. via server-access, popup styling flags, systemd socket activation, and new formats/hooks
└──▷ GET THIS VERSION
copy
$ git clone --branch 3.3 https://github.com/tmux/tmux.git
$ git checkout 3.3
└──▷ TRY IT
Restrict tmux socket access so only specific users can attach read-write while others are forced read-only.
copy
$ server-access -a user:alice:read-write
server-access -a user:bob:read-only
Run a popup with a custom title, environment variable, and specific border styles defined by default options.
copy
$ display-popup -T 'My Popup' -e MY_VAR=value -b 50% -s '#[fg=white]#[bg=blue]' tmux set-option -g popup-border-lines double && tmux set-option -g popup-border-style bg=black
Add a new server-access command to configure user ACLs for the tmux socket Not checked yet Add --enable-systemd build flag to support systemd socket activation Not checked yet Add pane_start_path, next_session_id, client/server UID and user formats, and remain-on-exit-format Not checked yet Add window-resized hook and client-active hook for resize and focus events Not checked yet Add -T (title), -e (env), -b (lines), and -s/-S (styles) flags to display-popup plus new options popup-border-lines, popup-border-style, and popup-style Not checked yet
+8 more
show less
Add -B flag to display-popup to open without a border, along with a popup context menu for resizing and closing Not checked yet Add option fill-character for unused client areas and scroll-on-clear to control history scrolling on clear Not checked yet Add OSC 7 capability via the existing set-titles option and response to OSC 4 queries Not checked yet Add pane-border-indicators option and make pane-border-format a pane option instead of window Not checked yet Add cursor-style and cursor-colour options, and support for underscore styles in capture-pane -e Not checked yet Add -F to command-prompt, new command histories per prompt type, and background execution with -b for command-prompt/confirm-before Not checked yet Add pipe variants of line copy commands and -and-cancel variant for copy-line/copy-end-of-line Not checked yet Change {} to expand immediately upon parsing, requiring valid tmux commands inside Not checked yet
13 details in Everything
tmux 3.2a adds always to extended-keys option and a mouse terminal feature for better compatibility.
└──▷ GET THIS VERSION
copy
$ git clone --branch 3.2a https://github.com/tmux/tmux.git
$ git checkout 3.2a
Adds always value for the extended-keys option to force forwarding of extended keys regardless of application request Not checked yet Adds a mouse terminal feature to enable mouse support on terminals where terminfo claims it is unsupported Not checked yet
2 details in Everything
tmux 3.2 adds pane pause support, active-pane flags, format modifiers, and configurable key bindings
└──▷ GET THIS VERSION
copy
$ git clone --branch 3.2 https://github.com/tmux/tmux.git
$ git checkout 3.2
└──▷ TRY IT
Prevent output backlog from choking a control mode client by pausing and resuming pane updates.
copy
$ tmux set-option -g pause-after 10
tmux refresh-client -A
Attach a session while designating a specific pane as the active one for immediate interaction.
copy
$ tmux attach-session -t 0 -f 1
Bind a key to choose a client with a custom shortcut format for easier selection.
copy
$ tmux bind-key C-b choose-client -K "Client: #{client_name}"
Add pause-after option to control output buffering for control mode clients and refresh-client -A to resume. Not checked yet Add -f flag to attach-session, new-session, and refresh-client to set an independent active pane. Not checked yet Support configurable shortcut keys in buffer, client, and tree modes using the -K format flag with choose-* commands. Not checked yet Add -w flag to set-buffer and load-buffer to send content to clipboard via OSC 52. Not checked yet Add -q flag to unbind-key to suppress errors when binding is not present. Not checked yet
+4 more
show less
Introduce rectangle-on and rectangle-off commands for copy mode. Not checked yet Support color spelling in addition to colour across various configuration options. Not checked yet Add support for extended keys using xterm CSI CSI An ambiguous abbreviation — it most commonly means Container Storage Interface (a Kubernetes storage plugin standard) or Crime Scene Investigation — without more context the correct meaning cannot be determined reliably. 27 ~ or libtickit CSI u sequences via the extended-keys option. Not checked yet Allow pane border line styles to be configured as single, double, heavy, simple, or number lines. Not checked yet
9 details in Everything
tmux 3.1 adds regex search, key binding notes via -N, format modifiers, pane_path, OSC 7/DSR 1337 support, and new copy mode formats.
└──▷ GET THIS VERSION
copy
$ git clone --branch 3.1 https://github.com/tmux/tmux.git
$ git checkout 3.1
└──▷ TRY IT
Enable regular expression search in copy mode.
copy
$ bind-key / search-forward
bind-key ? search-backward
Add notes to key bindings for better discoverability.
copy
$ bind-key -N 'Rotate panes clockwise' C-b :rotate-window
tmux list-keys -N | grep Rotate
Adds search-forward and search-backward in copy mode to use regular expressions by default Not checked yet Adds -N flag to bind-key for key binding notes and -N to list-keys to display them Not checked yet Adds ~ to quoted characters for the %%% escape sequence Not checked yet Adds support for iTerm2 DSR 1337 sequence and DECSLRM detection Not checked yet Adds selection_active format for non-moving selections Not checked yet
+8 more
show less
Adds new formats: pane_path, xpixel, ypixel, window_marked_flag, and word/line/cursor position in copy mode Not checked yet Adds -p format modifier for padding to width and allows multiple substitutions in a single format Not checked yet Adds -f flag to join-pane for full size and -Z flags to rotate-window, select-pane, swap-pane, switch-client Not checked yet Adds -N to capture-pane to preserve trailing spaces Not checked yet Adds push-default/pop-default styles in status-format[0] and push_default/pop_default support Not checked yet Adds reverse sorting in tree, client, and buffer modes Not checked yet Adds an option to set the key sent by backspace for systems using ^H rather than ^? Not checked yet Adds latest window-size option which sizes windows based on the most recently used client Not checked yet
13 details in Everything
tmux 3.0 adds menus, pane options, regex search, and {} config syntax
└──▷ GET THIS VERSION
copy
$ git clone --branch 3.0 https://github.com/tmux/tmux.git
$ git checkout 3.0
└──▷ TRY IT
Create a context menu on the status line to quickly reload config or kill panes.
copy
$ bind-key -n MouseDrag3 status-command 'display-menu -T "Menu" ~{1,Reload,source-file ~/.tmux.conf}{2,Kill Pane,kill-pane}'
Use the new {} syntax to define a multi-line status line format without messy escaping.
text
copy
set-option -g status-left '{[#{pane_current_path}]}'
Send a literal pipe character instead of interpreting it as shell syntax.
Add new display-menu command to create simple menus with configurable bindings. Not checked yet Add {} string syntax to .tmux.conf for multi-line strings without escaping. Not checked yet Add -H flag to send-keys to send literal keys. Not checked yet Add support for the SD (scroll down) escape sequence and underscore colours (Setulc ). Not checked yet Add pane options via set-option -p, inheriting from window options. Not checked yet
+6 more
show less
Add regular expression support to format search/match/substitute modifiers; -r flag for find-window. Not checked yet Add -A flag to show-options to display parent options with a * marker. Not checked yet Add new <, >, <=, and >= comparison operators for formats. Not checked yet Store hooks as array options allowing multiple commands, executed in index order. Not checked yet Add -e flag to new-window, split-window, respawn-window, and respawn-pane to pass environment variables. Not checked yet Add -no-clear variants of copy-selection and copy-pipe to preserve selection after copying. Not checked yet
11 details in Everything
└──▷ BREAKING ON UPGRADE
! Unescaped { or } in .tmux.conf now causes a parse error; they must be quoted (e.g., '{') or escaped ('\{').! A single backslash \ in .tmux.conf must now be escaped as \\ or quoted as \'. \
tmux 2.9 adds support for windows larger than clients via new window-size and resize-window command.
└──▷ GET THIS VERSION
copy
$ git clone --branch 2.9 https://github.com/tmux/tmux.git
$ git checkout 2.9
└──▷ USE IT
Manually pan a session where the window is larger than the terminal to view hidden content on the right.
shell
copy
refresh-client -L 20
Adds window-size option (values: largest, smallest, manual) to control how window dimensions are determined relative to attached clients. Not checked yet Adds default-size option to set the initial size of new windows when window-size is manual. Not checked yet Adds resize-window command with -a, -A, -x, and -y flags for manual window resizing beyond client bounds. Not checked yet Adds refresh-client command with -U, -D, -L, -R, and -c flags to pan around a window that is larger than the visible client area. Not checked yet Adds status-format array option to configure multi-line status bar formats, supporting the new multi-line height values (2-5) for the status option. Not checked yet
5 details in Everything
└──▷ BREAKING ON UPGRADE
! The force-width and force-height options are removed; use resize-window -x or -y to achieve similar fixed dimensions.! The session_width and session_height format variables are removed.
tmux 2.8 adds pane focus hooks, rectangle_toggle format, Any key table fallback, and set-hook -R.
└──▷ GET THIS VERSION
copy
$ git clone --branch 2.8 https://github.com/tmux/tmux.git
$ git checkout 2.8
set-hook -R runs a hook command immediately rather than waiting for the next event Not checked yet Add Any key to run a command if a key is pressed that is not bound in the current key table Not checked yet New format token rectangle_toggle available in pane and window formatting strings Not checked yet Add pane focus hooks (pane_focus_in, pane_focus_out) to react to user activity Not checked yet
4 details in Everything
└──▷ BREAKING ON UPGRADE
! display-panes now blocks the client until a pane is chosen or it times out, changing previous asynchronous behavior
tmux 2.7 adds -Z zoom flag to choose modes, pipe-pane -I for stdin, %else config logic, and RGB terminal detection.
└──▷ GET THIS VERSION
copy
$ git clone --branch 2.7 https://github.com/tmux/tmux.git
$ git checkout 2.7
Add -Z flag to choose-tree, choose-client, and choose-buffer to auto-zoom panes when entering the mode Not checked yet Add -I option to pipe-pane to connect stdin of the child process Not checked yet Support %else in config files to match %if statements Not checked yet
3 details in Everything
└──▷ BREAKING ON UPGRADE
! The allow-rename option default changes to off
tmux 2.6 adds pane titles (-T), user-keys, OSC colour support, new formats and expanded choose-tree.
└──▷ GET THIS VERSION
copy
$ git clone --branch 2.6 https://github.com/tmux/tmux.git
$ git checkout 2.6
Adds select-pane -T to set pane title. Not checked yet Supports REP escape sequence (\033[b). Not checked yet Adds -d flag to display-panes to override display-panes-time. Not checked yet Adds selection_present format for copy mode. Not checked yet Adds pane_at_left, pane_at_right, pane_at_top and pane_at_bottom formats. Not checked yet
+8 more
show less
Adds pane_pipe format to show if pipe-pane is active. Not checked yet Allows punctuation in pane_current_command. Not checked yet Adds -c for respawn-pane and respawn-window. Not checked yet Adds user-keys option for user-defined key escape sequences (User0 to User999). Not checked yet Adds pane-set-clipboard hook. Not checked yet Supports SIGUSR2 to toggle logging on a running server. Not checked yet Expands formats in option names and adds -F flag to expand them in option values. Not checked yet Major rewrite of choose mode includes preview, sorting, searching and tagging; filtering in tree mode. Not checked yet
13 details in Everything
└──▷ BREAKING ON UPGRADE
! Removes the bell-on-alert option.! choose-window and choose-session are now aliases of choose-tree.
tmux 2.5 adds pane search format, session/window stack formats, and new control mode hooks.
└──▷ GET THIS VERSION
copy
$ git clone --branch 2.5 https://github.com/tmux/tmux.git
$ git checkout 2.5
Adds pane_search_string format for the last search term while in copy mode Not checked yet Adds new control mode notifications and corresponding hooks: pane-mode-changed, window-pane-changed, client-session-changed, session-window-changed Not checked yet
2 details in Everything
tmux 2.4 adds send-keys -X subcommands, copy-pipe-and-cancel, OSC 52, and new conditional format syntax
└──▷ GET THIS VERSION
copy
$ git clone --branch 2.4 https://github.com/tmux/tmux.git
$ git checkout 2.4
└──▷ TRY IT
Programmatically search upwards in copy mode from a script or key binding without exiting copy mode.
copy
$ bind-key C-r send-keys -X command-prompt -i -p'search up' "send -X search-backward-incremental '%%'"
Conditionally apply a status bar theme only if the client terminal supports specific capabilities.
text
copy
%if #{==:#{client_termtype},screen-256color}
set -g status-style 'bg=colour-red'
%endif
send-keys -X sends commands (e.g., scroll-up, search-backward-incremental) to a window pane or client without changing input mode. Not checked yet Adds the copy-pipe-and-cancel command available via send-keys -X for copy mode workflows. Not checked yet source-file now supports glob patterns for loading multiple config files. Not checked yet The %if/%endif blocks in .tmux.conf allow conditional configuration processing based on format comparisons (#{==:} or #{!=:}). Not checked yet Adds new formats #{version}, #{client_termtype}, #{client_name}, and #{client_written} for status lines and conditionals. Not checked yet
+2 more
show less
Added support for OSC 52 to allow programs inside tmux to set the tmux paste buffer from within panes. Not checked yet New -E flag on detach-client executes a command to replace the client process instead of detaching. Not checked yet
7 details in Everything
└──▷ BREAKING ON UPGRADE
! The -t flag for specifying target in bind-key and unbind-key mode tables (e.g., -temacs-copy) is removed; use -T with the new table names like copy-mode.! The set-remain-on-exit option is removed; achieve this behavior using hooks instead.
tmux 2.3 adds pane-border-status text, before/after hooks, split-window -f, and source-file -q
└──▷ GET THIS VERSION
copy
$ git clone --branch 2.3 https://github.com/tmux/tmux.git
$ git checkout 2.3
Adds pane-border-status option to control text displayed in pane borders Not checked yet Adds support for before and after hooks on commands via new hook points Not checked yet Adds -f flag to split-window command for performing a full-width split Not checked yet Adds -q flag to source-file command to suppress errors for nonexistent files Not checked yet Allows report count specification when using bind-key -R Not checked yet
+2 more
show less
Enables appending to user options via set -a for @foo style options Not checked yet display-panes can now accept a command argument instead of just selecting a pane Not checked yet
7 details in Everything
tmux 2.2 adds format strings, hooks, and RGB color support
└──▷ GET THIS VERSION
copy
$ git clone --branch 2.2 https://github.com/tmux/tmux.git
$ git checkout 2.2
└──▷ USE IT
Display scroll position and truncated socket path in the status line
shell
copy
set-status-right '#{scroll_position} | #{=10:#{socket_path}}'
Adds #{scroll_position}, #{socket_path}, time formatting with #{t:...}, basename/dirname/substitution formats to control pane content and status display Not checked yet Enables alert-bell, alert-silence, alert-activity, client-attached, client-detached, client-resized, pane-died, and pane-exited hooks for event-driven automation Not checked yet Adds RGB (24bit) colour support via the Tc TERM flag Not checked yet
3 details in Everything
└──▷ BREAKING ON UPGRADE
! Removed format strings which referenced time; use #{t:window_activity} instead.! Removed support for TMPDIR; use TMUX_TMPDIR instead.! Removed mouse-utf8 and utf8 options as UTF8 detection now happens automatically.
tmux 2.1 adds mouse support consolidation, new format specifiers, and several command flags including -P, -M, and -e.
└──▷ GET THIS VERSION
copy
$ git clone --branch 2.1 https://github.com/tmux/tmux.git
$ git checkout 2.1
└──▷ USE IT
Enable full mouse support (resize, select pane/window) with a single config setting.
text
copy
set-option -g mouse on
Prevent copy mode from exiting when using selection commands, allowing extended text selection.
Adds mouse session option to replace four separate mouse-* options Not checked yet Adds new format specifiers: session_activity, window_linked, window_activity_format, session_alerts, session_last_attached, client_pid, and pid Not checked yet Adds -x flag to copy-selection, append-selection, and start-named-buffer to prevent exiting copying mode Not checked yet Adds -P flag to select-pane to set window/pane background colours Not checked yet Adds -M flag to select-pane for marking a pane for use with src-pane specifiers Not checked yet
+2 more
show less
Adds -e flag to copy-mode to exit copy-mode when scrolling to the end Not checked yet Adds history-file option to save/restore command prompt history Not checked yet
7 details in Everything
└──▷ BREAKING ON UPGRADE
! The mouse-resize-pane, mouse-select-pane, mouse-select-window, and mode-mouse options are removed; use the new mouse option instead! The c0-* rate-limiting options are removed; a backoff approach is now used
tmux 2.0 adds set-buffer -a, -S-/-E- to capture-pane, and named buffers.
└──▷ GET THIS VERSION
copy
$ git clone --branch 2.0 https://github.com/tmux/tmux.git
$ git checkout 2.0
set-buffer gains append mode via -a flag and the ability to assign names to buffers Not checked yet capture-pane supports -S- and -E- flags to denote pane start and end ranges Not checked yet
2 details in Everything
└──▷ BREAKING ON UPGRADE
! The choose-list command has been removed.! terminal-overrides is now a server option, not a session option.! message-limit is now a server option, not a session option.! monitor-content option has been removed.! pane_start_path option has been removed.! The info mechanism which used to (for some commands) provide feedback has been removed.
tmux 1.9 adds TMUX_TMPDIR env var, new-session -c, new-window -c, and pane sync format spec
└──▷ GET THIS VERSION
copy
$ git clone --branch 1.9 https://github.com/tmux/tmux.git
$ git checkout 1.9
└──▷ HOW TO FIND IT
Start a new tmux session in the current working directory without relying on the default current dir
📍 tmux new-session -c $PWD
Adds the TMUX_TMPDIR environment variable to control the socket directory location Not checked yet Adds -c flag to new-session command to set the starting directory for a new session Not checked yet Adds -c flag to new-window command (also aliased as neww) to set the working directory for a new window Not checked yet Adds automatic-rename-format to customize the automatic rename mechanism. Not checked yet Adds the #{pane_synchronized} format specifier to check if a pane is in synchronized mode Not checked yet
5 details in Everything
└──▷ BREAKING ON UPGRADE
! Removal of 88 colour support! Removal of default-path option; use -c flag with new-window or new-session instead
tmux 1.8 adds control mode, absolute pane sizing, and capture-pane with escape sequence support
└──▷ GET THIS VERSION
copy
$ git clone --branch 1.8 https://github.com/tmux/tmux.git
$ git checkout 1.8
└──▷ USE IT
Resize a pane to an exact pixel width and height using the new absolute sizing flags.
shell
copy
tmux resize-pane -x 200 -y 50
Capture pane contents including escape codes and send to stdout for processing.
shell
copy
tmux capture-pane -p -e
Zoom the current pane temporarily to fill the window, allowing focused work.
shell
copy
tmux resize-pane -Z
run-shell gained -t <pane> to specify the target pane for output display. Not checked yet choose-tree gains -u to start in an uncollapsed state. Not checked yet select-window gains -T to toggle to the last active window even if already current. Not checked yet capture-pane gains -p (stdout), -e (escape sequences), -a (alternate screen), and -P (pending output). Not checked yet resize-pane gained -x and -y for absolute pane sizing. Not checked yet
+3 more
show less
resize-pane gained -Z to temporarily zoom a pane. Not checked yet Added control-mode for sending commands programmatically via a client. Not checked yet new-session gained -A to behave like attach-session if the session exists. Not checked yet
8 details in Everything
└──▷ BREAKING ON UPGRADE
! The layout redo/undo feature has been removed.
tmux 1.7 adds status-position, move-pane, c0-rate-limiting options and multiple new CLI flags
└──▷ GET THIS VERSION
copy
$ git clone --branch 1.7 https://github.com/tmux/tmux.git
$ git checkout 1.7
└──▷ USE IT
Move the status bar to the top of the tmux pane for a cleaner view.
text
copy
set-option -g status-position top
Use choose-tree to visually select and switch between sessions/windows.
Send raw hex bytes to a pane without tmux interpreting key sequences.
copy
$ send-keys 0x1B [ C
Add status-position configuration option to place the status line at the top or bottom of the screen Not checked yet Add move-pane command to move panes within the same window (previously only supported across windows) Not checked yet Add -P and -F arguments to break-pane for display formatting Not checked yet Add -q argument to set-option to suppress output when setting options quietly Not checked yet Add wrap-search option to copy mode for wrapping search results Not checked yet
+12 more
show less
Add c0-change-trigger and c0-change-interval configuration options to implement output rate limiting based on C0 character counts Not checked yet Add -C, -N, and -T flags to find-window to match against window content, name, or title respectively Not checked yet Add new choose-tree command to render session/window layout as an interactive tree for selection Not checked yet Add -l flag to send-keys to send input literally without key translation Not checked yet Support hex values in send-keys commands Not checked yet Add -u and -U flags to select-layout for navigating layout history stacks Not checked yet Add -a option to kill-window, detach-client, and kill-session to kill all targets except the current one Not checked yet Add -r flag to move-window to renumber windows sequentially in a session Not checked yet Add new session option renumber-windows to automatically renumber windows upon closure Not checked yet Add line-continuation support with backslash (\) in configuration files Not checked yet Add -b option to join-pane and move-pane to place panes to the left or above Not checked yet Allow hex values in send-keys commands Not checked yet
17 details in Everything
tmux 1.6 adds mouse copy-mode toggle, pane base index, status line alerts and formatting framework.
└──▷ GET THIS VERSION
copy
$ git clone --branch 1.6 https://github.com/tmux/tmux.git
$ git checkout 1.6
└──▷ USE IT
Toggle read-only mode on a specific client by ID.
shell
copy
tmux switch-client -r -t <client_id>
Configure the first pane to be indexed at 1 instead of the default 0.
shell
copy
set-option -g pane-base-index 1
Configure the new prefix2 option since list syntax is no longer supported.
shell
copy
set-option -g prefix2 C-b
Add -r flag to switch-client to toggle the client read-only flag Not checked yet Add pane-base-index option Not checked yet Provide framework for powerful formatting of command output (list-panes, list-windows, list-sessions) using conditionals and descriptive replacements like #{session_name} Not checked yet Add status-line message attributes and individual alert attributes (bell, content, activity) replacing window-status-alert-{attr,bg,fg} Not checked yet Add CNL and CPL escape sequences for cursor navigation Not checked yet
+3 more
show less
Support $HOME as value for default-path option Not checked yet Add -R flag to send-keys to reset the terminal Not checked yet Drop support for prefix key lists in favor of separate prefix and prefix2 options Not checked yet
8 details in Everything
└──▷ BREAKING ON UPGRADE
! Dropped the ability to have a list of keys in the prefix; use separate prefix and prefix2 options instead.! Removed window-status-alert-{attr,bg,fg} options; use status-line message attributes or individual alert attributes (bell, content, activity) instead.
tmux 1.5 adds mouse support (modes 1002/1003), UTF-8 input, global buffers, new pane/window targets (-P), and enhanced copy-mode commands.
└──▷ GET THIS VERSION
copy
$ git clone --branch 1.5 https://github.com/tmux/tmux.git
$ git checkout 1.5
mouse-select-window and mode-mouse enable window selection via mouse wheel on the status line and automatic entry into copy mode when dragging or scrolling. Not checked yet mouse-utf8 enables UTF-8 mouse input support for compatible terminals. Not checked yet mouse-resize-pane allows resizing panes by dragging their borders with the mouse. Not checked yet Global buffer stack replaces per-session stacks; buffer-limit is now a server option. Not checked yet copy-mode gains select-line, copy-line, and copy-end-of-line commands, plus support for setting the xterm clipboard via escape sequences. Not checked yet
+4 more
show less
new-window and split-window accept -P to print the new pane/window index in target form. Not checked yet detach-client accepts -s to detach all clients attached to a session; list-clients accepts -t for targeting. Not checked yet respawn-pane command allows respawning a pane with its original command. Not checked yet command-prompt accepts -I to set initial context; bell-on-alert triggers terminal bell on alert. Not checked yet
9 details in Everything
└──▷ BREAKING ON UPGRADE
! The buffer system changed from a per-session stack to one global stack, rendering the old per-session buffer logic obsolete and moving buffer-limit to be a server option.
tmux 1.4 adds new session/window/server options and commands for silence monitoring and client management
└──▷ GET THIS VERSION
copy
$ git clone --branch 1.4 https://github.com/tmux/tmux.git
$ git checkout 1.4
└──▷ TRY IT
Trigger a visible alert (flash or message) if the active pane in a window has not received any keystrokes for 5 minutes.
copy
$ tmux set-option -w monitor-silence 300
tmux set-option -g visual-silence on
Switch to the window named web without needing its index number.
copy
$ tmux switch-client -n web
Adds exit-unattached server option to automatically terminate the server when all clients disconnect. Not checked yet Adds destroy-unattached session option to destroy a session upon client detachment. Not checked yet Adds last-pane command to quickly switch focus to the previously active pane. Not checked yet Adds monitor-silence window option and visual-silence session option to monitor and alert on terminal inactivity. Not checked yet Adds -n and -l flags to switch-client for selecting windows by name or index. Not checked yet
+2 more
show less
Adds -a flag to unbind-key to unbind keys globally across all key tables. Not checked yet Updates update-environment to include XAUTHORITY in the list of variables retrieved from the global environment. Not checked yet
7 details in Everything
tmux 1.3 introduces Tiled layout, mouse support in copy mode, custom layouts, and enhanced target flags.
└──▷ GET THIS VERSION
copy
$ git clone --branch 1.3 https://github.com/tmux/tmux.git
$ git checkout 1.3
└──▷ TRY IT
Switch to a tiled layout to evenly distribute all open windows.
copy
$ tmux select-layout tiled
Configure tmux to detach clients immediately when the server is destroyed.
copy
$ tmux set-server detach-on-destroy on
Adds Tiled layout option to enable automatic tiled window distribution Not checked yet Enables mouse selection by dragging when mode-mouse is set in copy mode Not checked yet Supports mouse scroll wheel events for navigation Not checked yet Adds -a flag to new-window to insert windows after existing ones with automatic shifting Not checked yet Adds detach-on-destroy server option to control client behavior on session destruction Not checked yet
+7 more
show less
Adds choose-buffer command for buffer selection Not checked yet Allows load-buffer and save-buffer commands to accept - for stdin/stdout I/O Not checked yet Adds -s flag to paste-buffer to specify a custom separator string Not checked yet Allows pipe-pane to process special character sequences like #I Not checked yet Adds window options window-status-alert-{alert,bg,fg} for alert customization Not checked yet Accepts none as a valid value for attribute parameters Not checked yet Uses machine hostname as default session title instead of empty string Not checked yet
12 details in Everything
└──▷ BREAKING ON UPGRADE
! The select-prompt command is removed; use command-prompt -p index 'select-window -t:%%' to replicate the previous binding
tmux 1.2 adds new commands (show-messages, capture-pane, join-pane), pane colours, and server options.
└──▷ GET THIS VERSION
copy
$ git clone --branch 1.2 https://github.com/tmux/tmux.git
$ git checkout 1.2
└──▷ TRY IT
Save the current pane's content to a file for later review.
copy
$ tmux capture-pane -S -100 > pane_log.txt
Configure the status line to show custom formats for current and other windows.
copy
$ set-option -g window-status-current-format '#[bold]#W'#I:#W#[normal]' && set-option -g window-status-format '#I:#W'
Use the new server option to suppress verbose startup messages.
copy
$ set-option -s quiet on
Adds show-messages command to view a per-client log of status line messages. Not checked yet Adds message-limit session option to control the number of logged messages. Not checked yet Adds capture-pane command (alias capturep) to copy pane contents to the paste buffer. Not checked yet Adds window-status-format and window-status-current-format window options for status line formatting. Not checked yet Adds -p flag to display-message to print output instead of displaying it in the status line. Not checked yet
+8 more
show less
Adds pane-active-border-bg, pane-active-border-fg, pane-border-bg, and pane-border-fg session options for pane colours. Not checked yet Adds server-wide options support with -s flag for set-option and show-options. Not checked yet Adds quiet server option to suppress startup messages. Not checked yet Adds escape-time server option to configure escape sequence detection timeout. Not checked yet Adds rectangle copy support in copy mode. Not checked yet Allows pane targets in split-window command. Not checked yet Adds join-pane command (alias joinp) to split and move a pane. Not checked yet Allows window targets (-t) to refer to last, next, or previous windows by number. Not checked yet
13 details in Everything
└──▷ BREAKING ON UPGRADE
! set-window-option and show-window-options commands are now aliases; use set-option -w and show-options -w instead.
tmux 1.1 adds run-shell, lock-server/session options, grouped sessions, and backgrounded status commands.
└──▷ GET THIS VERSION
copy
$ git clone --branch 1.1 https://github.com/tmux/tmux.git
$ git checkout 1.1
└──▷ TRY IT
Run an external command and capture its output within tmux without spawning a window.
copy
$ run-shell 'cat /etc/motd'
Adds run-shell (alias run) command to execute an external command and send stdout to output mode Not checked yet Adds synchronize-panes window option to mirror input across panes Not checked yet Adds grouped sessions capability via -t flag on new-session to sync linked windows Not checked yet
3 details in Everything
└──▷ BREAKING ON UPGRADE
! set-password command removed! -U command line flag removed per the removal of set-password! Internal locking mechanism removed in favor of lock-command session option! -d command line flag removed
tmux 1.0 adds new commands (choose-client, if-shell), UI options (window title format, visual bell), and /etc/tmux.conf support
└──▷ GET THIS VERSION
copy
$ git clone --branch 1.0 https://github.com/tmux/tmux.git
$ git checkout 1.0
└──▷ USE IT
Load the global system-wide configuration file when starting a tmux server.
shell
copy
tmux -u -f /etc/tmux.conf
Run a command only if a specific condition (e.g., file existence) is met.
shell
copy
if-shell '[ -f /tmp/flag ]' 'display-message "Flag exists"'
Configure the status line to use UTF-8 and custom formatting.
config
copy
# /etc/tmux.conf
set -g status-utf8 on
set -g status-left '[#S]'
Adds the choose-client command for selecting a client session. Not checked yet Adds a system-wide configuration file at /etc/tmux.conf. Not checked yet Adds terminal-overrides option to override terminal settings. Not checked yet Adds -u flag to the server start command to automatically set utf8 options. Not checked yet Adds if-shell command to test shell conditions before running tmux commands. Not checked yet
5 details in Everything
└──▷ BREAKING ON UPGRADE
! The -t flag target notation now accepts fnmatch(3) patterns and looks for prefixes, changing how window/pane selection is interpreted.
tmux 0.9 adds monitor-content, clear-history, confirm-before, and refactors resize-pane
└──▷ GET THIS VERSION
copy
$ git clone --branch 0.9 https://github.com/tmux/tmux.git
$ git checkout 0.9
Adds monitor-content window option and fnmatch pattern support to find-window command to monitor windows for specific patterns. Not checked yet Adds previous-layout, select-layout, and main-horizontal layout commands. Not checked yet Adds clear-history command to clear the history buffer of a window. Not checked yet Replaces resize-pane-up and resize-pane-down with a unified resize-pane command accepting -U and -D flags. Not checked yet Adds confirm-before command to require user confirmation before executing dangerous commands. Not checked yet
5 details in Everything
└──▷ BREAKING ON UPGRADE
! The resize-pane-up and resize-pane-down commands have been removed in favor of the new resize-pane command.
Adds monitor-content window option to trigger status-line highlights on text matching.
└──▷ TRY IT
Trigger a visual alert in the status bar when a specific error or success message appears in the terminal output.
copy
$ tmux set-window-option monitor-content 'ERROR'
Adds monitor-content window option to detect strings and highlight the status line. Not checked yet Auto-detects UTF-8 terminal support by checking LANG environment variable contents. Not checked yet
2 details in Everything
Adds main-horizontal layout and new options for pane sizing
Adds main-pane-height option to control the height of the large pane in main-horizontal layout Not checked yet Adds main-pane-width option to set the width of the large left pane with main-vertical layout (previously called left-vertical) Not checked yet Renames manual layout to manual-vertical Not checked yet
3 details in Everything
└──▷ BREAKING ON UPGRADE
! The manual layout name is now manual-vertical, so existing configurations referencing manual will fail or behave unexpectedly until updated.
Adds clear-history command for clearing pane history.
└──▷ TRY IT
Clear the scrollback history of the current pane via a key binding or command.
copy
$ tmux clear-history
Paste the first line of the upper paste buffer using the new status line keys in vi mode.
📍 press p (after prefix) in vi mode
Adds status line keys (p in vi mode, M-y in emacs) to paste the first line of the upper paste buffer Not checked yet
1 detail in Everything
New previous-layout command; window lists now display layout names.
previous-layout command for restoring the prior window layout Not checked yet Window lists now include the current layout name in their output Not checked yet
2 details in Everything
└──▷ BREAKING ON UPGRADE
! resize-pane no longer accepts the standalone resize-pane-up or resize-pane-down commands; use resize-pane -U and resize-pane -D instead.
tmux adds the confirm-before command to require user confirmation before executing destructive actions.
Binds & and x by default to confirm-before "kill-window" and confirm-before "kill-pane" respectively Not checked yet
1 detail in Everything
tmux introduces horizontal splitting and layout management with keybinding C-b space
└──▷ TRY IT
Split the current pane horizontally and cycle through available layouts using the default prefix.
copy
$ tmux send-keys 'C-b space'
tmux adds key-repeat binding via -r flag and improves UTF-8 handling
└──▷ TRY IT
Bind the up arrow key to send C-p repeatedly while held, allowing fast navigation through history.
copy
$ bind-key -r C-p previous-window
Improves UTF-8 support by storing Unicode data in a separate array with combined character handling Not checked yet
1 detail in Everything
tmux adds mouse cursor movement in copy mode and basic mouse input parsing for pane selection.
Enables mouse usage in window/session choice mode Not checked yet Parses common mouse input variants to adjust across panes Not checked yet
2 details in Everything
Adds scroll-mode start position flag and three new attribute options
└──▷ TRY IT
Set bright, blinking status bar using the new option key
copy
$ set -g status-attr bright,blink
Adds -u flag to scroll-mode and copy-mode to start scrolled one page up Not checked yet Adds status-attr, mode-attr, and message-attr options to change status, mode and message attributes Not checked yet
2 details in Everything
tmux adds -k flag to new-window and restores split-window size options
└──▷ TRY IT
Recreate a window, replacing any existing one with the same index immediately.
copy
$ tmux new-window -k
Split the current pane vertically to 50% of the terminal height.
copy
$ tmux split-window -p 50
Adds -k flag to new-window to kill target window if it exists Not checked yet
1 detail in Everything
Introduces automatic-rename window flag and Darwin support for dynamic window titles
└──▷ TRY IT
Disable dynamic window title changes globally for all sessions.
copy
$ tmux set-option -g automatic-rename off
Adds the automatic-rename option to dynamically update window titles based on the running command's argv[0]. Not checked yet Extends automatic-rename functionality to Darwin, using the executable name as the window title source. Not checked yet New-window, new-session, and rename-window commands now automatically set automatic-rename to off when a specific name is provided. Not checked yet
3 details in Everything
tmux adds next-window -a flag, find-window command, and bind-style command sequences
└──▷ TRY IT
Jump to the previously active window based on bell or activity rather than just order.
Adds -a flag to next-window and previous-window to select windows by activity or bell. Not checked yet Enables command sequences in bind commands by separating arguments with \;. Not checked yet
2 details in Everything
New status bar format specifiers (#H, #S) and choose-Window/Session commands
└──▷ USE IT
Bind a key to trigger the interactive session chooser.
shell
copy
tmux bind-key s choose-session
Supports #H for hostname and #S for session name in status-left/right. Not checked yet Adds choose-window command to select a window from a list. Not checked yet Adds choose-session command to select a session from a list. Not checked yet
3 details in Everything
└──▷ BREAKING ON UPGRADE
! The default key binding for listing windows has changed to w (bound to choose-window).! The default key binding for listing sessions has changed to s (bound to choose-session).
tmux 14 January 2009 introduces multi-pane window splitting, repeat-time options, and renamed key bindings.
repeat-time option added to control prefix time delay for up-pane, down-pane, next-window, previous-window, resize-pane-up, and resize-pane-down. Not checked yet
1 detail in Everything
└──▷ BREAKING ON UPGRADE
! The switch-pane command is renamed to select-pane and requires the -p flag.
New command-prompt argument, prefix-time option, resize-pane-* commands, and split-window size args
└──▷ HOW TO FIND IT
Bind the comma key to rename the current window interactively using command-prompt.
📍 bind , command-prompt rename-window %%
Split the current window vertically with the new pane taking up 50% of the width.
copy
$ split-window -h -p 50
command-prompt now accepts a template string argument (with %% substitution) for dynamic command execution. Not checked yet New prefix-time option allows multiple prefix-keyed commands without repressing the key within the time window. Not checked yet New resize-pane-up and resize-pane-down commands for pane resizing. Not checked yet split-window gains -l (lines) and -p (percentage) arguments to specify new pane size. Not checked yet
4 details in Everything
tmux introduces vertical window splitting with new split-window and switch-pane commands.
└──▷ USE IT
Save the active buffer to a file.
shell
copy
:save-buffer /tmp/tmux_buffer.txt
Adds save-buffer command Not checked yet
1 detail in Everything
tmux introduces server locking via set-password/lock-server commands and lock-after-time option.
Adds lock-after-time option to automatically lock the tmux server after a period of inactivity Not checked yet Adds set-password command to configure authentication for server locking Not checked yet Adds lock-server command to manually lock the tmux server session Not checked yet Adds clock-mode command with C-b t binding and configuration options clock-mode-colour and clock-mode-style Not checked yet Adds server-info command to display server and terminal details Not checked yet
+1 more
show less
Adds default-path option to set working directory for new windows created from keys or interactive prompt Not checked yet
6 details in Everything
Adds the xterm-keys window option for controlling escape code output.
└──▷ TRY IT
Enable xterm-style key codes including ctrl, alt, and shift for better terminal application compatibility.
copy
$ tmux setx window-xterm-keys on
Adds xterm-keys window option to control xterm key code output including ctrl, alt, and shift. Not checked yet Refactors terminal code handling by building a code table array per terminal type in tty-term.c instead of using global ncurses variables. Not checked yet
2 details in Everything
tmux adds -u flag to set/setw for inheriting global options again
└──▷ USE IT
Reset a session-specific option to its default inherited value.
shell
copy
tmux set -u session-keys
tmux 06 Jan 2009 adds per-client prompt history and smarter completion with splay tree key binding storage
Improves command-line completion to Complete words at any point inside command in prompt and use option names alongside command names. Not checked yet Replaces key binding array with a splay tree, resulting in key bindings being sorted when listed. Not checked yet
2 details in Everything
tmux (06 December 2008) introduces -g for global options and window-specific message-fg/bgf settings
└──▷ TRY IT
Set global window options like mode colors using the new syntax for window-level configuration.
copy
$ setw -g mode-fg cyan
setw -g mode-bg black
-g flag on set/setw/show/showw commands to apply options globally, changing the default scope from the current pane/window. Not checked yet
1 detail in Everything
└──▷ BREAKING ON UPGRADE
! set and setw now default to the current window/session instead of global scope; configurations must explicitly use -g for global settings.! remain-by-default option removed; use setw -g remain-on-exit instead.
New tmux v0.2 (Dec 2008): status bar length control and window title insertion
Introduces status-left-length and status-right-length options to control the maximum display width of status bar components. Not checked yet
1 detail in Everything
Adds utf8 and utf8-default window/session options for UTF-8 parsing support
└──▷ TRY IT
Enable UTF-8 parsing by default for all new windows in a session
copy
$ tmux set-option utf8-default on
Adds utf8 window option to enable UTF-8 parsing in new windows Not checked yet Adds utf8-default session option to set the default utf8 state for newly created windows Not checked yet
2 details in Everything
Adds -2, -d, and -u flags to force 256-color, default colour, or UTF-8 mode
└──▷ USE IT
Force 256-colour mode when starting a new session with tmux
shell
copy
tmux -2 new-session
Enable UTF-8 support in an existing detached server if the client did not request it
shell
copy
tmux -u attach-session
Adds the -2 flag to force tmux to assume the terminal supports 256 colours Not checked yet Adds the -d flag to force tmux to use default colours, useful for terminals like xterm-256color that lack the AX flag Not checked yet Adds the -u flag to force tmux to assume the terminal supports UTF-8 Not checked yet
3 details in Everything
Adds autodetection for 256-colour terminals via TERM check
└──▷ USE IT
Enable 256-colour output in tmux by setting the environment variable before launch.
shell
copy
export TERM=xterm-256color
tmux
TERM is now checked for the 256col substring to enable 256-colour support. Not checked yet
1 detail in Everything
Adds support for numeric keypad in both application and numbers modes.
Introduces mode-keys option to support vi key bindings in tmux
└──▷ TRY IT
Switch tmux's key table for the next time you enter copy or pane mode.
copy
$ tmux set mode-keys vi
Adds the mode-keys configuration option to split vi and emacs mode keys into separate tables and allow users to select between them Not checked yet
1 detail in Everything
Introduces zombie window support with remain-on-exit and respawn-window command.
Adds the remain-on-exit option to keep windows alive after their child process exits Not checked yet Adds the remain-by-default session option to set the default for remain-on-exit on new windows Not checked yet
2 details in Everything
tmux adds select-prompt and move-window commands with alt key support
Adds select-prompt command to allow a window to be selected at a prompt, bound to '' by default for the current session only Not checked yet Supports binding alt keys using the M- prefix, changing the default control key syntax from ^ to C- Not checked yet Enables escaped key handling (e.g., \033b) allowing copy mode navigation via M-f and M-b Not checked yet
3 details in Everything
Adds list-commands (lscm) command to list available tmux commands
└──▷ USE IT
List all available commands to discover functionality.
shell
copy
tmux list-commands
Use the alias for a quicker invocation.
Improves option parsing and display by splitting option information into a table, allowing abbreviations and proper string output for options like bell-action in show-options. Not checked yet
1 detail in Everything
Adds naive tab completion for command names in the prompt.
Introduces buffer stack management and configurable status message duration
Adds buffer-limit option (default 9) to control maximum buffer stack size in .tmux.conf Not checked yet Adds -b index flag to set-buffer, paste-buffer, delete-buffer, and show-buffer for direct buffer stack manipulation Not checked yet Adds -d flag to paste-buffer to delete the buffer after pasting Not checked yet Adds -t target-session or -t target-window targets to buffer commands for cross-session/window operations Not checked yet Adds display-time option (default 750 ms) in .tmux.conf to set how long status line messages remain visible Not checked yet
5 details in Everything
tmux introduces command-prompt for interactive command entry via : keybind.
└──▷ TRY IT
Enter a command interactively via the new default : prompt keybinding.
copy
$ tmux send-keys ':'
# Then type your command, e.g., 'split-window -h' and press Enter
Adds the command-prompt command, bound to : by default, allowing commands to be entered at a prompt. Not checked yet
1 detail in Everything
tmux introduces -t flag for target specification and argument listing in list-keys
└──▷ TRY IT
Rename a window in session 1 using the new -t flag syntax
copy
$ tmux renamew -t1:0 newname
Adds -t argument to most commands to specify a client, session, or window target using flexible syntax (e.g., session:window, /dev/tty) Not checked yet Adds infrastructure to print arguments in the list-keys output Not checked yet
2 details in Everything
Adds activity monitoring toggle, new status bar options, and vi key bindings.
└──▷ TRY IT
Toggle activity monitoring for the current window to see which windows have output in the status bar.
copy
$ setw monitor-activity
Configure the status bar to show the date on the left, updated every 10 seconds.
copy
$ set status-left '%D'
setw monitor-activity and set status without arguments now toggle the current value; setw monitor-activity determines whether window activity is shown in the status bar (default off). Not checked yet New command set-window-option (alias setw) to set the single current window option, such as monitor-activity. Not checked yet status-left, status-right, and status-interval options allow configuring strings displayed on the left/right of the status bar and the update interval (default 15 seconds). Not checked yet Add vi(1) key bindings in copy mode, supporting binding of ^[, ^\, ^], ^^, and ^_. Not checked yet
4 details in Everything
tmux adds per-session options, -c client flag support, fnmatch wildcards for -s, and a new kill-server command.
└──▷ TRY IT
Match all sessions starting with work using wildcards instead of typing each name.
copy
$ tmux list-sessions -s 'work*'
Terminate the running tmux server instance entirely.
Adds -c flag to specify a client, allowing commands targeting a session to use the attached client's session instead of requiring -s Not checked yet Permits -s session name argument to accept fnmatch(3) wildcards for matching multiple sessions Not checked yet Introduces the kill-server command to terminate the tmux server Not checked yet Allows per-session options via new option scoping rules, where options without a session set remain global Not checked yet
4 details in Everything
tmux introduces start-server command and basic ~/.tmux.conf config file support.
└──▷ USE IT
Start the tmux server background without attaching or creating a session, useful for pre-loading config
shell
copy
tmux start-server
Adds start-server (alias start) subcommand to launch the tmux server without creating sessions or windows Not checked yet Adds support for a configuration file at ~/.tmux.conf (or specified via -f) containing commands executed on server start Not checked yet
2 details in Everything
└──▷ BREAKING ON UPGRADE
! -s and -c flags must be placed after the subcommand (e.g., tmux neww -s0 instead of tmux -s0 neww)
Adds mouse enable/disable feature when terminal supports it.
Adds ^A/^E bindings in copy mode and optimizes history scrolling.
Adds ^A (start-of-line) and ^E (end-of-line) bindings to copy mode Not checked yet Changes scroll behavior to shift 10% of the history buffer instead of one line at a time for faster navigation Not checked yet
2 details in Everything
Adds copy mode with buffer paste and configurable history-limit for tmux sessions
└──▷ USE IT
Enter copy mode to select text, then paste it into another tmux pane.
shell
copy
tmux send-keys C-b '['
# ... use arrow keys or hjkl to select ...
tmux send-keys ' '
# ... move cursor to end of selection ...
tmux send-keys Enter
tmux send-keys C-b ']'
Set history limit for a specific window via command line.
shell
copy
tmux set-option -w history-limit 10000
Introduces copy-mode (triggered by C-b [) with arrow/page/jumping keys and selection via space, allowing text copying into a single buffer that is pasted with C-b ] Not checked yet
1 detail in Everything
Adds switch-client command, -c client-tty flag, and list-available-commands on ambiguity
└──▷ USE IT
Quickly jump between tmux sessions by index using key bindings.
shell
copy
tmux bind q switch-client 0
tmux bind w switch-client 1
switch-client subcommand for switching between sessions by session index Not checked yet tmux -c <client-tty> to invoke client manipulation commands from the CLI Not checked yet Lists available commands when a command is ambiguous Not checked yet
3 details in Everything
Adds kill-session command and default color handling for AX terminals
└──▷ USE IT
Terminate the current tmux session from within a client or script.
shell
copy
tmux kill-session
Adds the kill-session command to terminate the current session. Not checked yet Forces black background and white foreground when the terminal supports default colors (AX present). Not checked yet Completes the man page documentation. Not checked yet
3 details in Everything
Adds link-window and unlink-window commands for window association.
└──▷ TRY IT
Link a window from one session to another with a specific index.
copy
$ tmux -s dstname link-window [-i dstidx] srcname srcidx
link-window command to link an existing window into another session or index Not checked yet
1 detail in Everything
Adds escape sequence support for cursor position requests and save/restore states
tmux adds list-clients command and lifts session name length limits
└──▷ USE IT
List all currently connected tmux clients to verify connections or gather PIDs for scripting.
shell
copy
tmux list-clients
Adds the list-clients subcommand to display connected clients. Not checked yet Lifts the previous limit on session names passed with the -s flag. Not checked yet Displays session and window sizes in list outputs. Not checked yet
3 details in Everything
Adds kill-window command and new bell-style configuration option
└──▷ USE IT
Configure tmux to ignore bell signals except when they originate in the currently active window.
shell
copy
set -g bell-style current
Adds the kill-window command for terminating windows. Not checked yet Introduces the bell-style option to control bell signal handling across sessions. Not checked yet
2 details in Everything
Adds warning on $TMUX existence, send-prefix command, and set status commands for tmux
└──▷ USE IT
Trigger the nested tmux prefix (e.g. Ctrl-b) to be sent to the inner session.
shell
copy
tmux send-prefix
Configure the status bar text color using named colors or numeric indices.
shell
copy
tmux set -g status-fg red
tmux set -g status-bg blue
Adds a warning if $TMUX exists on new or attach sessions Not checked yet Adds the send-prefix command bound to C-b by default Not checked yet Adds set status, status-fg, and status-bg commands for status line configuration Not checked yet
3 details in Everything
Adds -d detach flag to attach, new session commands (attach-session, list-windows, set-option), and rename/select-window support
└──▷ TRY IT
Attach to a session while forcing existing clients to disconnect, useful for reclaiming a hung session.
List all active tmux sessions to identify which one to reattach or manage.
Change the keyboard prefix key from Ctrl-b to Ctrl-a globally for the current session.
copy
$ tmux set-option prefix ^A
Adds -d flag to tmux attach to detach all other clients on the same session. Not checked yet Adds set-option (alias set) command for configuration, e.g., binding keys. Not checked yet Allows specifying a command for the first window when creating new sessions. Not checked yet
3 details in Everything
tmux adds new-window variants, string arguments, key bindings, and client-side command parsing
└──▷ TRY IT
Navigate to the next window using the new subcommand.
Bind Ctrl-Q to create a new window with a specific string argument.
copy
$ tmux bind ^Q create "blah"
Adds new-window, next-window, last-window, and previous-window commands for window navigation. Not checked yet Allows passing "string" values as arguments to commands via tmux bind ^Q create "blah". Not checked yet Introduces tmux bind key command [argument] and tmux unbind key for key binding configuration. Not checked yet
3 details in Everything
└──▷ BREAKING ON UPGRADE
! -s flag must now be passed before the command.
tmux gains detached session creation via -d flag and transient client error handling
Adds -d flag to new-session command to allow creation of detached sessions Not checked yet Enables passing error messages back for transient clients and makes rename -i work Not checked yet
2 details in Everything
tmux splits list into list-sessions and list-windows with new default session selection logic
└──▷ TRY IT
List all active sessions in a script.
copy
$ tmux list-sessions
List all windows across all sessions.
list command is split into list-sessions (alias ls) and list-windows (alias lsw). Not checked yet New default session selection when no name is specified: uses $TMUX, or the single existing session if $TMUX is absent. Not checked yet Session selection now errors if a specified name does not exist. Not checked yet
3 details in Everything
└──▷ BREAKING ON UPGRADE
! list command no longer exists; use list-sessions or list-windows instead.
tmux adds command aliases and reorders syntax to accept options after positional arguments
└──▷ USE IT
Use the new syntax to create a window with a specific name and session simultaneously
shell
copy
tmux new -s mysession -n mywindow
Adds command aliases so users can define short names for built-in commands (e.g., ls for list ) Not checked yet Allows options to follow positional arguments in commands (e.g., new -sabc) aligning with standard CLI conventions Not checked yet
2 details in Everything
└──▷ BREAKING ON UPGRADE
! Commands now require options to be placed AFTER positional arguments (e.g., new -sabc instead of -s new abc), potentially breaking scripts relying on the old option-first syntax