diff --git a/src/content/docs/terminal/more-features/uri-scheme.mdx b/src/content/docs/terminal/more-features/uri-scheme.mdx index 3c1c4e75..07dd2d0b 100644 --- a/src/content/docs/terminal/more-features/uri-scheme.mdx +++ b/src/content/docs/terminal/more-features/uri-scheme.mdx @@ -1,8 +1,8 @@ --- title: Warp URI Scheme description: >- - Warps URI scheme enables you to programmatically open new windows, tabs, or - launch configurations with ease. + Warp's URI scheme enables you to programmatically open new windows, tabs, + launch configurations, or tab configs with ease. sidebar: label: "Warp URI scheme" --- @@ -15,6 +15,7 @@ There are several ways to use the URI scheme: * Open new window `warp://action/new_window?path=` * Open new tab `warp://action/new_tab?path=` * Open Launch Configuration `warp://launch/` +* Open Tab Config `warp://tab_config/` — 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. `` 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`. :::note [Warp Preview](/support-and-community/community/warp-preview-and-alpha-program/) URI scheme begins with `warppreview://` diff --git a/src/content/docs/terminal/windows/tab-configs.mdx b/src/content/docs/terminal/windows/tab-configs.mdx index 9fa8a34c..51e7d927 100644 --- a/src/content/docs/terminal/windows/tab-configs.mdx +++ b/src/content/docs/terminal/windows/tab-configs.mdx @@ -65,6 +65,28 @@ Saved Tab Configs appear in the `+` menu for quick access. When you hover a Tab
Tab config menu with sidecar options.
+## Open a Tab Config from a URL + +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. + +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. + +```bash +# Open my_tab.toml as a new tab in the focused window +open "warp://tab_config/my_tab" + +# Open it in a brand-new window +open "warp://tab_config/my_tab?new_window=true" +``` + +`` 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. + +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. + +:::note +On Warp Preview, use `warppreview://tab_config/` instead. +::: + ## Using skills to manage Tab Configs 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 * [Themes](/terminal/appearance/themes/) — customize the colors used by tab color settings * [Working Directory](/terminal/more-features/working-directory/) — how Warp resolves working directories * [Third-Party CLI Agents](/agent-platform/cli-agents/overview/) — use the `"agent"` pane type to open tabs in Agent Mode +* [Warp URI Scheme](/terminal/more-features/uri-scheme/) — open Tab Configs via `warp://tab_config/` deeplinks