# Source: https://docs.warp.dev/knowledge-and-collaboration/warp-drive.md

# 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.

{% embed url="<https://www.youtube.com/watch?v=8UmreUTTrkg>" %}
Warp Drive, Teams, and Workflows Demo
{% endembed %}

## How to access it

{% tabs %}
{% tab title="macOS" %}
Warp Drive is accessible from the status bar in the Warp terminal or you can toggle the Warp Drive side panel with `CMD-\`.
{% endtab %}

{% tab title="Windows" %}
Warp Drive is accessible from the status bar in the Warp terminal or you can toggle the Warp Drive side panel with `CTRL-SHIFT-\`.
{% endtab %}

{% tab title="Linux" %}
Warp Drive is accessible from the status bar in the Warp terminal or you can toggle the Warp Drive side panel with `CTRL-SHIFT-\`.
{% endtab %}
{% endtabs %}

<figure><img src="https://4009768362-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FPsjNxoJ0NFCXW6rRdHH3%2Fuploads%2Fgit-blob-0288f9040db807f99341ba18e772017afdce8ed3%2FOpen_Warp_Drive.png?alt=media" alt="Warp Drive icon on top left corner of Warp"><figcaption><p>Warp Drive Icon</p></figcaption></figure>

## 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.

<figure><img src="https://4009768362-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FPsjNxoJ0NFCXW6rRdHH3%2Fuploads%2Fgit-blob-d0cb97917d2ddc51af2f22680309c5fcff367270%2FWarp_Drive_Zero_State.png?alt=media" alt=""><figcaption></figcaption></figure>

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

<figure><img src="https://4009768362-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FPsjNxoJ0NFCXW6rRdHH3%2Fuploads%2Fgit-blob-062dd655495a77c5e7534e1be9fe4bafe427856c%2FWarp_Drive_with_Team.png?alt=media" alt=""><figcaption></figcaption></figure>

## 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.

<figure><img src="https://4009768362-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FPsjNxoJ0NFCXW6rRdHH3%2Fuploads%2Fgit-blob-09dfac99a8d1b5e05c02e530d20af0f94356fa45%2Fwarp_drive_offline.png?alt=media" alt=""><figcaption><p>Warp Drive offline mode</p></figcaption></figure>

## 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:

{% tabs %}
{% tab title="macOS" %}

* Press `UP`/`DOWN` or `j`/`k` to navigate to the object you want.
* Press `Enter` to 1) execute an object, 2) open/collapse a workspace or folder, or 3) open the trash.
* Press `CMD-ENTER` to open an object’s context menu.
* Press `CMD-SHIFT-(` and `CMD-SHIFT-)` to switch focus between the terminal and Warp Drive.
* Press `LEFT-ARROW` to collapse a workspace or folder
* Press `RIGHT-ARROW` to open a workspace or folder
* Press `Esc` to return to Warp Drive from your trash.
  {% endtab %}

{% tab title="Windows" %}

* Press `UP`/`DOWN` or `j`/`k` to navigate to the object you want.
* Press `Enter` to 1) execute an object, 2) open/collapse a workspace or folder, or 3) open the trash.
* Press `CTRL-ENTER` to open an object’s context menu.
* Press `CTRL-SHIFT-(` and `CTRL-SHIFT-)` to switch focus between the terminal and Warp Drive.
* Press `LEFT-ARROW` to collapse a workspace or folder
* Press `RIGHT-ARROW` to open a workspace or folder
* Press `Esc` to return to Warp Drive from your trash.
  {% endtab %}

{% tab title="Linux" %}

* Press `UP`/`DOWN` or `j`/`k` to navigate to the object you want.
* Press `Enter` to 1) execute an object, 2) open/collapse a workspace or folder, or 3) open the trash.
* Press `CTRL-ENTER` to open an object’s context menu.
* Press `CTRL-SHIFT-(` and `CTRL-SHIFT-)` to switch focus between the terminal and Warp Drive.
* Press `LEFT-ARROW` to collapse a workspace or folder
* Press `RIGHT-ARROW` to open a workspace or folder
* Press `Esc` to return to Warp Drive from your trash.
  {% endtab %}
  {% endtabs %}

<figure><img src="https://4009768362-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FPsjNxoJ0NFCXW6rRdHH3%2Fuploads%2Fgit-blob-b270a227ece084a6ea41dbcc66f638fccb93883e%2Fwarp_drive_nav1.png?alt=media" alt=""><figcaption><p>Warp Drive navigation states</p></figcaption></figure>

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](https://docs.warp.dev/terminal/command-palette).

<figure><img src="https://4009768362-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FPsjNxoJ0NFCXW6rRdHH3%2Fuploads%2Fgit-blob-c471c8ad16ced21c0b393bbba746040d8b800fd8%2Fwarp_drive_nav2.png?alt=media" alt=""><figcaption></figcaption></figure>

## 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](https://docs.warp.dev/knowledge-and-collaboration/warp-drive/workflows) import from and export to YAML (.yaml, .yml)
* [Prompts](https://docs.warp.dev/knowledge-and-collaboration/warp-drive/prompts) import isn't supported at this time, but you can export to YAML (.yaml, .yml)
* [Notebooks](https://docs.warp.dev/knowledge-and-collaboration/warp-drive/notebooks) import from and export to MARKDOWN (.md)
* [Environment Variables](https://docs.warp.dev/knowledge-and-collaboration/warp-drive/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.

<figure><img src="https://4009768362-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FPsjNxoJ0NFCXW6rRdHH3%2Fuploads%2Fgit-blob-74cb6c7302db2318a21a39a8769f17bdf81908d8%2Fnotebook-import-modal.png?alt=media" alt=""><figcaption><p>Import modal</p></figcaption></figure>

### 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](https://docs.warp.dev/terminal/command-palette#how-to-access-it), 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.

{% hint style="info" %}
In order to access an object, link-followers must have permission to open it through one of the sharing methods above. If they do not have permission, they can automatically request access from the object owner or team admin.
{% endhint %}

<figure><img src="https://4009768362-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FPsjNxoJ0NFCXW6rRdHH3%2Fuploads%2Fgit-blob-cf376faaf78a9f2f2cce858d45f377b7f8911b7e%2Fwd-copy-link-menu.png?alt=media" alt="" width="216"><figcaption><p>Copy link Menu Item</p></figcaption></figure>

### 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](https://docs.warp.dev/terminal/command-palette#how-to-access-it) and search for "Share Pane" or click the share button in the pane header:

<figure><img src="https://4009768362-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FPsjNxoJ0NFCXW6rRdHH3%2Fuploads%2Fgit-blob-f914bba18dc86b02d7b326da6b125c6e387ef517%2Fwd-share-button.png?alt=media" alt="The pane header for a notebook, with the share button circled"><figcaption><p>Pane header share button</p></figcaption></figure>

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

<figure><img src="https://4009768362-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FPsjNxoJ0NFCXW6rRdHH3%2Fuploads%2Fgit-blob-6b2434fbc61f1b6522f9cdfb606290f16c402331%2Fwd-share-dialog.png?alt=media" alt="A sharing dialog showing that anyone with the link can view, the owner has full access, and another user can edit."><figcaption><p>Warp Drive sharing dialog</p></figcaption></figure>

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.

|                                     | Can view | Can edit | Full access |
| ----------------------------------- | -------- | -------- | ----------- |
| Read a notebook                     | ✓        | ✓        | ✓           |
| Execute a Workflow                  | ✓        | ✓        | ✓           |
| Use env vars                        | ✓        | ✓        | ✓           |
| Edit contents                       |          | ✓        | ✓           |
| Create objects in a folder          |          | ✓        | ✓           |
| Trash or untrash                    |          | ✓        | ✓           |
| Delete permanently                  |          |          | ✓           |
| Modify permissions                  |          |          | ✓           |
| Move to a different folder or drive |          |          | ✓           |

## 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