Warp documentation
  • 🚀Getting Started
    • Quickstart Guide
    • What is Warp?
    • Migrate to Warp
    • Using Warp with [zsh|bash|fish|pwsh]
    • Privacy
    • Refer a Friend & Earn Rewards
    • Warp Preview & Alpha Program
    • Changelog
  • 🎨Appearance
    • Themes
    • Custom Themes
    • Prompt
    • Input Position
    • Text, Fonts, & Cursor
    • Size, Opacity, & Blurring
    • Pane Dimming & Focus
    • Blocks Behavior
    • Tabs Behavior
    • App Icons
  • 📕Features
    • Warp AI
      • Active AI
      • Agent Mode
      • Generate
      • Model Context Protocol
      • Voice
      • Rules
    • Command Palette
    • Warp Drive
      • Notebooks
      • Workflows
      • Prompts
      • Environment Variables
      • Warp Drive on the Web
    • Teams
    • Session Sharing
    • Blocks
      • Block Basics
      • Block Actions
      • Block Sharing
      • Block Filtering
      • Background Blocks
      • Sticky Command Header
    • Modern Text Editing
      • Alias Expansion
      • Command Inspector
      • Syntax & Error Highlighting
      • Vim Keybindings
    • Command Entry
      • Command Corrections
      • Command Search
      • Command History
      • Synchronized Inputs
      • YAML Workflows
    • Command Completions
      • Completions
      • Autosuggestions
    • Session Management
      • Launch Configurations
      • Session Navigation
      • Session Restoration
    • Window Management
      • Global Hotkey
      • Tabs
      • Split Panes
    • Warpify
      • Subshells
      • SSH
    • Accessibility
    • Find
    • Files, Links, & Scripts
    • Markdown Viewer
    • Working Directory
    • Smart-Select
    • Full-screen Apps
    • Keyboard Shortcuts
    • Notifications & Audible Bell
    • Settings Sync (Beta)
    • Quit Warning
    • Integrations
    • URI Scheme
    • Network Log
    • Secret Redaction
    • Linux
  • 📊How Does Warp Compare?
    • Performance
    • Terminal features
  • ❓Help
    • Sending Feedback & Logs
    • Plans, Subscriptions & Pricing
    • Updating Warp
    • Using Warp Offline
    • Logging out & Uninstalling
    • Known Issues
    • Troubleshooting Login Issues
    • Open Source Licenses
Powered by GitBook
On this page
  • What is Warp Drive?
  • How to access it
  • Workspaces in Warp Drive
  • Organizing objects in Warp Drive with your team
  • Using Warp Drive offline
  • Navigating Warp Drive with your keyboard
  • Import and Export
  • Importing files into Warp Drive
  • Exporting files from Warp Drive
  • Sharing Your Drive Objects
  • Sharing a Drive Object using Links
  • Managing Permissions
  • Troubleshooting Warp Drive

Was this helpful?

  1. Features

Warp Drive

Warp Drive is a workspace in your terminal where you can save Workflows, Notebooks, Prompts, and Environment Variables for personal use or to share with a team.

PreviousCommand PaletteNextNotebooks

Last updated 1 month ago

Was this helpful?

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

Warp Drive is accessible from the status bar in the Warp terminal or you can toggle the Warp Drive side panel with CMD-\.

Warp Drive is accessible from the status bar in the Warp terminal or you can toggle the Warp Drive side panel with CTRL-SHIFT-\.

Warp Drive is accessible from the status bar in the Warp terminal or you can toggle the Warp Drive side panel with CTRL-SHIFT-\.

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:

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

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

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

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:

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

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.

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.

Managing Permissions

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.

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

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 .

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

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

import from and export to MARKDOWN (.md)

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

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 , search for and select "Export all Warp Drive Objects", then select a directory for export.

Copy link Menu Item

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 and search for "Share Pane" or click the share button in the pane header:

📕
Command Palette
Workflows
Prompts
Notebooks
Environment Variables
Warp Drive, Teams, and Workflows Demo
Command Palette
Command Palette
Warp Drive Icon
Warp Drive offline mode
Warp Drive navigation states
Import modal
Pane header share button
Warp Drive sharing dialog
Warp Drive icon on top left corner of Warp
The pane header for a notebook, with the share button circled
A sharing dialog showing that anyone with the link can view, the owner has full access, and another user can edit.