Saved parameterized commands to run on-demand
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 Command Palette so you can find and execute them without switching contexts.
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 Command Palette, Create a New Personal Workflow
- With a Keyboard Shortcut,
SHIFT + CMD + H
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)
- (optional) Add a meaningful description that will be indexed for search
- (optional) Add arguments, descriptions for arguments, and default values
Workflows save / edit modal
Save Workflow Demo
In the workflow editor, you can add arguments manually with "New argument" or by typing in double curly braces 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
- The first character of an argument cannot be a number
Once a workflow has been created, you can edit it at any time, as long as you have access to an internet connection.
Edit workflow menu
Edit Workflow Demo
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.
You can execute a workflow in several ways:
- From Warp Drive, click the workflow
- From the Command Palette
CMD-P, search for a workflow you’d like to execute, click or select and enter
- From Command Search
CTRL-R, search for a workflow you'd like to execute, click or select and enter.
- When a workflow is selected, you can use
SHIFT-TABto cycle thru 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.
Search for any workflow in the Command Palette with
CMD + P
These options will paste the workflow into your active terminal input. Workflow names and any relevant descriptions and arguments will display in a dialog, so you can understand how to use the workflow.
Execute a Workflow
You make any adjustments you need to the arguments (or the command itself) before running the command in your input editor.
Running Workflow Demo
Although we encourage you to create workflows with the new workflow editor in Warp Drive, we hope you’ll find it a much easier experience, there are plans for Warp Drive workflows to be imported/exported to prevent vendor lock-in.