tmux

No entries match these filters. Clear filters

1. docs update Sep 10, 2026 · issue 070

   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).⁠︀︄︇︀︅︉︀︅︀︀︃︀︀︅︅︀︅︊︀︄︆︀︃︄⁠
   • 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.
   • 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.
   • Adds refresh-on, refresh-off, and refresh-toggle copy-mode commands to enable live automatic refresh of pane output while in copy mode.
   • 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.

   +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.
   • Adds theme server option (detect/light/dark) and a full set of dark-theme-* / light-theme-* colour options for palette customisation.
   • Adds choose-tree -G flag to include all sessions in session groups in the tree rather than only the first.
   • Extends capture-pane with -H flag to include hyperlinks per line, separated by spaces.
   • Adds Tab key binding in tree/session chooser to fuzzy-match a new window and session.
   • 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).⁠︀︄︇︀︅︉︀︅︀︀︃︀︀︅︅︀︅︊︀︄︆︀︃︄⁠
   • 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.
   • 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.
   • Adds refresh-on, refresh-off, and refresh-toggle copy-mode commands to enable live automatic refresh of pane output while in copy mode.
   • 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.

   +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.
   • Adds Tab key binding in tree/session chooser to fuzzy-match a new window and session.

   3 more in Everything

2. docs update Sep 10, 2026 · issue 070

   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.
   • 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.).
   • 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.
   • 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.
   • 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).

   +8 more show less

   • Adds theme server option (detect, light, dark) so tmux auto-detects the client terminal theme or forces light/dark mode.
   • 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.
   • Adds capture-pane -H flag to include hyperlinks in captured output, with multiple hyperlinks on a line separated by spaces.
   • Adds capture-pane flag to dump internal grid data for diagnostics.
   • Adds -a flag to kill-session to clear alerts (bell, activity, silence) in all windows linked to the session.
   • Adds filter support to kill-pane and kill-window to kill only panes or windows for which a format filter evaluates true.
   • 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.
   • Adds display-panes -k flag to kill the pane when the indicator mode is exited, and -N to start unzoomed.
   • Adds -I flag to new-pane to create an empty pane and forward stdin to it.
   • 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.
   • 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.
   • 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).
   • Adds theme server option (detect, light, dark) so tmux auto-detects the client terminal theme or forces light/dark mode.

   +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.

   7 more in Everything

3. 3.7 Jun 26, 2026 · release notes

   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
   # already have the repo? check out this version:
   $ 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
   • 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
   • Adds message-format option and refactors message drawing so prompts occupy only a portion of the status bar instead of replacing the entire line
   • Adds -g flag to kill-session to kill all sessions in a session group

   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)
4. 3.6 Nov 26, 2025 · release notes

   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
   # already have the repo? check out this version:
   $ 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.
   • Add copy-mode-position-style and copy-mode-selection-style options to style the position indicator and selection highlights in copy mode.
   • Add -M flag to capture-pane to capture the copy mode screen instead of the visible pane content.
   • Add sixel_support format variable to check for SIXEL support, returning 1 if available or 0 on OpenBSD.
   • Extend && and || in format expressions to support arbitrarily many arguments, and add ! and !! operators for not and not-not logic.

   +1 more show less

   • Add -k flag to display-popup to dismiss the popup with any key once the command has exited.

   6 details in Everything

5. 3.5 Sep 27, 2024 · release notes

   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
   # already have the repo? check out this version:
   $ 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).
   • Adds prefix-timeout option to configure the delay before the prefix key expires.
   • Adds --enable-jemalloc build flag to use the jemalloc memory allocator.
   • Adds -d flag to copy-mode to scroll a page down if already in copy mode.
   • Adds copy_cursor_hyperlink format variable to retrieve the hyperlink under the cursor in copy mode.

   +6 more show less

   • Adds search_count and search_count_partial format variables in copy mode for search result counts.
   • Adds mirrored versions of main-horizontal and main-vertical layouts (main pane at bottom or right).
   • Adds -M flag to display-menu to always turn mouse on in a menu.
   • Adds -r flag to refresh-client in control mode for OSC 10 and 11 responses.
   • Adds command-error hook triggered when a command fails.
   • Adds allow-set-title option to forbid applications from changing the pane title.

   11 details in Everything

6. 3.4 Feb 13, 2024 · release notes

   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
   # already have the repo? check out this version:
   $ git checkout 3.4

   • Add options keep-last and keep-group to destroy-unattached to keep the last session whether in a group.
   • Add -t to source-file.
   • Add basic support for SIXEL if built with --enable-sixel.
   • 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.
   • Add flag (-o) to next-prompt/previous-prompt to go to OSC 133 command output.

   +27 more show less

   • Add options and flags for menu styles (menu-style, menu-border-style) similar to those existing for popups.
   • Add support for marking lines with a shell prompt based on the OSC 133 extension.
   • Add flags (-c and -y) to change the confirm key and default behaviour of confirm-before.
   • Set default lock command to vlock on Linux if present at build time.
   • Add support for spawning panes in separate cgroups with systemd and a configure flag (--disable-cgroups) to turn off.
   • Add a format (pane_unseen_changes) to show if there are unseen changes while in a mode.
   • Add an L modifier like P, W, S to loop over clients.
   • Add -f to list-clients like the other list commands.
   • Extend display-message to work for control clients.
   • Add a flag to display-menu to select the menu item selected when the menu is open.
   • 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.
   • Add send-keys -K to handle keys directly as if typed (so look up in key table).
   • Add a -l flag to display-message to disable format expansion.
   • Add paste-buffer-deleted notification and fix name of paste-buffer-changed.
   • Do not attempt to connect to the socket as a client if systemd is active.
   • Add scroll-top and scroll-bottom commands to scroll so cursor is at top or bottom.
   • 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.
   • Add message-line option to control where message and prompt go.
   • Notification when a paste buffer is deleted.
   • Add a Nobr terminfo(5) capability to tell tmux the terminal does not use bright colours for bold.
   • Change g and G to go to top and bottom in menus.
   • Add a third state all to allow-passthrough to work even in invisible panes.
   • Add support for OSC 8 hyperlinks.
   • Store the time lines are scrolled into history and display in copy mode.
   • Add a %config-error reply to control mode for configuration file errors since reporting them in view mode is useless.
   • A new feature flag (ignorefkeys) to ignore terminfo(5) function key definitions for rxvt.
   • Pass through first argument to OSC 52 (which clipboards to set) if the application provides it.

   32 details in Everything

7. 3.3 Jun 1, 2022 · release notes

   tmux 3.3 adds server ACLsACLsAn 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
   # already have the repo? check out this version:
   $ 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
   • Add --enable-systemd build flag to support systemd socket activation
   • Add pane_start_path, next_session_id, client/server UID and user formats, and remain-on-exit-format
   • Add window-resized hook and client-active hook for resize and focus events
   • 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

   +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
   • Add option fill-character for unused client areas and scroll-on-clear to control history scrolling on clear
   • Add OSC 7 capability via the existing set-titles option and response to OSC 4 queries
   • Add pane-border-indicators option and make pane-border-format a pane option instead of window
   • Add cursor-style and cursor-colour options, and support for underscore styles in capture-pane -e
   • Add -F to command-prompt, new command histories per prompt type, and background execution with -b for command-prompt/confirm-before
   • Add pipe variants of line copy commands and -and-cancel variant for copy-line/copy-end-of-line
   • Change {} to expand immediately upon parsing, requiring valid tmux commands inside

   13 details in Everything

8. 3.2a Jun 10, 2021 · release notes

   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
   # already have the repo? check out this version:
   $ git checkout 3.2a

   • Adds always value for the extended-keys option to force forwarding of extended keys regardless of application request
   • Adds a mouse terminal feature to enable mouse support on terminals where terminfo claims it is unsupported

   2 details in Everything

9. 3.2 Apr 13, 2021 · release notes

   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
   # already have the repo? check out this version:
   $ 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.
   • Add -f flag to attach-session, new-session, and refresh-client to set an independent active pane.
   • Support configurable shortcut keys in buffer, client, and tree modes using the -K format flag with choose-* commands.
   • Add -w flag to set-buffer and load-buffer to send content to clipboard via OSC 52.
   • Add -q flag to unbind-key to suppress errors when binding is not present.

   +4 more show less

   • Introduce rectangle-on and rectangle-off commands for copy mode.
   • Support color spelling in addition to colour across various configuration options.
   • Add support for extended keys using xterm CSICSIAn ambiguous acronym spanning Container Storage Interface, Crime Scene Investigation, and other expansions — without more context about which domain this tool operates in, a reliable definition cannot be given. 27 ~ or libtickit CSI u sequences via the extended-keys option.
   • Allow pane border line styles to be configured as single, double, heavy, simple, or number lines.

   9 details in Everything

10. 3.1 Feb 4, 2020 · release notes

    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
    # already have the repo? check out this version:
    $ 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
    • Adds -N flag to bind-key for key binding notes and -N to list-keys to display them
    • Adds ~ to quoted characters for the %%% escape sequence
    • Adds support for iTerm2 DSR 1337 sequence and DECSLRM detection
    • Adds selection_active format for non-moving selections

    +8 more show less

    • Adds new formats: pane_path, xpixel, ypixel, window_marked_flag, and word/line/cursor position in copy mode
    • Adds -p format modifier for padding to width and allows multiple substitutions in a single format
    • Adds -f flag to join-pane for full size and -Z flags to rotate-window, select-pane, swap-pane, switch-client
    • Adds -N to capture-pane to preserve trailing spaces
    • Adds push-default/pop-default styles in status-format[0] and push_default/pop_default support
    • Adds reverse sorting in tree, client, and buffer modes
    • Adds an option to set the key sent by backspace for systems using ^H rather than ^?
    • Adds latest window-size option which sizes windows based on the most recently used client

    13 details in Everything

11. 3.0 May 29, 2019 · release notes

    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
    # already have the repo? check out this version:
    $ 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.
    copy

    $ send-keys -H '|'

    • Add new display-menu command to create simple menus with configurable bindings.
    • Add {} string syntax to .tmux.conf for multi-line strings without escaping.
    • Add -H flag to send-keys to send literal keys.
    • Add support for the SD (scroll down) escape sequence and underscore colours (Setulc).
    • Add pane options via set-option -p, inheriting from window options.

    +6 more show less

    • Add regular expression support to format search/match/substitute modifiers; -r flag for find-window.
    • Add -A flag to show-options to display parent options with a * marker.
    • Add new <, >, <=, and >= comparison operators for formats.
    • Store hooks as array options allowing multiple commands, executed in index order.
    • Add -e flag to new-window, split-window, respawn-window, and respawn-pane to pass environment variables.
    • Add -no-clear variants of copy-selection and copy-pipe to preserve selection after copying.

    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 \'. \
12. 2.9 Mar 26, 2019 · release notes

    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
    # already have the repo? check out this version:
    $ 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.
    • Adds default-size option to set the initial size of new windows when window-size is manual.
    • Adds resize-window command with -a, -A, -x, and -y flags for manual window resizing beyond client bounds.
    • 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.
    • 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.

    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.
13. 2.8 Aug 17, 2018 · release notes

    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
    # already have the repo? check out this version:
    $ git checkout 2.8

    • set-hook -R runs a hook command immediately rather than waiting for the next event
    • Add Any key to run a command if a key is pressed that is not bound in the current key table
    • New format token rectangle_toggle available in pane and window formatting strings
    • Add pane focus hooks (pane_focus_in, pane_focus_out) to react to user activity

    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
14. 2.7 Mar 22, 2018 · release notes

    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
    # already have the repo? check out this version:
    $ git checkout 2.7

    • Add -Z flag to choose-tree, choose-client, and choose-buffer to auto-zoom panes when entering the mode
    • Add -I option to pipe-pane to connect stdin of the child process
    • Support %else in config files to match %if statements

    3 details in Everything

    └──▷ BREAKING ON UPGRADE

    • !The allow-rename option default changes to off
15. 2.6 Oct 5, 2017 · release notes

    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
    # already have the repo? check out this version:
    $ git checkout 2.6

    • Adds select-pane -T to set pane title.
    • Supports REP escape sequence (\033[b).
    • Adds -d flag to display-panes to override display-panes-time.
    • Adds selection_present format for copy mode.
    • Adds pane_at_left, pane_at_right, pane_at_top and pane_at_bottom formats.

    +8 more show less

    • Adds pane_pipe format to show if pipe-pane is active.
    • Allows punctuation in pane_current_command.
    • Adds -c for respawn-pane and respawn-window.
    • Adds user-keys option for user-defined key escape sequences (User0 to User999).
    • Adds pane-set-clipboard hook.
    • Supports SIGUSR2 to toggle logging on a running server.
    • Expands formats in option names and adds -F flag to expand them in option values.
    • Major rewrite of choose mode includes preview, sorting, searching and tagging; filtering in tree mode.

    13 details in Everything

    └──▷ BREAKING ON UPGRADE

    • !Removes the bell-on-alert option.
    • !choose-window and choose-session are now aliases of choose-tree.
16. 2.5 May 9, 2017 · release notes

    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
    # already have the repo? check out this version:
    $ git checkout 2.5

    • Adds pane_search_string format for the last search term while in copy mode
    • Adds new control mode notifications and corresponding hooks: pane-mode-changed, window-pane-changed, client-session-changed, session-window-changed

    2 details in Everything

17. 2.4 Apr 20, 2017 · release notes

    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
    # already have the repo? check out this version:
    $ 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.
    • Adds the copy-pipe-and-cancel command available via send-keys -X for copy mode workflows.
    • source-file now supports glob patterns for loading multiple config files.
    • The %if/%endif blocks in .tmux.conf allow conditional configuration processing based on format comparisons (#{==:} or #{!=:}).
    • Adds new formats #{version}, #{client_termtype}, #{client_name}, and #{client_written} for status lines and conditionals.

    +2 more show less

    • Added support for OSC 52 to allow programs inside tmux to set the tmux paste buffer from within panes.
    • New -E flag on detach-client executes a command to replace the client process instead of detaching.

    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.
18. 2.3 Sep 29, 2016 · release notes

    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
    # already have the repo? check out this version:
    $ git checkout 2.3

    • Adds pane-border-status option to control text displayed in pane borders
    • Adds support for before and after hooks on commands via new hook points
    • Adds -f flag to split-window command for performing a full-width split
    • Adds -q flag to source-file command to suppress errors for nonexistent files
    • Allows report count specification when using bind-key -R

    +2 more show less

    • Enables appending to user options via set -a for @foo style options
    • display-panes can now accept a command argument instead of just selecting a pane

    7 details in Everything

19. 2.2 Apr 10, 2016 · release notes

    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
    # already have the repo? check out this version:
    $ 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
    • Enables alert-bell, alert-silence, alert-activity, client-attached, client-detached, client-resized, pane-died, and pane-exited hooks for event-driven automation
    • Adds RGB (24bit) colour support via the Tc TERM flag

    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.
20. 2.1 Oct 18, 2015 · release notes

    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
    # already have the repo? check out this version:
    $ 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.
    copy

    $ copy-selection -x

    • Adds mouse session option to replace four separate mouse-* options
    • Adds new format specifiers: session_activity, window_linked, window_activity_format, session_alerts, session_last_attached, client_pid, and pid
    • Adds -x flag to copy-selection, append-selection, and start-named-buffer to prevent exiting copying mode
    • Adds -P flag to select-pane to set window/pane background colours
    • Adds -M flag to select-pane for marking a pane for use with src-pane specifiers

    +2 more show less

    • Adds -e flag to copy-mode to exit copy-mode when scrolling to the end
    • Adds history-file option to save/restore command prompt history

    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
21. 2.0 Mar 6, 2015 · release notes

    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
    # already have the repo? check out this version:
    $ git checkout 2.0

    • set-buffer gains append mode via -a flag and the ability to assign names to buffers
    • capture-pane supports -S- and -E- flags to denote pane start and end ranges

    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.
22. 1.9 Feb 20, 2014 · release notes

    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
    # already have the repo? check out this version:
    $ 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
    • Adds -c flag to new-session command to set the starting directory for a new session
    • Adds -c flag to new-window command (also aliased as neww) to set the working directory for a new window
    • Adds automatic-rename-format to customize the automatic rename mechanism.
    • Adds the #{pane_synchronized} format specifier to check if a pane is in synchronized mode

    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
23. 1.8 Mar 26, 2013 · release notes

    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
    # already have the repo? check out this version:
    $ 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.
    • choose-tree gains -u to start in an uncollapsed state.
    • select-window gains -T to toggle to the last active window even if already current.
    • capture-pane gains -p (stdout), -e (escape sequences), -a (alternate screen), and -P (pending output).
    • resize-pane gained -x and -y for absolute pane sizing.

    +3 more show less

    • resize-pane gained -Z to temporarily zoom a pane.
    • Added control-mode for sending commands programmatically via a client.
    • new-session gained -A to behave like attach-session if the session exists.

    8 details in Everything

    └──▷ BREAKING ON UPGRADE

    • !The layout redo/undo feature has been removed.
24. 1.7 Oct 13, 2012 · release notes

    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
    # already have the repo? check out this version:
    $ 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.
    copy

    $ choose-tree

    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
    • Add move-pane command to move panes within the same window (previously only supported across windows)
    • Add -P and -F arguments to break-pane for display formatting
    • Add -q argument to set-option to suppress output when setting options quietly
    • Add wrap-search option to copy mode for wrapping search results

    +12 more show less

    • Add c0-change-trigger and c0-change-interval configuration options to implement output rate limiting based on C0 character counts
    • Add -C, -N, and -T flags to find-window to match against window content, name, or title respectively
    • Add new choose-tree command to render session/window layout as an interactive tree for selection
    • Add -l flag to send-keys to send input literally without key translation
    • Support hex values in send-keys commands
    • Add -u and -U flags to select-layout for navigating layout history stacks
    • Add -a option to kill-window, detach-client, and kill-session to kill all targets except the current one
    • Add -r flag to move-window to renumber windows sequentially in a session
    • Add new session option renumber-windows to automatically renumber windows upon closure
    • Add line-continuation support with backslash (\) in configuration files
    • Add -b option to join-pane and move-pane to place panes to the left or above
    • Allow hex values in send-keys commands

    17 details in Everything

25. 1.6 Jan 23, 2012 · release notes

    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
    # already have the repo? check out this version:
    $ 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
    • Add pane-base-index option
    • Provide framework for powerful formatting of command output (list-panes, list-windows, list-sessions) using conditionals and descriptive replacements like #{session_name}
    • Add status-line message attributes and individual alert attributes (bell, content, activity) replacing window-status-alert-{attr,bg,fg}
    • Add CNL and CPL escape sequences for cursor navigation

    +3 more show less

    • Support $HOME as value for default-path option
    • Add -R flag to send-keys to reset the terminal
    • Drop support for prefix key lists in favor of separate prefix and prefix2 options

    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.
26. 1.5 Jul 9, 2011 · release notes

    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
    # already have the repo? check out this version:
    $ 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.
    • mouse-utf8 enables UTF-8 mouse input support for compatible terminals.
    • mouse-resize-pane allows resizing panes by dragging their borders with the mouse.
    • Global buffer stack replaces per-session stacks; buffer-limit is now a server option.
    • copy-mode gains select-line, copy-line, and copy-end-of-line commands, plus support for setting the xterm clipboard via escape sequences.

    +4 more show less

    • new-window and split-window accept -P to print the new pane/window index in target form.
    • detach-client accepts -s to detach all clients attached to a session; list-clients accepts -t for targeting.
    • respawn-pane command allows respawning a pane with its original command.
    • command-prompt accepts -I to set initial context; bell-on-alert triggers terminal bell on alert.

    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.
27. 1.4 Dec 27, 2010 · release notes

    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
    # already have the repo? check out this version:
    $ 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.
    • Adds destroy-unattached session option to destroy a session upon client detachment.
    • Adds last-pane command to quickly switch focus to the previously active pane.
    • Adds monitor-silence window option and visual-silence session option to monitor and alert on terminal inactivity.
    • Adds -n and -l flags to switch-client for selecting windows by name or index.

    +2 more show less

    • Adds -a flag to unbind-key to unbind keys globally across all key tables.
    • Updates update-environment to include XAUTHORITY in the list of variables retrieved from the global environment.

    7 details in Everything

28. 1.3 Jul 18, 2010 · release notes

    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
    # already have the repo? check out this version:
    $ 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
    • Enables mouse selection by dragging when mode-mouse is set in copy mode
    • Supports mouse scroll wheel events for navigation
    • Adds -a flag to new-window to insert windows after existing ones with automatic shifting
    • Adds detach-on-destroy server option to control client behavior on session destruction

    +7 more show less

    • Adds choose-buffer command for buffer selection
    • Allows load-buffer and save-buffer commands to accept - for stdin/stdout I/O
    • Adds -s flag to paste-buffer to specify a custom separator string
    • Allows pipe-pane to process special character sequences like #I
    • Adds window options window-status-alert-{alert,bg,fg} for alert customization
    • Accepts none as a valid value for attribute parameters
    • Uses machine hostname as default session title instead of empty string

    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
29. 1.2 Mar 10, 2010 · release notes

    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
    # already have the repo? check out this version:
    $ 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.
    • Adds message-limit session option to control the number of logged messages.
    • Adds capture-pane command (alias capturep) to copy pane contents to the paste buffer.
    • Adds window-status-format and window-status-current-format window options for status line formatting.
    • Adds -p flag to display-message to print output instead of displaying it in the status line.

    +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.
    • Adds server-wide options support with -s flag for set-option and show-options.
    • Adds quiet server option to suppress startup messages.
    • Adds escape-time server option to configure escape sequence detection timeout.
    • Adds rectangle copy support in copy mode.
    • Allows pane targets in split-window command.
    • Adds join-pane command (alias joinp) to split and move a pane.
    • Allows window targets (-t) to refer to last, next, or previous windows by number.

    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.
30. 1.1 Nov 5, 2009 · release notes

    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
    # already have the repo? check out this version:
    $ 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
    • Adds synchronize-panes window option to mirror input across panes
    • Adds grouped sessions capability via -t flag on new-session to sync linked windows

    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
31. 1.0 Sep 20, 2009 · release notes

    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
    # already have the repo? check out this version:
    $ 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.
    • Adds a system-wide configuration file at /etc/tmux.conf.
    • Adds terminal-overrides option to override terminal settings.
    • Adds -u flag to the server start command to automatically set utf8 options.
    • Adds if-shell command to test shell conditions before running tmux commands.

    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.
32. 0.9 Jul 1, 2009 · release notes

    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
    # already have the repo? check out this version:
    $ git checkout 0.9

    • Adds monitor-content window option and fnmatch pattern support to find-window command to monitor windows for specific patterns.
    • Adds previous-layout, select-layout, and main-horizontal layout commands.
    • Adds clear-history command to clear the history buffer of a window.
    • Replaces resize-pane-up and resize-pane-down with a unified resize-pane command accepting -U and -D flags.
    • Adds confirm-before command to require user confirmation before executing dangerous commands.

    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.
33. 19 May 2009 May 19, 2009 · release notes

    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.
    • Auto-detects UTF-8 terminal support by checking LANG environment variable contents.

    2 details in Everything

34. 18 May 2009 May 18, 2009 · release notes

    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
    • Adds main-pane-width option to set the width of the large left pane with main-vertical layout (previously called left-vertical)
    • Renames manual layout to manual-vertical

    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.
35. 14 May 2009 May 14, 2009 · release notes

    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

    1 detail in Everything

36. 30 April 2009 Apr 30, 2009 · release notes

    New previous-layout command; window lists now display layout names.

    • previous-layout command for restoring the prior window layout
    • Window lists now include the current layout name in their output

    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.
37. 27 April 2009 Apr 27, 2009 · release notes

    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

    1 detail in Everything

38. 01 April 2009 Apr 1, 2009 · release notes

    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'

39. 28 March 2009 Mar 28, 2009 · release notes

    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

    1 detail in Everything

40. 28 January 2009 Jan 28, 2009 · release notes

    tmux adds mouse cursor movement in copy mode and basic mouse input parsing for pane selection.

    • Enables mouse usage in window/session choice mode
    • Parses common mouse input variants to adjust across panes

    2 details in Everything

41. 27 January 2009 Jan 27, 2009 · release notes

    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
    • Adds status-attr, mode-attr, and message-attr options to change status, mode and message attributes

    2 details in Everything

42. 21 January 2009 Jan 21, 2009 · release notes

    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

    1 detail in Everything

43. 20 January 2009 Jan 20, 2009 · release notes

    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].
    • Extends automatic-rename functionality to Darwin, using the executable name as the window title source.
    • New-window, new-session, and rename-window commands now automatically set automatic-rename to off when a specific name is provided.

    3 details in Everything

44. 18 January 2009 Jan 18, 2009 · release notes

    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.
    copy

    $ next-window -a

    • Adds -a flag to next-window and previous-window to select windows by activity or bell.
    • Enables command sequences in bind commands by separating arguments with \;.

    2 details in Everything

45. 15 January 2009 Jan 15, 2009 · release notes

    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.
    • Adds choose-window command to select a window from a list.
    • Adds choose-session command to select a session from a list.

    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).
46. 14 January 2009 Jan 14, 2009 · release notes

    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.

    1 detail in Everything

    └──▷ BREAKING ON UPGRADE

    • !The switch-pane command is renamed to select-pane and requires the -p flag.
47. 12 January 2009 Jan 12, 2009 · release notes

    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.
    • New prefix-time option allows multiple prefix-keyed commands without repressing the key within the time window.
    • New resize-pane-up and resize-pane-down commands for pane resizing.
    • split-window gains -l (lines) and -p (percentage) arguments to specify new pane size.

    4 details in Everything

48. 11 January 2009 Jan 11, 2009 · release notes

    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

    1 detail in Everything

49. 10 January 2009 Jan 10, 2009 · release notes

    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
    • Adds set-password command to configure authentication for server locking
    • Adds lock-server command to manually lock the tmux server session
    • Adds clock-mode command with C-b t binding and configuration options clock-mode-colour and clock-mode-style
    • Adds server-info command to display server and terminal details

    +1 more show less

    • Adds default-path option to set working directory for new windows created from keys or interactive prompt

    6 details in Everything

50. 09 January 2009 Jan 9, 2009 · release notes

    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.
    • Refactors terminal code handling by building a code table array per terminal type in tty-term.c instead of using global ncurses variables.

    2 details in Everything

51. 07 January 2009 Jan 7, 2009 · release notes

    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

52. 06 January 2009 Jan 6, 2009 · release notes

    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.
    • Replaces key binding array with a splay tree, resulting in key bindings being sorted when listed.

    2 details in Everything

53. 06 December 2008 Dec 6, 2008 · release notes

    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.

    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.
54. 02 December 2008 Dec 2, 2008 · release notes

    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.

    1 detail in Everything

55. 16 November 2008 Nov 16, 2008 · release notes

    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
    • Adds utf8-default session option to set the default utf8 state for newly created windows

    2 details in Everything

56. 25 September 2008 Sep 25, 2008 · release notes

    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
    • Adds the -d flag to force tmux to use default colours, useful for terminals like xterm-256color that lack the AX flag
    • Adds the -u flag to force tmux to assume the terminal supports UTF-8

    3 details in Everything

57. 08 September 2008 Sep 8, 2008 · release notes

    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.

    1 detail in Everything

58. 24 July 2008 Jul 24, 2008 · release notes

    Adds support for numeric keypad in both application and numbers modes.

59. 02 July 2008 Jul 2, 2008 · release notes

    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

    1 detail in Everything

60. 29 June 2008 Jun 29, 2008 · release notes

    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
    • Adds the remain-by-default session option to set the default for remain-on-exit on new windows

    2 details in Everything

61. 25 June 2008 Jun 25, 2008 · release notes

    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
    • Supports binding alt keys using the M- prefix, changing the default control key syntax from ^ to C-
    • Enables escaped key handling (e.g., \033b) allowing copy mode navigation via M-f and M-b

    3 details in Everything

62. 23 June 2008 Jun 23, 2008 · release notes

    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.
    shell copy

    tmux lscm

    • 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.

    1 detail in Everything

63. 21 June 2008 Jun 21, 2008 · release notes

    Adds naive tab completion for command names in the prompt.

64. 20 June 2008 Jun 20, 2008 · release notes

    Introduces buffer stack management and configurable status message duration

    • Adds buffer-limit option (default 9) to control maximum buffer stack size in .tmux.conf
    • Adds -b index flag to set-buffer, paste-buffer, delete-buffer, and show-buffer for direct buffer stack manipulation
    • Adds -d flag to paste-buffer to delete the buffer after pasting
    • Adds -t target-session or -t target-window targets to buffer commands for cross-session/window operations
    • Adds display-time option (default 750 ms) in .tmux.conf to set how long status line messages remain visible

    5 details in Everything

65. 19 June 2008 Jun 19, 2008 · release notes

    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.

    1 detail in Everything

66. 05 June 2008 Jun 5, 2008 · release notes

    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)
    • Adds infrastructure to print arguments in the list-keys output

    2 details in Everything

67. 04 June 2008 Jun 4, 2008 · release notes

    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).
    • New command set-window-option (alias setw) to set the single current window option, such as monitor-activity.
    • 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).
    • Add vi(1) key bindings in copy mode, supporting binding of ^[, ^\, ^], ^^, and ^_.

    4 details in Everything

68. 03 June 2008 Jun 3, 2008 · release notes

    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.
    copy

    $ tmux kill-server

    • Adds -c flag to specify a client, allowing commands targeting a session to use the attached client's session instead of requiring -s
    • Permits -s session name argument to accept fnmatch(3) wildcards for matching multiple sessions
    • Introduces the kill-server command to terminate the tmux server
    • Allows per-session options via new option scoping rules, where options without a session set remain global

    4 details in Everything

69. 02 June 2008 Jun 2, 2008 · release notes

    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
    • Adds support for a configuration file at ~/.tmux.conf (or specified via -f) containing commands executed on server start

    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)
70. 27 November 2007 Nov 27, 2007 · release notes

    Adds mouse enable/disable feature when terminal supports it.

71. 26 November 2007 Nov 26, 2007 · release notes

    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
    • Changes scroll behavior to shift 10% of the history buffer instead of one line at a time for faster navigation

    2 details in Everything

72. 23 November 2007 Nov 23, 2007 · release notes

    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 ]

    1 detail in Everything

73. 16 November 2007 Nov 16, 2007 · release notes

    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
    • tmux -c <client-tty> to invoke client manipulation commands from the CLI
    • Lists available commands when a command is ambiguous

    3 details in Everything

74. 12 November 2007 Nov 12, 2007 · release notes

    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.
    • Forces black background and white foreground when the terminal supports default colors (AX present).
    • Completes the man page documentation.

    3 details in Everything

75. 26 October 2007 Oct 26, 2007 · release notes

    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

    1 detail in Everything

76. 24 October 2007 Oct 24, 2007 · release notes

    Adds escape sequence support for cursor position requests and save/restore states

77. 23 October 2007 Oct 23, 2007 · release notes

    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.
    • Lifts the previous limit on session names passed with the -s flag.
    • Displays session and window sizes in list outputs.

    3 details in Everything

78. 19 October 2007 Oct 19, 2007 · release notes

    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.
    • Introduces the bell-style option to control bell signal handling across sessions.

    2 details in Everything

79. 12 October 2007 Oct 12, 2007 · release notes

    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
    • Adds the send-prefix command bound to C-b by default
    • Adds set status, status-fg, and status-bg commands for status line configuration

    3 details in Everything

80. 04 October 2007 Oct 4, 2007 · release notes

    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.
    copy

    $ tmux attach -d

    List all active tmux sessions to identify which one to reattach or manage.
    copy

    $ tmux list-windows

    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.
    • Adds set-option (alias set) command for configuration, e.g., binding keys.
    • Allows specifying a command for the first window when creating new sessions.

    3 details in Everything

81. 03 October 2007 Oct 3, 2007 · release notes

    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.
    copy

    $ tmux next-window

    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.
    • Allows passing "string" values as arguments to commands via tmux bind ^Q create "blah".
    • Introduces tmux bind key command [argument] and tmux unbind key for key binding configuration.

    3 details in Everything

    └──▷ BREAKING ON UPGRADE

    • !-s flag must now be passed before the command.
82. 29 September 2007 Sep 29, 2007 · release notes

    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
    • Enables passing error messages back for transient clients and makes rename -i work

    2 details in Everything

83. 27 September 2007 Sep 27, 2007 · release notes

    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.
    copy

    $ tmux list-windows

    • list command is split into list-sessions (alias ls) and list-windows (alias lsw).
    • New default session selection when no name is specified: uses $TMUX, or the single existing session if $TMUX is absent.
    • Session selection now errors if a specified name does not exist.

    3 details in Everything

    └──▷ BREAKING ON UPGRADE

    • !list command no longer exists; use list-sessions or list-windows instead.
84. 26 September 2007 Sep 26, 2007 · release notes

    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)
    • Allows options to follow positional arguments in commands (e.g., new -sabc) aligning with standard CLI conventions

    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