Launch Configurations

What is it
Launch Configurations enables you to save your configuration of windows, tab, and panes, so that you can reopen the same set of windows, tab, and panes per project quickly. You can save this via 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 CMD-P, enter Save New Launch Configuration.
3.Name the configuration file. Note: The name field cannot be empty.
4.Click the save configuration button.
How to access it
From the Command Palette CMD-P, enter Launch Configuration to open and select Launch Configuration.
With the keyboard shortcut CTRL-CMD-L, 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 ~/.warp/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 [email protected]
        color: green
Last modified 2mo ago