Menu Items

Shell > New Window/Tab

This creates a new window or tab with the default profile. If the current session is a tmux integration session, then you will be prompted for whether to create a local or tmux session.

Shell > New Tab with Current Profile

This creates a new tab using the same profile as the current session rather than the default profile.

Shell > Duplicate Tab

Creates another tab with the same arrangement of split panes, profile, etc.

Shell > Split Vertically/Horizontally

These menu items allow you to divide a tab into two or more split panes. The panes can be adjusted by dragging the line that divides them. They will use the default profile.

Shell > Split Vertically/Horizontally with Current Profile

These menu items allow you to divide a tab into two or more split panes. The panes can be adjusted by dragging the line that divides them. They will use the profile of the current session.

Shell > Save Selected Text

Saves the selected text to a file.

Shell > Close

Terminates the current session.

Shell > Close Terminal Window

Terminates all sessions in the current window.

Shell > Close All Panes in Tab

Terminates all sessions in the current tab.

Shell > Broadcast Input > ...

These options allow you to send keyboard input to more than one session. Be careful.

Send input to current session only: The default setting.
Broadcast to all panes in all tabs: Anything you type on the keyboard goes to all sessions in this window.
Broadcast to all panes in current tab: Anything you type on the keyboard goes to all sessions in this tab.
Toggle broadcast input to current session: Toggles whether this session receives broadcasted keystrokes within this window.
Show Background Pattern Indicator: If selected, sessions receiving broadcast input get an obnoxious red-stripe background.

Shell > tmux > ...

These commands let you interact with the tmux integration

Detach: Detaches from the tmux session associated with the current pane. It remains running in the tmux server.
New tmux Window/Tab: Creates a new tmux window, which appears in either a native window or tab, as requested. 8 Dashboard: The tmux dashboard is a view that lets you see all your tmux sessions and windows at a glance, adjust which are visible, rename them, and change the current tmux session.

▸ Edit Menu ▾ Edit Menu

Edit > Undo Close Session/Tab/Window

After you close a session, tab, or window then you have five seconds to undo it. The amount of time is configurable in PReferences > Profiles > Session.

Edit > Copy (With Styles)

Hold down Option to turn Copy into Copy With Styles, which includes fonts and color information in the copied text.

Edit > Copy Mode

Enters Copy Mode which lets you make selections using the keyboard. See Copy Mode for details.

Edit > Paste Special > Advanced Paste

This opens the Advanced Paste window which lets you select a string from the pasteboard in recent history, select different representations of the current pasteboard, and modify the string before pasting it. You can modify it by appling a regex substitution, using various built-in modifiers (such as base-64 encoding), or edit it by hand.

Edit > Paste Special > Paste Selection

Pastes the currently selected text (which may differ from the text in the pasteboard).

Edit > Paste Special > Paste File Base64-Encoded

If there is a file on the pasteboard then this is enabled. When invoked, it base64-encodes the file and pastes the encoded value.

Edit > Paste Special > Paste Slowly

"Paste Slowly" pastes the current string in the clipboard, but it doesn't send the whole string at once. It is sent in batches of 16 bytes with a 125ms delay between batches.

Edit > Paste Special > Paste Faster/Slower

Adjusts the speed of pasting to be faster or slower.

Edit > Paste Special > Paste Slowly Faster/Slower

Adjusts the speed of slow pasting to be faster or slower. You must hold down option for this menu item to be visible.

Edit > Paste Special > Warn Before Multi-Line Paste

When enabled, you'll be warned before pasting more than one line.

Edit > Paste Special > Limit Multi-Line Paste To Shell Prompt

If Warn Before Multi-Line Paste is on, then this restricts it to warn only when you're at the shell prompt. It only works if shell integration is installed, since otherwise iTerm2 cannot tell when you're at the shell prompt.

Edit > Paste Special > Warn Before Pasting One Line Ending in a Newline at Shell Prompt

This requires shell integration to be installed to work. If you try to paste one line that ends in a newline while at the shell prompt and this is enabled, you'll get a confirmation dialog before the text is pasted.

Edit > Selection Respects Soft Boundaries

When enabled, vertical lines of pipe characters | will be interpreted as pane dividers (as in vim or emacs) and selection will wrap at them.

Edit > Select Output of Last Command

Requires shell integration to be installed. Selects the output of the last command.

Edit > Select Current Command

Requires shell integration to be installed. Selects the text of the current command entered at the command prompt.

Edit > Find > Find

Opens or focuses the find panel. Select the down arrow to the left of the search field to open the options menu, which lets you select case insensitivity and regular expression options. The default case sensitivity option of "Smart Case Sensitivity" performs a case-sensitive search if the search query contains any upper case letters. Otherwise, a case-insensitive search is performed.

Edit > Find > Find Next/Previous

Note that the direction of next and previous is reversed relative to the standard macOS search direction. If you prefer for Next to mean down and Previous to mean up, set Preferences>Advanced>Swap Find Next and Find Previous to No.

Edit > Find > Find URLs

Searches the current session for URLish looking strings.

Edit > Marks and Annotations > Set Mark

Records the current scroll position. Use Edit > Jump to Mark to restore the scroll position.

Edit > Marks and Annotations > Add Annotation at Cursor

Adds an annotation to the word beginning at the cursor. An annotation is a scratchpad for you to write notes about a chunk of text in your history.

Edit > Marks and Annotations > Jump to Mark

Scrolls to the location of the last mark.

Edit > Marks and Annotations > Alerts > Alert on Next Mark

When a mark is set (typically by Shell Integration when the currently running shell command terminates) then show an alert.

Edit > Clear Buffer

Clears the entire terminal history and the mutable area.

Edit > Clear Scrollback Buffer

Clears scrollback history, preserving the mutable area.

▸ View Menu ▾ View Menu

View > Show Tabs in Fullscreen

If enabled, tabs are shown in fullscreen windows.

View > Toggle Full Screen

Enters or exists full screen mode. iTerm2 supports both the standard macoS full screen mode, where the window occupies its own Space, and its traditional full screen mode that shares a Space with other windows. You can control which is used in Preferences > General > Native full screen windows.

View > Use Transparency

This toggles transparency. It only has an effect if you have configured your session to be transparent under Preferences > Profiles > Window > Transparency. When Full Screen mode is entered, transparency is turned off by default, but you can select this menu item to re-enable it.

View > Zoom In on Selection

When a selection is present this is enabled. Zooming on a selection removes all other text from the session and lets you focus on just the zoomed-in-on text. Pressing escape will invoke Zoom Out when you are in the Zoom In state.

View > Zoom Out

Exits the Zoom In on Selection mode.

View > Find Cursor

Reveals the current cursor position.

View > Show Cursor Guide

Toggles the visiblity of the cursor guide which is a horizontal rule showing the location of the cursor.

View > Show Timestamps

Indicate the time of last modification of each line on the screen.

View > Show Annotations

Toggles the visibility of annotations.

View > Auto Command Completion

Automatically shows a window with command completion suggestions as you type. Only usable when you have command history built up with Shell Integration.

View > Open Quickly

If you have lots of sessions you can quickly find the one you're looking for with Open Quickly. Select the View > Open Quickly menu item (cmd-shift-O) and then enter a search query. You can search by tab title, command name, host name, user name, profile name, directory name, badge label, and more. Queries are scored according to relevance and sorted by score. Open Quickly also lets you create new tabs, change the current session's profile, open arrangements, and change the color preset. If you start your query with a / then that gives you a shortcut to various commands. /a followed by an arrangement name restores the arrangement. /f restricts the query to existing sessions, excluding options to open new tabs, etc. /p restrics the query to profile names to switch the current session to. /t restricts the results to "open new tab" for matching profile names. /c restricts the results to color presets.

View > Maximize Active Pane

When there are split panes present, this toggles whether a given pane expands to fill the tab. When a maximized pane is present, the tab will be inscribed with a dotted outline.

View > Start Instant Replay

Stepping through time allows you to see what was on the screen at a previous time. This is different than going back through the scrollback buffer, as interactive programs sometimes overwrite the screen contents without having them scroll back. Once in this mode, you can use the left and right arrow keys to step back and forward, respectively. The "esc" key exits this mode, as does clicking the close button in the bar that appears on the bottom. You can adjust the amount of memory dedicated to this feature in Preferences > Instant Replay uses xx MB per session. The more memory you assign, the further back in time you can step. The instant replay UI also lets you choose to export a section of your terminal history to share with other iTerm2 users.

View > Size Changes Update Profile

When enabled, changes made to the text size in this session (by selecting Make Text Bigger/Smaller) will be reflected in its profile.

View > Tab Color

Allows you to select a tint color for the tab, to make it easier to distinguish. You can also change the tab color in Profiles > Preferences > Colors.

▸ Session Menu ▾ Session Menu

Session > Edit Session

This opens a window that lets you change the settings of the current session without affecting any other sessions. Changes made in this panel will not be overridden by subsequent changes to the profile. Settings not cahnged in this panel will be affected by changes to the profile.

Session > Run/Stop Coprocess

Allows you to start and stop a coprocess linked to the current session. Learn more about coprocesses.

Session > Restart Session

After a session ends (e.g., because the shell exits) this menu item becomes enabled. It will re-run your profile's command in the same viewport as the terminated session.

Session > Open Autocomplete...

Shows the autocomplete window, which offers to finish typing a word that you've begun. Learn more about autocomplete on highlights page.

Session > Open Command History...

If you use Shell Integration then Open Command History presents a list of recently used commands to select from.

Session > Open Recent Directories...

If you use Shell Integration then Open Recent Directories presents a list of recently used directories to select from.

Session > Open Paste History...

"Open Paste History" opens a window showing up to the last 20 values that were copied or pasted in iTerm2. You can search its contents by typing a (non-necessarily-consecutive) subsequence of characters that appear in the value. You can use arrow keys and enter to make a selection, or you can click on an item to choose it, and it will be pasted. If you enable the Save copy/pate history to disk preference then these values will persist across sessions of iTerm2.

Session > Reset

Resets the internal state of the emulator and clears the screen. Use this if you get wedged in a bad state, like the wrong character set or mouse reporting mode is stuck.

Session > Log > Start/Stop

Logging saves all input received in a session to a file on disk.

Session > Log > Import/Export Recording...

The Instant Replay feature allows you to view the past window state. The import/export feature allows you to save that state to an itr file and share it with others. For more control, enter instant replay by selecting View > Start Instant Replay and click the Export button there; it will allow you to clip the recording by selecting its start and end points separately.

Session > Bury Session/Buried Sessions

Buries or unburies a session. See Buried Sessions for details.

▸ Scripts Menu ▾ Scripts Menu

▸ Profiles Menu ▾ Profiles Menu

▸ Toolbelt Menu ▾ Toolbelt Menu

Toolbelt > Set Default Width

Saves the current window's toolbelt width as the default width for new windows' toolbelts.

Toolbelt > Actions

This toggles the visibility of the Actions tools. It has a list of user-defined actions (for example, send a canned string of text). The tool provides an interface for editing the actions as well as invoking them.

Toolbelt > Captured Output

This toggles the visibilty of the Captured Output tool. It shows captured output located with the Capture Output trigger. See Captured Output for more information.

Toolbelt > Command History

This toggles the visibility of the Command History tool. It shows recently used commands. You must install Shell Integration for this to know your command history.

Toolbelt > Show Toolbelt

This toggles the visibility of the Toolbelt on the right side of all windows.

Toolbelt > Jobs

This toggles the visibility of the Jobs tool, which shows the running jobs in the current session, and allows you to send them signals.

Toolbelt > Notes

This toggles the visibility of the Notes tool, which provides a freeform scratchpad in the toolbelt.

Toolbelt > Paste History

This toggles the visibility of the Paste History tool, which shows recently pasted strings in the toolbelt.

Toolbelt > Profiles

This toggles the visibility of the Profiles tool, which lets you select profiles to open new windows, tabs, and split panes.

Toolbelt > Recent Directories

This toggles the visibility of the Recent Directories tool. It shows recently used directories sorted by a combination of recency and frequency of use. You must install Shell Integration for this to know your directory history. You can right click a directory to open a context menu that allows you to "start" a directory. This keeps it pinned at the bottom of the list so it's easy to find.

Custom Tools

Scripts using the Python API may register custom tools. Those will also appear in this menu. See the Asymmetric Broadcast Input script for a working example.

▸ Window Menu ▾ Window Menu