> For the complete documentation index, see [llms.txt](https://imarslo.gitbook.io/book/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://imarslo.gitbook.io/book/awesomeshell/tmux/cheatsheet.md). # cheatsheet * [files](#files) * [alias](#alias) * [sessions](#sessions) * [linux commands](#linux-commands) * [tmux commands](#tmux-commands) * [shortcuts](#shortcuts) * [windows](#windows) * [shortcuts for windows](#shortcuts-for-windows) * [tmux commands for windows](#tmux-commands-for-windows) * [panes](#panes) * [shortcuts for panes](#shortcuts-for-panes) * [tmux commands for panes](#tmux-commands-for-panes) * [copy mode](#copy-mode) * [shortcuts for copy mode](#shortcuts-for-copy-mode) * [tmux commands for copy mode](#tmux-commands-for-copy-mode) * [misc](#misc) * [shortcuts for misc](#shortcuts-for-misc) * [tmux commands for misc](#tmux-commands-for-misc) * [help](#help) * [linux commands for help](#linux-commands-for-help) * [tmux commands for help](#tmux-commands-for-help) * [shortcuts for help](#shortcuts-for-help) * [tmux format](#tmux-format) > \[!NOTE|label:references:] > > * [tmux cheatsheet](https://tmuxcheatsheet.com/) > * [awesome tmux](https://github.com/rothgar/awesome-tmux) > * [MohamedAlaa/tmux-cheatsheet.markdown](https://gist.github.com/MohamedAlaa/2961058) ## files | FILES | DESCRIPTION | | --------------------------------- | -------------------------------- | | `~/.tmux.conf` | | | `$XDG_CONFIG_HOME/tmux/tmux.conf` | | | `~/.config/tmux/tmux.conf` | Default tmux configuration file. | | `/opt/homebrew/etc/tmux.conf` | System-wide configuration file. | ### alias | COMMAND | ALIAS | | ---------------- | ------------------- | | `attach-session` | `attach`, `at`, `a` | | `detach-client` | `detach` | | `has-session` | `has` | | `list-clients` | `lsc` | | `list-commands` | `lscm` | | `list-sessions` | `ls` | | `lock-client` | `lockc` | | `lock-session` | `locks` | | `new-session` | `new` | | `refresh-client` | `refresh` | | `rename-session` | `rename` | | `show-messages` | `showmsgs` | | `source-file` | `source` | | `start-server` | `start` | | `suspend-client` | `suspend` | | `switch-client` | `switchc` | ## sessions ### linux commands | COMMAND | DESCRIPTION | | ------------------------------------------- | -------------------------------------------------------------------- | | `tmux` | start a new session | | `tmux new-session` | start a new session | | `tmux new` | start a new session | | `tmux new -s ` | start a new session with a name | | `tmux new-session -A -s ` | start a new session or attach to an existing session named mysession | | `tmux new -s -n ` | start a new session with a name and a window | | `tmux new-session -d -s ''` | start a new session with a name and a command | | `tmux list-sessions` | list all sessions | | `tmux ls` | list all sessions | | `tmux kill-session -t ` | kill/delete a session | | `tmux kill-ses -t ` | kill/delete a session | | `tmux kill-session -a` | kill/delete all sessions but the current | | `tmux kill-session -a -t ` | kill/delete all sessions but the | | `tmux attach-session` | attach to the last session | | `tmux attach` | attach to the last session | | `tmux at` | attach to the last session | | `tmux a` | attach to the last session | | `tmux attach-session -t ` | attach to a session | | `tmux attach -t ` | attach to a session | | `tmux at -t ` | attach to a session | | `tmux a -t ` | attach to a session | ### tmux commands | COMMAND | DESCRIPTION | | ---------------- | ---------------------------------------------------------------------- | | `:new` | start a new session | | `:new -s ` | start a new session with a name | | `:kill-session` | kill a session | | `:attach -d` | detach others on the session (Maximize window by detach other clients) | ### shortcuts | SHORTCUTS | DESCRIPTION | | ------------------------------------------- | -------------------------------- | | ctrl + b $ | rename the current session. | | ctrl + b d | detach from the current session. | | ctrl + b s | list all sessions. | | ctrl + b w | session and window preview | | ctrl + b ( | move to previous session | | ctrl + b ) | move to next session | ## windows ### shortcuts for windows | SHORTCUTS | DESCRIPTION | | ---------------------------------------------- | ------------------------------- | | ctrl + b c | create a new window | | ctrl + b , | rename the current window | | ctrl + b & | close the current window | | ctrl + b w | list windows | | ctrl + b p | preview window | | ctrl + b n | next window | | ctrl + b 0..9 | switch to window 0..9 | | ctrl + b l | toggle between last two windows | ### tmux commands for windows | COMMAND | DESCRIPTION | | ----------------------------------------------- | -------------------------------------------------- | | `:swap-window -s -t ` | swap window with window | | `:swap-window -t -1` | swap window with the previous one | | `:move-window -s src_ses:win -t target_ses:win` | move window from src\_ses to target\_ses | | `:movew -s foo:0 -t bar:9` | move window 0 from session foo to 9 in session bar | | `:movew -s 0:0 -t 1:9` | move window 0 from session 0 to 9 in session 1 | | `:move-window -s src_session:src_window` | reposition window in the current session | | `:movew -s 0:9` | reposition window 9 to the current session | | `:move-window -r` | renumber windows to remove gap in the sequence | | `:movew -r` | renumber windows to remove gap in the sequence | ## panes ### shortcuts for panes | SHORTCUTS | DESCRIPTION | | ------------------------------------------------------------- | ---------------------------- | | ctrl + b ; | toggle last active pane | | ctrl + b % | split pane vertically | | ctrl + b " | split pane horizontally | | ctrl + b { | move pane left | | ctrl + b } | move pane right | | ctrl + b ↑ | move pane up | | ctrl + b ← | move pane left | | ctrl + b → | move pane right | | ctrl + b ␣ | toggle between pane layouts | | ctrl + b o | move to the next pane | | ctrl + b q | show pane numbers | | ctrl + b q 0..9 | swith/select the pane number | | ctrl + b z | toggle pane zoom | | ctrl + b ! | convert pannel into a window | | ctrl + b + → | resize current pane width | | ctrl + b ctrl + → | resize current pane width | | ctrl + b + ← | resize current pane width | | ctrl + b ctrl + ← | resize current pane width | | ctrl + b + ↓ | resize current pane height | | ctrl + b ctrl + ↓ | resize current pane height | | ctrl + b + ↑ | resize current pane height | | ctrl + b ctrl + ↑ | resize current pane height | | ctrl + b x | close/kill the current pane | ### tmux commands for panes | COMMAND | DESCRIPTION | | ------------------------- | ---------------------------------------------------------------------------------------------------------------------------------- | | `:split-window -h` |

== ctrl + b %
split the current pane with a vertical line to create a horizontal layout

| | `:split-window -v` |

== ctrl + b "
split the current pane with a horizontal line to create a vertical layout

| | `:join-pane -s 2 -t 1` | join two windows as panes (merge window 2 to window 1 as panes) | | `:joinp -s 2.1 -t 1.0` | move pane from one window to another (move pane 1 from window 2 to pane after 0 of window 1) | | `:setw synchronize-panes` | toggle synchronize panes (send command to all panes) | ## copy mode ### shortcuts for copy mode | SHORTCUTS | DESCRIPTION | | ---------------------------------------------- | ----------------------------------------- | | ctrl + b \[ | enter copy mode | | ctrl + b PgUp | enter copy mode and scroll up one page up | | q | quit copy mode | | g | go to the top of the buffer | | G | go to the bottom of the buffer | | ↑ | scroll up one line | | ↓ | scroll down one line | | k | move cursor up | | j | move cursor down | | h | move cursor left | | l | move cursor right | | w | move cursor forward one worda at a time | | b | move cursor backward one word at a time | | / | search forward | | ? | search backward | | n | next keyword occurrence | | N | previous keyword occurrence | | ␣ | start selection | | esc | clear selection | | ⏎ | copy selection to clipboard | | ctrl + b ] | paste selection | ### tmux commands for copy mode | COMMAND | DESCRIPTION | | ----------------------- | ------------------------------------------------ | | `:setw -g mode-keys vi` | set vi mode keys for copy mode | | `:show-buffer` | show the buffer content | | `:capture-pane` | copy entire visible contents of pane to a buffer | | `:list-buffers` | list all buffers | | `:choose-buffer` | choose a buffer to paste | | `:save-buffer ` | save buffer to a file | | `:delete-buffer -b 1` | delete buffer 1 | ## misc ### shortcuts for misc | SHORTCUTS | DESCRIPTION | | ------------------------------------------- | ------------------ | | ctrl + b : | enter command mode | ### tmux commands for misc | COMMAND | DESCRIPTION | | ----------------- | --------------------------- | | `:set -g OPTION` | set OPTION for all sessions | | `:setw -g OPTION` | set OPTION for all windows | | `:set mouse on` | enable mouse mode | ## help ### linux commands for help | COMMAND | DESCRIPTION | | ------------------------ | ------------------------------------------ | | `$ tmux list-keys` | list key bindings ( shortcuts ) | | `$ tmux info` | show every session, window, panes, etc ... | | `$ tmux show -g` | show global options | | `$ tmux show-options -g` | show global options | ### tmux commands for help | COMMAND | DESCRIPTION | | ------------ | ------------------------------- | | `:list-keys` | list key bindings ( shortcuts ) | ### shortcuts for help | SHORTCUTS | DESCRIPTION | | ------------------------------------------- | ----------- | | ctrl + b ? | show help | ## [tmux format](https://github.com/greymd/tmux-xpanes/wiki/Tmux-Format) | VARIABLE NAME | REPLACED WITH | | ------------------------ | ------------------------------------------------------ | | alternate\_on | If pane is in alternate screen | | alternate\_saved\_x | Saved cursor X in alternate screen | | alternate\_saved\_y | Saved cursor Y in alternate screen | | buffer\_sample | First 50 characters from the specified buffer | | buffer\_size | Size of the specified buffer in bytes | | client\_activity | Integer time client last had activity | | client\_activity\_string | String time client last had activity | | client\_created | Integer time client created | | client\_created\_string | String time client created | | client\_cwd | Working directory of client | | client\_height | Height of client | | client\_last\_session | Name of the client's last session | | client\_prefix | 1 if prefix key has been pressed | | client\_readonly | 1 if client is readonly | | client\_session | Name of the client's session | | client\_termname | Terminal name of client | | client\_tty | Pseudo terminal of client | | client\_utf8 | 1 if client supports utf8 | | client\_width | Width of client | | cursor\_flag | Pane cursor flag | | cursor\_x | Cursor X position in pane | | cursor\_y | Cursor Y position in pane | | history\_bytes | Number of bytes in window history | | history\_limit | Maximum window history lines | | history\_size | Size of history in bytes | | host | Hostname of local host | | insert\_flag | Pane insert flag | | keypad\_cursor\_flag | Pane keypad cursor flag | | keypad\_flag | Pane keypad flag | | line | Line number in the list | | mouse\_any\_flag | Pane mouse any flag | | mouse\_button\_flag | Pane mouse button flag | | mouse\_standard\_flag | Pane mouse standard flag | | mouse\_utf8\_flag | Pane mouse UTF-8 flag | | pane\_active | 1 if active pane | | pane\_current\_command | Current command if available | | pane\_current\_path | Current path if available | | pane\_dead | 1 if pane is dead | | pane\_height | Height of pane | | pane\_id | Unique pane ID | | pane\_in\_mode | If pane is in a mode | | pane\_index | Index of pane | | pane\_pid | PID of first process in pane | | pane\_start\_command | Command pane started with | | pane\_start\_path | Path pane started with | | pane\_tabs | Pane tab positions | | pane\_title | Title of pane | | pane\_tty | Pseudo terminal of pane | | pane\_width | Width of pane | | saved\_cursor\_x | Saved cursor X in pane | | saved\_cursor\_y | Saved cursor Y in pane | | scroll\_region\_lower | Bottom of scroll region in pane | | scroll\_region\_upper | Top of scroll region in pane | | session\_attached | 1 if session attached | | session\_created | Integer time session created | | session\_created\_string | String time session created | | session\_group | Number of session group | | session\_grouped | 1 if session in a group | | session\_height | Height of session | | session\_id | Unique session ID | | session\_name | Name of session | | session\_width | Width of session | | session\_windows | Number of windows in session | | window\_active | 1 if window active | | window\_find\_matches | Matched data from the find-window command if available | | window\_flags | Window flags | | window\_height | Height of window | | window\_id | Unique window ID | | window\_index | Index of window | | window\_layout | Window layout description | | window\_name | Name of window | | window\_panes | Number of panes in window | | window\_width | Width of window | | wrap\_flag | Pane wrap flag |