Warp Drive

What is Warp Drive?

All objects stored in Warp Drive sync immediately as they’re updated, so you and your team will always have access to the latest versions.

How to access it

Workspaces in Warp Drive

When you open the Warp Drive panel, you will find a personal workspace where you can store your Workflows, Notebooks, Prompts, and Environment Variables and organize them into folders.

If you are a member of a team using Warp Drive, your team’s workspace will also be available in the side panel.

Organizing objects in Warp Drive with your team

• Objects (e.g. Workflows, Notebooks, Prompts, and Environment Variables) and folders in Warp Drive can be sorted alphabetically and by the last updated

• Any objects moved from your personal workspace into a team’s workspace will be shared with all members of your team

• It is not currently possible to move an item back from a team’s workspace into a personal workspace; if you shared something inadvertently, you should copy the contents of the object to your clipboard, recreate it in your personal workspace, and then delete the object from your team workspace

• It is not currently possible to drag a folder of personal Workflows into a team workspace; you will need to move objects one at a time

Using Warp Drive offline

In offline mode, some files will be read-only. You can still create and edit files while offline in your personal space. They will only be saved locally and will not be synced. They cannot be moved into a team or deleted until you are back online.

Navigating Warp Drive with your keyboard

To avoid going back and forth between your mouse and keyboard, you can use your keyboard to navigate through Warp Drive once you have either opened Warp Drive or switched focus to the Warp Drive panel. (You can also click on a blank area within Warp Drive.) The object you are navigating with your keyboard will be highlighted in an accented color.

You can take these keyboard actions within Warp Drive:

To switch between panels using your keyboard, you can use the “Switch Focus to Left Panel” and “Switch Focus to Right Panel” commands in the Command Palette.

Import and Export

Every object in Warp Drive can be exported to or imported from a file. When importing or exporting, objects are converted as follows:

• Workflows import from and export to YAML (.yaml, .yml)

• Prompts import isn't supported at this time, but you can export to YAML (.yaml, .yml)

• Notebooks import from and export to MARKDOWN (.md)

• Environment Variables import isn't supported at this time, but you can export to DOTENV (.env)

Importing files into Warp Drive

To import a local file or directory, RIGHT-CLICK on a folder or click + on a workspace and choose "Import." If importing a directory, supported files in the directory and its sub-directories will be imported into a matching folder structure.

Exporting files from Warp Drive

To export a single Warp Drive object, RIGHT-CLICK on an object and choose "Export" from the menu, then select a directory for export. To export all Warp Drive objects, Open the Command Palette, search for and select "Export all Warp Drive Objects", then select a directory for export.

Sharing Your Drive Objects

Every object in Warp Drive can be shared. There are three ways to share objects:

• Teams: All members of a Warp team have full access to the objects in its Drive.

• Direct Sharing: Objects can be shared directly with individuals by email.

• Link-based Sharing: You can make an object public to anyone with the link, including those without Warp accounts.

Sharing a Drive Object using Links

To share a Drive object, navigate to the object's overflow menu, and choose "Copy link". Once the link is successfully copied to your clipboard, you can share it with teammates and reference your object in your codebase, documentation, or communication channels like Slack.

Managing Permissions

To manage a Drive object's permissions, navigate to its overflow menu and choose "Share". If the object is open, you can also use the Command Palette and search for "Share Pane" or click the share button in the pane header:

This opens a dialog that lists the current sharing settings and allows you to change them:

In this dialog, you can:

• Invite other users directly using the email input at the top.

• Change or remove the public link-based access level.

• Update the access level for individual users, or remove their access.

Permissions are inherited from parent folders. For example, if a folder was shared with edit permissions, then the user would also be able to edit all objects inside the folder or its subfolders.

Owners and their teammates always have full access. When sharing an object, you can choose between view and edit access.

Troubleshooting Warp Drive

• If you were previously using Warp on your own and were later invited to join a team, you may need to exit, update, and restart the Warp app to gain access to your team’s shared drive and commands

• Navigating to Settings > Teams in Warp should also force a metadata update for you, which will ensure you have access to the latest versions of Workflows in your team's drive