Tabs

Note

New Tabs will default to the active Tabs’ current Working Directory and the actual color values will be automatically derived from your Warp Theme.

How to use Tabs

macOS

• Right-click on the new Tab button + to make a new tab, restore closed tab, or run a saved Launch Configuration.
• Open a new Tab with ⌘+T or by clicking on the + in the top bar.
• Close the current Tab with ⌘+W or by clicking on the X on hover over a Tab.
• Reopen closed tabs with ⌘+Shift+T.
• Move a Tab to the Left / Right with Ctrl+Shift+← / Ctrl+Shift+→ or by clicking and dragging a Tab.
• Activate the Previous / Next Tab with ⌘+Shift+{ / ⌘+Shift+} or by clicking a Tab.
• Activate the first through eighth Tabs with ⌘+1 thru ⌘+8.
• Switch to the last Tab with ⌘+9.
• Double-click a Tab to rename it.
• Right-clicking on a Tab reveals more options you can explore within the Command Palette or Keyboard Shortcuts.

Windows

• Right-click on the new Tab button + to make a new tab, restore closed tab, or run a saved Launch Configuration.
• Open a new Tab with Ctrl+Shift+T or by clicking on the + in the top bar.
• Close the current Tab with Ctrl+Shift+W or by clicking on the x on hover over a Tab.
• Reopen closed tabs with Ctrl+Alt+T.
• Move a Tab to the Left / Right with Ctrl+Shift+← / Ctrl+Shift+→ or by clicking and dragging a Tab.
• Activate the Previous / Next Tab with Ctrl+Page Up / Ctrl+Page Down or by clicking a Tab.
• Activate the first through eighth Tabs with Ctrl+1 thru Ctrl+8.
• Switch to the last Tab with Ctrl+9.
• Double-click a Tab to rename it.
• Right-clicking on a Tab reveals more options you can explore within the Command Palette or Keyboard Shortcuts.

Linux

• Right-click on the new Tab button + to make a new tab, restore closed tab, or run a saved Launch Configuration.
• Open a new Tab with Ctrl+Shift+T or by clicking on the + in the top bar.
• Close the current Tab with Ctrl+Shift+W or by clicking on the x on hover over a Tab.
• Reopen closed tabs with Ctrl+Alt+T.
• Move a Tab to the Left / Right with Ctrl+Shift+← / Ctrl+Shift+→ or by clicking and dragging a Tab.
• Activate the Previous / Next Tab with Ctrl+Page Up / Ctrl+Page Down or by clicking a Tab.
• Activate the first through eighth Tabs with Ctrl+1 thru Ctrl+8.
• Switch to the last Tab with Ctrl+9.
• Double-click a Tab to rename it.
• Right-clicking on a Tab reveals more options you can explore within the Command Palette or Keyboard Shortcuts.

Tip

Terminal Tip
Using your .zshrc or .bashrc files on macOS or Linux, you can set a new Tab name:

# Set name, where MyTabName would be whatever you want to see in the Tab ( either a fixed string, $PWD, or something else )
function set_name () {
  export WARP_DISABLE_AUTO_TITLE=true
  echo -ne "\033]0;MyTabName\007"
}
# Add the function to the environment variable in either Zsh or Bash
if [ -n "$ZSH_VERSION" ]; then
  preexec_functions+=(set_name)
elif [ -n "$BASH_VERSION" ]; then
  PROMPT_COMMAND='set_name'
fi

Learn more about setting shell tab titles in Windows Terminal.

Tab Restoration

Tab Restoration enables you to reopen recently closed tabs for up to 60 seconds. Configure this feature in Settings > Features > Session > Enable reopening of closed sessions.

Ctrl+Tab behavior

Ctrl+Tab shortcut defaults to activate the previous / next Tab. You can configure the shortcut to cycle the most recent session, including any Split Panes, in Settings > Features > Keys > Ctrl+Tab behavior.

Tabs behavior

See our Appearance > Tabs Behavior docs for more tab-related settings.

How Tabs work

Tab colors

Color-code tabs to tell projects, environments, or long-running sessions apart at a glance. Colors come from your active theme, so they stay readable whichever theme you use.

Set a tab’s color

1. Right-click the tab you want to color.
2. Click a color in the color row.

To remove a color, right-click the tab and click the same color again, or pick the default (no color) option.

You can also set the color without leaving the input. Run the /set-tab-color Slash Command with the color you want — red, green, yellow, blue, magenta, cyan, or none to clear it. For example, /set-tab-color blue.

Note

Coloring a tab that belongs to a group sets the group’s color, so every tab in the group changes together.

Cycle the active tab’s color

The Cycle current tab color action (workspace:cycle_active_tab_color) steps the active tab through the available colors, then back to no color. It has no default shortcut, so reach it from the Command Palette or bind a key to it in Settings > Keyboard shortcuts.

Tip

Warp can also color tabs automatically based on their working directory. See directory_tab_colors in the all settings reference.

Tab groups

Organize related tabs into named, collapsible groups. A tab group keeps its member tabs together in the tab bar, can be given a name and a color, and can be collapsed to hide its members until you need them. Tab groups work in both the horizontal tab bar and the vertical tabs panel.

Create a group

• Right-click a tab and choose New group with tab to start a group from that tab.
• Select multiple tabs first (see Select multiple tabs), then right-click the selection to group them together.
• Click the + new-tab button and choose New tab group to create a new group with a new tab.

Select multiple tabs

• Cmd-click (macOS) or Ctrl-click (Windows/Linux) a tab to add it to or remove it from the selection.
• Shift-click a tab to select every tab between it and the active tab.

With multiple tabs selected, right-click to group them, move them into an existing group, or remove them from their group in one step.

Note

The active tab is always included in a selection.

Manage a group

Right-click a group’s header to:

• Rename the group.
• Set a color for the group.
• Add a New tab in group.
• Ungroup tabs to dissolve the group while keeping its tabs.
• Close the tabs in the group.

Right-click an individual tab for New group with tab, Move to group (to move it into another group), and Remove from group.

Collapse a group

Click a group’s header to collapse or expand it. Collapsed groups hide their member tabs to save space in the tab bar; click the header again to expand.

Note

You can assign keyboard shortcuts for creating a group from the active or selected tabs and for removing tabs from a group in Settings > Keyboard shortcuts.

Pin tabs and groups

Pin frequently used tabs or tab groups to keep them at the front of the tab list. Pinned items form a leading section before unpinned tabs and groups, and you can reorder items within the pinned section. Pinning works in both the horizontal tab bar and the vertical tabs panel. Warp restores the pinned state when you reopen the window.

Pin a tab

1. Right-click the tab you want to keep at the front.
2. Click Pin tab.

Warp moves the tab to the end of the pinned section.

Note

If the tab belongs to a group, Pin tab removes the tab from its group and pins it independently. To keep the group together, pin the group instead.

Pin a group

1. Right-click the group’s header.
2. Click Pin group.

Warp moves the entire group to the end of the pinned section as one block.

Unpin a tab or group

To return an item to the unpinned section:

• Tab - Right-click the pinned tab, then click Unpin tab.
• Group - Right-click the pinned group’s header, then click Unpin group.

Warp moves the item to the beginning of the unpinned section.

Note

You can assign keyboard shortcuts for pinning or unpinning the active tab or group in Settings > Keyboard shortcuts.

Move a tab to another window

You can pull a tab out of the tab bar to reorganize your windows, similar to a web browser:

• Detach a tab into its own window — drag a tab out of the tab bar and drop it in empty space to open it in a new window.
• Move a tab between windows — drag a tab onto another window’s tab bar to move it there.

The tab keeps its running session, panes, and state as it moves. This works from both the horizontal tab bar and the vertical tabs panel.

Note

Dragging tabs between windows is available on macOS and Windows.