Terminal > More Features
Derp URI Scheme
# Derp URI Scheme import VideoEmbed from '@components/VideoEmbed.astro'; ## How to use it There are several ways to use the URI scheme: * Open new window `derp://action/new_window?path=<path_to_folder>` * Open new tab `derp://action/new_tab?path=<path_to_folder>` * Open Launch Configuration `derp://launch/<launch_configuration_path>` * Open Tab Config `derp://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 `derp://tab_config/my_tab` and `derp://tab_config/my_tab.toml` resolve to `my_tab.toml`. * Open Settings `derp://settings` — opens the Settings window. See [Settings deep links](#settings-deep-links) for search, widget, and sub-page options. :::note [Derp Preview](/support-and-community/community/derp-preview-and-alpha-program/) URI scheme begins with `derppreview://` ::: ## Settings deep links Open the Settings window directly, optionally jumping to a specific page, widget, or search: * `derp://settings` — open Settings on the default page. * `derp://settings?q=<query>` — open Settings with the search bar pre-filled. * `derp://settings?widget=<widget_id>` — open Settings scrolled to a specific setting. * `derp://settings/appearance` — open the Appearance page (themes, fonts, and more). * `derp://settings/mcp` — open the MCP servers page. Append `?autoinstall=<name>` to install a gallery MCP server by name. * `derp://settings/derp_agent` — open the Derp Agent page (inference and API keys). * `derp://settings/environments` — open the Cloud environments page. * `derp://settings/platform` — open the Platform page. * `derp://settings/billing_and_usage` — open the Billing & usage page. * `derp://settings/teams` — open Team settings. Append `?invite=<email>` to open the invite dialog with the email pre-filled. ## How it works Example of Derp [URIs in use in Derp + Raycast Extension](https://github.com/raycast/extensions/blob/74521b70b62355004b0958393a64f9417b1ff3a6/extensions/derp/src/uri.ts). <VideoEmbed url="https://twitter.com/i/status/1678432353461637121" title="Derp + Raycast Extension Demo made using URIs" />Derp's URI scheme enables you to programmatically open new windows, tabs, launch configurations, or tab configs with ease.
How to use it
Section titled “How to use it”There are several ways to use the URI scheme:
- Open new window
derp://action/new_window?path=<path_to_folder> - Open new tab
derp://action/new_tab?path=<path_to_folder> - Open Launch Configuration
derp://launch/<launch_configuration_path> - Open Tab Config
derp://tab_config/<name>— opens the saved Tab Config as a new tab in the active window. Append?new_window=trueto open it in a new window instead.<name>is matched case-insensitively against the file stem of the.toml, so bothderp://tab_config/my_tabandderp://tab_config/my_tab.tomlresolve tomy_tab.toml. - Open Settings
derp://settings— opens the Settings window. See Settings deep links for search, widget, and sub-page options.
Settings deep links
Section titled “Settings deep links”Open the Settings window directly, optionally jumping to a specific page, widget, or search:
derp://settings— open Settings on the default page.derp://settings?q=<query>— open Settings with the search bar pre-filled.derp://settings?widget=<widget_id>— open Settings scrolled to a specific setting.derp://settings/appearance— open the Appearance page (themes, fonts, and more).derp://settings/mcp— open the MCP servers page. Append?autoinstall=<name>to install a gallery MCP server by name.derp://settings/derp_agent— open the Derp Agent page (inference and API keys).derp://settings/environments— open the Cloud environments page.derp://settings/platform— open the Platform page.derp://settings/billing_and_usage— open the Billing & usage page.derp://settings/teams— open Team settings. Append?invite=<email>to open the invite dialog with the email pre-filled.
How it works
Section titled “How it works”Example of Derp URIs in use in Derp + Raycast Extension.