Skip to content

Terminal > More Features

Derp URI Scheme

Open in ChatGPT ↗
Ask ChatGPT about this page
Open in Claude ↗
Ask Claude about this page
Copied!

Derp's URI scheme enables you to programmatically open new windows, tabs, launch configurations, or tab configs with ease.

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=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 for search, widget, and sub-page options.

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.

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

Derp + Raycast Extension Demo made using URIs