Warp: Vertical Tabs Sidebar and Tab Configs for Workspace Organization

Warp

Warp introduced a Vertical Tabs Sidebar and Tab Configs, two closely related workspace-organization features. The vertical tabs panel replaces the traditional horizontal tab bar with a resizable sidebar showing rich per-pane metadata — including git branch, working directory, agent status, diff stats, and pull request info. Tab Configs are .toml files that define reusable workspace layouts with pane splits, startup commands, directory context, and parameterized inputs, replacing the older Legacy Launch Configurations system.


Vertical Tabs Sidebar

Warp's April 8 release introduces a new Vertical Tabs Sidebar that replaces the horizontal tab bar with a resizable panel on the left side of the window. Rather than showing bare tab labels, the sidebar surfaces rich, contextual metadata for every open pane at a glance.

What the Sidebar Shows

Each pane row in the sidebar displays:

  • The currently checked-out git branch and active worktree path
  • A colored badge indicating agent activity status (running, completed, errored, cancelled, or blocked)
  • The current working directory
  • Diff statistics — lines added and removed
  • Pull request links and status (requires the GitHub CLI)
  • Notification indicators — accent-colored dots that highlight panes with unread agent activity

Two display density modes are available: Compact and Expanded. To enable the sidebar, navigate to Settings > Appearance > Tabs and toggle “Use vertical tab layout” on.

Management Capabilities

The panel supports drag-and-drop reordering, moving panes between tabs, integrated search, inline renaming, and a unified + menu for creating new agent, terminal, or Oz cloud agent tabs.

Tab Configs

Alongside the vertical tabs sidebar, Warp introduced Tab Configs — .toml files stored in ~/.warp/tab_configs/ that define reusable terminal workspace layouts, replacing the older Legacy Launch Configurations system. Tab Configs support pane layout definitions, directory context, startup commands, tab color, and parameterized inputs with template syntax. Agent skills can create or update Tab Configs through natural language.