Warp URI Scheme

How to use it

There are several ways to use the URI scheme:

• Open new window warp://action/new_window?path=<path_to_folder>
• Open new tab warp://action/new_tab?path=<path_to_folder>
• Open Launch Configuration warp://launch/<launch_configuration_path>
• Open Tab Config warp://tab_config/<name> — opens the saved Tab Config 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.
• Open a Warp Drive object warp://drive/<object_type>?id=<object_id> — opens a notebook, workflow, folder, or environment variables object. See Warp Drive objects.
• Open Settings warp://settings — opens the Settings window. See Settings deep links for search, widget, and sub-page options.

Note

Warp Preview URI scheme begins with warppreview://

Warp Drive objects

Open a saved Drive object by type and ID:

warp://drive/notebook?id=OBJECT_ID
warp://drive/workflow?id=OBJECT_ID
warp://drive/folder?id=OBJECT_ID
warp://drive/env-vars?id=OBJECT_ID

• OBJECT_ID - The object’s ID from a shared Drive link. When you copy a link from Warp Drive, Warp produces a web URL such as https://app.warp.dev/drive/notebook/NAME-OBJECT_ID. The final hyphen-separated segment is the ID to pass as id.
• Optional query params - focused_folder_id focuses a folder in the Drive panel, and invitee_email can prefill an invite when the link is used for sharing flows.

Example:

open "warp://drive/notebook?id=LkDlnAe34vfYD2JXsAkssc"

On Linux, pass the same URI to xdg-open. On Windows, use Start-Process with the URI string.

For creating and sharing notebooks, see Warp Drive Notebooks.

What the URI scheme does not do

The warp:// scheme opens Warp surfaces. It does not:

• Run a shell command, script, or agent prompt in the new tab or window
• Wait for interactive input and return a result to the caller
• Target or control an already-open tab or pane

To open a layout that runs startup commands, save a Tab Config and open it with warp://tab_config/<name>. For a longer-running agent session you can monitor later, use Remote Control after the agent is already running.

Settings deep links

Open the Settings window directly, optionally jumping to a specific page, widget, or search:

• warp://settings — open Settings on the default page.
• warp://settings?q=<query> — open Settings with the search bar pre-filled.
• warp://settings?widget=<widget_id> — open Settings scrolled to a specific setting.
• warp://settings/appearance — open the Appearance page (themes, fonts, and more).
• warp://settings/mcp — open the MCP servers page. Append ?autoinstall=<name> to install a gallery MCP server by name.
• warp://settings/warp_agent — open the Warp Agent page (inference and API keys).
• warp://settings/environments — open the Cloud environments page.
• warp://settings/platform — open the Platform page.
• warp://settings/billing_and_usage — open the Billing & usage page.
• warp://settings/teams — open Team settings. Append ?invite=<email> to open the invite dialog with the email pre-filled.

How it works

Example of Warp URIs in use in Warp + Raycast Extension.

Warp + Raycast Extension Demo made using URIs