Warp

Warp is a modern terminal for developers. Protocol Launcher allows you to generate deep links to open new Warp windows, tabs, Launch Configurations, and Tab Configs.

Usage

There are two ways to use this library:

• On-Demand import from subpaths enables tree-shaking and keeps bundles small.
• Full Import from the root package is convenient but includes all app modules.

Pick On-Demand for production builds; Full Import is fine for quick scripts or demos.

Select Installation Method

On-Demand

Recommended. Optimized for production.

Full Import

Convenient. Good for quick scripts.

Open New Window

On-Demand

import { newWindow } from 'protocol-launcher/warp'

const url = newWindow({
  path: 'path_to_folder',
})

Open New Warp Window

Open New Tab

On-Demand

import { newTab } from 'protocol-launcher/warp'

const url = newTab({
  path: 'path_to_folder',
})

Open New Warp Tab

Open Launch Configuration

On-Demand

import { launchConfiguration } from 'protocol-launcher/warp'

const url = launchConfiguration({
  path: 'launch_configuration_path',
})

Open Launch Configuration

Open Tab Config

On-Demand

import { tabConfig } from 'protocol-launcher/warp'

const url = tabConfig({
  name: 'my_tab',
  newWindow: true,
})

Open Tab Config

Warp Preview

Warp's official URI scheme documentation says Warp Preview uses the warppreview:// scheme. Pass scheme: 'warppreview' to target Warp Preview with the same helpers.

On-Demand

import { newTab } from 'protocol-launcher/warp'

const url = newTab({
  path: 'path_to_folder',
  scheme: 'warppreview',
})

Official Warp URI Scheme documentation

Open Settings

Open Settings with an optional page, q search string, or widget ID. autoinstall applies to the mcp page; invite prefills an email on the teams page. The scheme option also supports warppreview.

On-Demand

import { openSettings } from 'protocol-launcher/warp'

const url = openSettings({
  page: 'mcp',
  autoinstall: 'my-server'
})

Open Settings

Official Documentation

• URL scheme documentation