Skip to content

Commit e2e3917

Browse files
authored
Document warp://tab_config/<name> deeplink (#123)
1 parent 6df4f82 commit e2e3917

2 files changed

Lines changed: 26 additions & 2 deletions

File tree

src/content/docs/terminal/more-features/uri-scheme.mdx

Lines changed: 3 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -1,8 +1,8 @@
11
---
22
title: Warp URI Scheme
33
description: >-
4-
Warps URI scheme enables you to programmatically open new windows, tabs, or
5-
launch configurations with ease.
4+
Warp's URI scheme enables you to programmatically open new windows, tabs,
5+
launch configurations, or tab configs with ease.
66
sidebar:
77
label: "Warp URI scheme"
88
---
@@ -15,6 +15,7 @@ There are several ways to use the URI scheme:
1515
* Open new window `warp://action/new_window?path=<path_to_folder>`
1616
* Open new tab `warp://action/new_tab?path=<path_to_folder>`
1717
* Open Launch Configuration `warp://launch/<launch_configuration_path>`
18+
* Open Tab Config `warp://tab_config/<name>` — opens the saved [Tab Config](/terminal/windows/tab-configs/) as a new tab in the active window. Append `?new_window=true` to open it in a new window instead. `<name>` is matched case-insensitively against the file stem of the `.toml`, so both `warp://tab_config/my_tab` and `warp://tab_config/my_tab.toml` resolve to `my_tab.toml`.
1819

1920
:::note
2021
[Warp Preview](/support-and-community/community/warp-preview-and-alpha-program/) URI scheme begins with `warppreview://`

src/content/docs/terminal/windows/tab-configs.mdx

Lines changed: 23 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -65,6 +65,28 @@ Saved Tab Configs appear in the `+` menu for quick access. When you hover a Tab
6565
<figcaption>Tab config menu with sidecar options.</figcaption>
6666
</figure>
6767

68+
## Open a Tab Config from a URL
69+
70+
You can open a saved Tab Config directly via Warp's [URI scheme](/terminal/more-features/uri-scheme/). This is useful for browser bookmarks, scripts, and launchers like Raycast or Alfred that need to jump straight into a configured pane layout without going through the `+` menu.
71+
72+
By default, the Tab Config opens as a new tab in the active window. Pass `?new_window=true` (or invoke when no Warp window is open) to open it in a new window instead.
73+
74+
```bash
75+
# Open my_tab.toml as a new tab in the focused window
76+
open "warp://tab_config/my_tab"
77+
78+
# Open it in a brand-new window
79+
open "warp://tab_config/my_tab?new_window=true"
80+
```
81+
82+
`<name>` is matched case-insensitively against the file stem of the `.toml`, so `warp://tab_config/my_tab` and `warp://tab_config/my_tab.toml` both resolve to `my_tab.toml`. Matching uses the filename rather than the `name` field inside the file, because multiple Tab Configs can share the same display name.
83+
84+
If the Tab Config declares `[params.*]` entries, the params modal opens just like launching from the `+` menu. Worktree-style configs that reference `{{autogenerated_branch_name}}` still get a freshly generated branch name on each open.
85+
86+
:::note
87+
On Warp Preview, use `warppreview://tab_config/<name>` instead.
88+
:::
89+
6890
## Using skills to manage Tab Configs
6991

7092
Warp includes built-in skills for creating and modifying Tab Configs through natural language:
@@ -229,3 +251,4 @@ You can also create a worktree-based Tab Config directly from the `+` menu by cl
229251
* [Themes](/terminal/appearance/themes/) — customize the colors used by tab color settings
230252
* [Working Directory](/terminal/more-features/working-directory/) — how Warp resolves working directories
231253
* [Third-Party CLI Agents](/agent-platform/cli-agents/overview/) — use the `"agent"` pane type to open tabs in Agent Mode
254+
* [Warp URI Scheme](/terminal/more-features/uri-scheme/) — open Tab Configs via `warp://tab_config/<name>` deeplinks

0 commit comments

Comments
 (0)