Skip to content
Draft
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
40 changes: 40 additions & 0 deletions src/content/docs/terminal/sessions/launch-configurations.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -24,6 +24,8 @@ You can create Launch Configurations in the app or by adding a YAML file.
3. Name the configuration file. The name field cannot be empty.
4. Click the Save configuration button.

Warp saves each tab group's name, color, collapsed and pinned states, and tab membership.

### With a YAML File

* Launch Configurations files are generated when you create them with the UI and can also be created or modified manually.
Expand Down Expand Up @@ -148,6 +150,44 @@ windows:
color: green
```

### Tab groups

Use `tab_groups` on a window to define groups. Set `group` on each tab to the zero-based position of its group in the `tab_groups` list. Tabs without `group` open outside a group.

Each tab group supports:

* **`name`** - The group name.
* **`color`** - One of `black`, `red`, `green`, `yellow`, `blue`, `magenta`, `cyan`, or `white`.
* **`collapsed`** - Whether the group opens collapsed. Defaults to `false`.
* **`pinned`** - Whether the group opens pinned. Defaults to `false`.

```yaml title="grouped-development.yaml"
---
name: Grouped development
windows:
- tabs:
- title: API
layout:
cwd: /Users/warp-user/Projects/api
group: 0
- title: Tests
layout:
cwd: /Users/warp-user/Projects/api
commands:
- exec: npm test
group: 0
- title: Notes
layout:
cwd: /Users/warp-user/Documents
tab_groups:
- name: Backend
color: blue
collapsed: false
pinned: false
```

Tabs in the same group must be adjacent in the `tabs` list. Warp opens a tab outside a group when its `group` index does not exist or when the same group appears again after a different group or ungrouped tab. Warp does not create groups without member tabs.

### Panes

Launch Configurations support setting split panes in each tab. Note that Warp also supports nesting split panes in launch configuration files.
Expand Down
Loading