You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: src/content/docs/terminal/more-features/uri-scheme.mdx
+3-2Lines changed: 3 additions & 2 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -1,8 +1,8 @@
1
1
---
2
2
title: Warp URI Scheme
3
3
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.
6
6
sidebar:
7
7
label: "Warp URI scheme"
8
8
---
@@ -15,6 +15,7 @@ There are several ways to use the URI scheme:
15
15
* Open new window `warp://action/new_window?path=<path_to_folder>`
16
16
* Open new tab `warp://action/new_tab?path=<path_to_folder>`
17
17
* 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`.
18
19
19
20
:::note
20
21
[Warp Preview](/support-and-community/community/warp-preview-and-alpha-program/) URI scheme begins with `warppreview://`
Copy file name to clipboardExpand all lines: src/content/docs/terminal/windows/tab-configs.mdx
+23Lines changed: 23 additions & 0 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -65,6 +65,28 @@ Saved Tab Configs appear in the `+` menu for quick access. When you hover a Tab
65
65
<figcaption>Tab config menu with sidecar options.</figcaption>
66
66
</figure>
67
67
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
+
68
90
## Using skills to manage Tab Configs
69
91
70
92
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
229
251
*[Themes](/terminal/appearance/themes/) — customize the colors used by tab color settings
230
252
*[Working Directory](/terminal/more-features/working-directory/) — how Warp resolves working directories
231
253
*[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