You can open the tmux Dashboard by selecting the menu item Shell > tmux > Dashboard. You can also adjust whether to open the tmux Dashboard when connecting to a session with a large number of windows. This is because tmux wants every tmux window to be the same size, but our split pane dividers are not exactly one cell by one cell in size.Ĭheck Preferences > General > tmux for configuration settings.

A tab with split panes may have 'empty' areas.

A tab with a tmux window may not contain non-tmux split panes.

There are a few limitations of tmux integration which are related to the design of tmux. You can get them back with tmux -CC attach.

Detach using Shell->tmux->Detach: Detaches from the tmux session.

Create a window or tab using the Shell->tmux menu: Creates a new tmux window.

One consequence of this rule is that all tmux windows/tabs will contain the same number of rows and columns.

A gray area on the right or bottom of a window indicates that a physical window is larger than the maximum allowed tmux window size. Windows are never larger than the smallest attached client. Resize a window: Tells tmux that the client size has changed, causing all windows to resize.Resize a split pane: Resizes tmux split panes using the resize-pane command.Split a pane: Splits the tmux window using the split-window command.Close a session, tab, or window: Kills the tmux session or window.The following iTerm2 actions affect tmux: In general, you don't need to run commands to perform the most common actions. A dialog box opens and you can enter a command. If you want to run a tmux command that isn't available through the menus, you can press C.The tmux protocol commands will be written to the screen. If you want to report a bug, press L and reproduce the issue.You may need to run 'stty sane' to restore your terminal's state if the tmux client did crash. Press 'X' to force iTerm2 to exit tmux mode. If you press esc and nothing happens, then the tmux client may have crashed or something else has gone wrong.If you press esc, the tmux windows will close and the tmux client will exit.When you run tmux -CC, what you'll see on that terminal is a menu: In practice, this means running one of these commands: Just add the -CC argument to its invocation. You should be able to use tmux as always. Collaborate with another user by having two people attach to the same tmux session.No more anxiety about letting System Update reboot!.Restore the environment you had at work when you get home.A few use cases come to mind:įor users who do most of their work in ssh:

You can return to the host you were ssh'ed into and run 'tmux -CC attach' and the iTerm2 windows will reopen in the same state they were in before. The difference is that when iTerm2 quits or the ssh session is lost, tmux keeps running. An iTerm2 window opens and it acts like a normal iTerm2 window.

When you run 'tmux -CC', a new tmux session is created. ITerm2's tmux integration solves these problems. Also, tmux's find feature isn't as good as iTerm2's.įor many users, a terminal multiplexer would be a great way to work, but they don't want to accept the drawbacks. Some built-in features of your terminal emulator don't work as well as they would if you weren't using tmux: for instance, you can't access tmux's scrollback history as easily or quickly as you can in a normal terminal window.To adjust split panes, you have to enable mouse reporting, even if you don't want it otherwise.You have to ssh to the remote host more than once to get more than one view of your tmux session's window.Some keystroke must be dedicated to tmux to enter its command mode (^B, by default, which means moving the cursor to the left in emacs or an interactive shell becomes more difficult).You can manipulate the environment by issuing commands to tmux. Normally, when you use tmux, multiple virtual windows are displayed in a single 'physical' window. ITerm2 is integrated with tmux, allowing you to enjoy a native user interface with all the benefits of tmux's persistence.

Iterm tmux