Launch Configurations

Launch Configurations enables you to save your configuration of windows, tab, and panes, so that you can reopen the same set of sessions per project quickly.

What is it

With Launch configurations you can save in the app or by adding a yaml file.

How to use it

1. Set up the configuration of windows, tabs, and panes you would like to save.

2. From the Command Palette, enter Save New Launch Configuration.

3. Name the configuration file, the name field cannot be empty.

4. Click the save configuration button.

How to access it

• From the Command Palette, enter Launch Configuration to open and select Launch Configuration.

• Right-clicking the new Tab + button to open a menu and select saved Launch Configuration.

• From the Mac Menu, File > Launch Configurations, where you can search through and open your saved Launch Configuration.

Terminal Tip You can open saved Launch Configurations via Alfred Workflow or Raycast Extension. Learn more here. Credit to @joetannenbaum

How it works

Launch Configuration Demo

YAML Format

All yaml files are stored in the following location:

macOS

~/.warp/launch_configurations/

Linux

${XDG_DATA_HOME:-$HOME/.local/share}/warp-terminal/launch_configurations/

The cwd: value in the yaml code must contain an absolute path or "". Note that ~ or empty paths will result in the file not being visible on the list of options for Launch Configurations.

Windows

Here's a sample configuration that shows how windows are structured.

# Warp Launch Configuration
#
#
# Use this to start a certain configuration of windows, tabs, and panes.
# Open the launch configuration palette with ctrl-cmd-L to access 
# and open any launch configuration.
#
# This configuration has two windows, each with one tab in different starting directories.

---
name: Example Configuration With Two Windows
windows:
  - tabs:
      - title: documents
        layout:
          cwd: /Users/warp-user/Documents
        color: blue
  - tabs:
      - title: warp user
        layout:
          cwd: /Users/warp-user
        color: green

Tabs

Here's a sample configuration that shows how tabs are structured.

• Use the title field to set a custom tab name

• Use the color field to set the tab color

  • We currently support using the terminal colors (ANSI colors):

    Red | Green | Yellow | Blue | Magenta | Cyan

    The actual color values will be automatically derived from your Warp theme

# Warp Launch Configuration
#
# This configuration has two tabs in the same window.

---
name: Example Configuration With Two Tabs
windows:
  - tabs:
      - title: documents 
        layout:
          cwd: /Users/warp-user/Documents
        color: blue
      - title: warp user
        layout:
          cwd: /Users/warp-user
        color: green

Panes

Launch Configurations support setting split panes in each tab. Note that Warp also supports nesting split panes.

# Warp Launch Configuration
#
# This configuration is two windows, each with split panes.
# The first window contains a vertically split tab with two panes.
# The second window contains a horizontally split tab, 
# with a vertically split tab on the right.

---
name: Example Configuration With Split Panes
windows:
  - tabs:
      - title: downloads and warp user
        layout:
          split_direction: vertical
          panes:
            - cwd: /Users/warp-user/Downloads
            - cwd: /Users/warp-user
        color: blue
  - tabs:
      - title: desktop, documents, and warp user
        layout:
          split_direction: horizontal
          panes:
            - cwd: /Users/warp-user/Desktop
            - split_direction: vertical
              panes:
                - cwd: /Users/warp-user/Documents
                - cwd: /Users/warp-user
        color: green

Commands

Use the commands field to define a set of commands to run when a configuration is launched.

# Warp Launch Configuration
#
# This configuration has two windows.
# The first window executes two commands on start.
# The second window has a split pane that executes a command on start.

---
name: Example Configuration With Starting Commands
windows:
  - tabs:
      - title: documents
        layout:
          cwd: /Users/warp-user/Documents
          commands:
            - exec: ls
            - exec: code .
        color: blue
  - tabs:
      - title: downloads
        layout:
          split_direction: vertical
          panes:
            - cwd: /Users/warp-user/Downloads
              commands:
                - exec: curl http://example.com -o my.file
            - cwd: /Users/warp-user
              commands:
                - exec: ssh [e-mail]
        color: green