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. 1.
    Set up the configuration of windows, tabs, and panes you would like to save.
  2. 2.
    From the Command Palette CMD-P, enter Save New Launch Configuration.
  3. 3.
    Name the configuration file. Note: The name field cannot be empty.
  4. 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