Getting Started with tmux

Some tools earn their place in your setup by being delightful. tmux earns its place by being there when everything else has gone wrong: when the train Wi-Fi drops mid-deploy, when the VPN gives up at ninety-nine per cent of an upload, when the laptop lid closes at precisely the wrong moment.

tmux is a terminal multiplexer — a small server that runs your shell sessions independently of any terminal window. Your terminal merely looks at a session; it doesn’t own it. Close the window, lose the connection, and everything carries on without you, like a band playing on as the ship lists. Reattach later and it’s all exactly where you left it.

It’s also a window manager for the terminal: tabs (which tmux calls windows) and splits (panes), all drivable from the keyboard, all configured from a single text file. It has been quietly holding the internet together since 2007.

Do you actually need tmux?

Honestly, maybe not — yet. If you picked a terminal from our roundup with native tabs and splits (Ghostty, WezTerm, iTerm2) and you only ever work locally, that may be all you need, and you have our blessing.

tmux becomes close to non-negotiable the moment you SSH into anything. A dropped connection without tmux is a eulogy for whatever was running; with tmux it’s a shrug and a reattach. Locally it’s still worth it for persistence alone: your layout survives the terminal app being closed, and one config file gives you the same setup on every machine you touch.

Install it

brew install tmux

sudo apt install tmux

sudo dnf install tmux

On Windows, install it inside WSL rather than fighting native builds.

The thirty-second mental model

tmux runs a server you never think about, which hosts sessions, which contain windows, which contain panes.

A session is the unit of persistence — the thing that survives disconnects. You attach to it and detach from it.
A window is a tab: one full-screen view.
A pane is a split within a window.

That’s the whole hierarchy. Everything else is keystrokes.

The prefix key

Every tmux command begins with the prefix: Ctrl+B by default. Press it, release, then press the command key. Ctrl+B followed by d means “detach”, for instance.

It’s a modal editor’s idea of a good time, and it exists so tmux’s keys never collide with the ones your shell and editor are already using. If Ctrl+B feels like a reach, the config below shows how to move it — but learn your way around with the default first.

Sessions: the whole point

tmux new -s work           # start a new session called "work"
tmux ls                    # list sessions
tmux attach -t work        # reattach (tmux a -t work for the lazy)
tmux kill-session -t work  # end it, and everything in it

Inside a session, prefix then d detaches — the Irish exit of the terminal: nothing closes, nothing is announced, and it’s all still there when you come back. prefix then $ renames the current session, which beats trying to remember what you called it last Tuesday.

The classic remote workflow, then:

ssh box.example.com
tmux new -s deploy      # or tmux attach -t deploy, if it's already going
# ... long, important things happen ...
# connection drops; nobody panics
ssh box.example.com
tmux attach -t deploy   # everything exactly where you left it

Windows and panes

All of these follow the prefix (Ctrl+B, remember):

Keys	Effect
`c`	New window
`,`	Rename current window
`n` / `p`	Next / previous window
`1`–`9`	Jump straight to a window number
`w`	Interactive picker of all sessions and windows
`&`	Kill current window (asks first)
`%`	Split into panes side by side
`"`	Split into panes stacked top and bottom
Arrow keys	Move between panes
`z`	Zoom the current pane to full window (and back)
`x`	Kill current pane (asks first)

Yes, % and " are the split keys, and no, nobody remembers which is which on the first try — a mnemonic only their author could love. The config below remaps them to | and -, which at least look like the splits they produce.

z is the quiet hero here: zoom a pane to fill the window when the output gets serious, then zoom straight back when you’re done.

Scrollback and copy mode

Press prefix then [ to enter copy mode: scroll with the arrow keys or PageUp, and press q to leave. With mouse mode enabled (see below), ordinary scrolling just works, and selecting text with the mouse copies it. Purists will tut, and they are welcome to.

A starter config worth stealing

The defaults are usable; this is better. Create ~/.tmux.conf:

# Splits that look like the splits they produce
bind | split-window -h
bind - split-window -v

# Mouse: scroll, click to select panes, drag to resize
set -g mouse on

# Number windows and panes from 1 — 0 is the far end of the keyboard
set -g base-index 1
setw -g pane-base-index 1

# Close the numbering gap when a window is killed
set -g renumber-windows on

# Generous scrollback
set -g history-limit 50000

# True colour, assuming a terminal from this century
set -g default-terminal "tmux-256color"
set -ag terminal-overrides ",xterm-256color:RGB"

# Take the lag out of Escape for vim users
set -sg escape-time 10

# Reload this file with prefix + r
bind r source-file ~/.tmux.conf \; display "Config reloaded"

Apply it to a running tmux with tmux source-file ~/.tmux.conf, or simply start a new session.

Surviving reboots

tmux sessions live in memory, so rebooting the machine still takes them with it — the one gap in the persistence story. The tmux-resurrect plugin snapshots and restores sessions, and tmux-continuum does it automatically on a timer. Worth the five minutes once you’re sold on the rest.

Where next

tmux is the layer underneath everything else in your setup. Put a decent window around it with our terminal emulator roundup, make the prompt inside every pane earn its keep with Starship, and keep your fingers honest with the keyboard shortcuts worth memorising — they all work inside tmux, which is rather the point.