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 a workflow?
  • How to save and edit workflows
  • Working with arguments
  • Working with aliases
  • Editing workflows
  • Editing workflows with a team
  • How to execute workflows
  • Support for YAML Workflows
  • Import and Export Workflows in Warp Drive

Was this helpful?

  1. Features
  2. Warp Drive

Workflows

Saved parameterized commands to run on-demand.

PreviousNotebooksNextPrompts

Last updated 1 month ago

Was this helpful?

What is a workflow?

A workflow is a parameterized command you can name and save in Warp with descriptions and arguments. Workflows are searchable and easily accessed from the so you can find and execute them without switching contexts.

How to save and edit workflows

You can create a new workflow from various entry points in Warp:

  • From Warp Drive, + > New workflow

  • Using Block Actions, Save as Workflow

  • From Warp AI results, Save as Workflow

  • From the , Create a New Personal Workflow

Any of these entry points will open the workflow editor where you can:

  • Name your workflow

  • Edit the command along with any arguments (also known as parameters)

  • Add a meaningful description that will be indexed for search (optional)

  • Add arguments, descriptions for arguments, and default values (optional)

Working with arguments

In the workflow editor, you can add arguments manually with "New argument" or by typing in double curly braces ({{argument}}) within the command field. If you select "New argument" while you have text selected, Warp will wrap that text in curly braces to create an argument.

There are some rules for creating valid arguments:

  • Argument names can only include characters A-Za-z0-9, hyphens - and underscores _

  • The first character of an argument cannot be a number

Arguments can be one of two types: text or enum. By default, all new arguments are text type.

Enum type arguments

Enums allow you to specify expected inputs to a workflow argument. When you insert a workflow with enums into the input editor, you will be prompted with suggestions for filling in the argument. You can open the suggestions menu by pressing SHIFT-TAB while selecting an argument.

To create an enum type argument:

  1. Navigate to the "default value" field of an argument.

  2. Select the "Enum" type.

  3. Click "New" to create a new enum, or select an existing one from the dropdown menu.

  4. If you selected "New", you can choose to create a "Static" enum or "Dynamic" enum. Dynamic enums are associated with a shell command whose output is parsed to determine the set of valid values for that argument.

Working with aliases

Editing workflows

Once a workflow has been created, you can edit it at any time, as long as you have access to an internet connection.

AI Autofill

  • Create or edit a Workflow, in the edit view you should see the option to AutoFill.

  • Warp AI will fill in the fields based on the Workflow you're creating.

Editing workflows with a team

If the workflow is shared with a team, all team members will have access to edit the workflow and updates will sync immediately for all members of the team.

If a workflow in the Warp Drive has been edited by another team member or a user on another device while you are attempting to edit the same workflow, you will not be able to save changes; you will need to check out the latest version and try again.

How to execute workflows

You can execute a workflow in several ways:

  • From Warp Drive, click the workflow

  • When a workflow is selected, you can use SHIFT-TAB to cycle through the arguments.

When you create two or more arguments with the same name, Warp automatically selects and puts multiple cursors over the arguments in the input editor so they are synced. Also, tailor your Command Search experience by toggling off "Show Global Workflows" in Settings > Features. When disabled, your search will exclusively encompass YAML and Warp Drive Workflows.

These options will paste the workflow into your active terminal input. Workflow names and any relevant descriptions and arguments will be displayed in a dialog, so you can understand how to use the workflow.

You make any adjustments you need to the arguments (or the command itself) before running the command in your input editor.

Support for YAML Workflows

Import and Export Workflows in Warp Drive

Workflow aliases allow you to create personalized shortcuts and custom configurations for your frequently used workflows. These aliases provide enhanced flexibility in how you use and configure workflows. Aliases are personal to your account, not shared with everyone who has the workflow. If settings sync is enabled, they'll be synced across devices logged in to your account. Aliases can set default values for each , but don't have to. Aliases can have associated with them.

Workflow aliases are not compatible with . They can only be used with Workflows created in .

Workflows also have the option to use to automatically generate a title, descriptions, or parameters.

From the , search for a workflow you’d like to execute, click or select, and enter

From , search for a workflow you'd like to execute, click or select, and enter.

Warp will indefinitely support the , which includes personal and community workflows sourced from an open-source repository.

If needed, you can continue to access your .yaml file workflows using or the . However, these file-based workflows will not be available to access, organize, or share in Warp Drive.

Please see our instructions.

📕
YAML Workflows
Warp Drive
Warp AI
Command Palette
Command Search
YAML Workflows
Command Search
Command Palette
Environmental Variables
argument
Command Palette
Command Palette
Save Workflow Demo
Enum Input Suggestions Demo
Enum Creation Demo
Running Workflow Demo
Warp Drive Import and Export
Workflows save / edit pane
Edit workflow menu
Edit Workflows - Autofill
Search for any workflow in the Command Palette with CMD + P
Execute a Workflow
Workflows save and edit modal