Master tmux: Boost Your Terminal Workflow with Sessions, Windows, and Panes

tmux is a terminal multiplexer for Linux and macOS that lets you manage multiple windows and panes within a single session, enabling you to save and restore workspaces across different machines.

Why use tmux? Even though iTerm2 offers tabs and split panes, tmux adds persistent sessions that can be detached and reattached, which is handy when you need to continue work from another location or recover after an SSH timeout.

Example: After a day of coding on a desktop, you can detach the tmux session, go home, SSH back in, and reattach to pick up exactly where you left off.

Example: If a remote SSH connection drops while debugging on a server, a tmux session preserves all open windows so you can reattach without losing context.

Basic concepts

Session : a collection of windows, usually representing a single task; sessions can be named for easy switching.

Window : an individual visible window, similar to a tab in iTerm2.

Pane : a sub‑division of a window, comparable to Vim’s split‑window layout.

The following diagram illustrates how sessions, windows, and panes appear in tmux:

Installation (macOS example) brew install tmux If you encounter errors after installation, follow these steps: $ tmux Typical error:

dyld: Library not loaded: /usr/local/lib/libevent-2.0.5.dylib

Fix: brew link libevent If linking fails because /usr/local/lib/pkgconfig is not writable, change ownership: sudo chown $USER /usr/local/lib/pkgconfig Then retry the link command.

Basic operations

All shortcuts start with the prefix key (default Ctrl+b). Below are the most common commands.

Session commands

prefix s

– list and switch sessions prefix d – detach from the current session prefix $ – rename the current session

Window commands

prefix c

– create a new window prefix Space – switch to the previously active window prefix & – close the current window prefix <window‑number> – switch to a specific window by number

Pane commands

prefix o

– move to the next pane prefix q – show pane numbers prefix " – split pane vertically prefix % – split pane horizontally prefix z – toggle zoom for the active pane

Personalization

The default tmux appearance is plain; for a richer look you can use the popular gpakosz/.tmux configuration, which adds powerline styling, battery status, macOS clipboard integration, and Vim‑like key bindings.

Installation steps:

cd ~
rm -rf .tmux
git clone https://github.com/gpakosz/.tmux.git
ln -s .tmux/.tmux.conf
cp .tmux/.tmux.conf.local .
# (install powerline first if you want the theme)