tmux Cheatsheet
tmux terminal multiplexer commands in plain language: sessions, windows, split panes, synchronized input, copy mode, and scripting against tmux 3.6.
How it works
tmux uses a three-level hierarchy: a persistent server holds sessions (projects), each session holds windows (tabs), and each window splits into panes. Detaching leaves the session running in the background so you can reconnect later; inside tmux, most key bindings start with the prefix Ctrl-b followed by one key.
Survival kit
The few commands to learn first.
40 commands
Manage sessions (shell)
Sessions survive SSH disconnects and terminal restarts. Name every project session so attaching is effortless.
Official docs: tmux sessions- Essential
Create and attach to a named tmux session.
tmux new -s <name>Build the command
tmux new -s <name>Values are inserted exactly as typed. Quote them yourself if they contain spaces or special characters.
When to use it
Names the session so you can return to the exact workspace after disconnecting or closing your terminal.
Breakdown
- new
- alias for new-session
- -s <name>
- session name
Example
Starts a session named api.
tmux new -s apiAlso works
- tmux new-session -s <name>
See also
Windows (tabs)
Windows act like full-screen tabs inside a session. Each appears in the bottom status bar.
Official docs: Windows and panesSplit & navigate panes
Split one window into multiple panes to edit code beside logs or a test runner.
Official docs: Pane commandsScrollback & copy mode
tmux holds its own scrollback buffer per pane. Enter copy mode to scroll, search logs and copy without leaving the keyboard.
Official docs: Copy modeCommands & configuration
Customize prefix, mouse support and reload ~/.tmux.conf without restarting running sessions.
Official docs: Configuration & optionsTry it in a KitLocal tool
Glossary
- Prefix
- The shortcut pressed before a tmux command key. Default is Ctrl-b (release both keys before pressing the next key).
- Session
- A named workspace containing one or more windows that stays alive on the tmux server after you detach.
- Window
- A full-screen view inside a session (similar to a browser tab), numbered starting at 0 by default.
- Pane
- One rectangular terminal split inside a window, running its own shell.
- Copy mode
- A scrollback and selection mode entered with Ctrl-b [ so you can scroll up and copy text without a mouse.