Workflows
The repo for all public Workflows that appear within Warp and within commands.dev.
To learn how to create local or repository workflows, see our docs.
What are Workflows?
Workflows are an easier way to execute and share commands within Warp. They are searchable by name, description, or command and are easily parameterized. See our documentation for more details: https://docs.warp.dev/features/workflows
How Do I Access Workflows within Warp?
Workflows can be accessed directly within Warp, either through the Command Palette or by pressing ctrl-shift-r.
All public workflows (i.e. workflows within this repo) are also available at commands.dev.
Contributing
Contributions are always welcome! If you have a workflow that would be useful to many Warp users, feel free to send a PR to add a Workflow spec.
All workflows are defined as YAML files within the specs/ directory.
File Format
A comprehensive description of the file format is available in FORMAT.md. Additionally, see the workflow below as an example to quickly get started:
---
# The name of the workflow.
name: Uninstall a Homebrew package and all of its dependencies
# The corresponding command for the workflow. Any arguments should be surrounded with two curly braces. E.g `command {{arg}}`.
command: |-
brew tap beeftornado/rmtree
brew rmtree {{package_name}}
# Any tags that the workflow should be categorized with.
tags:
- homebrew
# A description of the workflow.
description: Uses the external command rmtree to remove a Homebrew package and all of its dependencies
# List of arguments within the command.
arguments:
# Name of the argument within the command. This must exactly match the name of the argument
# within the command (without the curly braces).
- name: package_name
# The description of the argument.
description: The name of the package that should be removed
# The default value for the argument.
default_value: ~
# The source URL for where the workflow was generated from, if any.
source_url: "https://stackoverflow.com/questions/7323261/uninstall-remove-a-homebrew-package-including-all-its-dependencies"
# The author of the workflow.
author: Ory Band
# The URL of original author of the Workflow. For example, if this workflow was generated from StackOverflow, the `author_url` would be the StackOverflow author's profile page.
author_url: "https://stackoverflow.com/users/207894"
# The valid shells where this workflow should be active. If valid for all shells, this can be left empty.
# See FORMAT.md for the full list of accepted values.
shells: []
Testing
To test a workflow within Warp before submitting, you can use it as a local workflow within warp.
To do this:
- Copy the workflow to your local
~/.warp/workflowsdirectory:mkdir -p ~/.warp/workflows && cp {{workflow}}.yaml; ~/.warp/workflows/
- Open Warp and open workflows by pressing
ctrl-shift-ror using the command palette. - Click on "My Workflows" on the left to filter for local workflows.
- Click on the workflow you've added and ensure all the information is correct.
To quickly test if a workflow file format is valid, you can also build workflows locally to validate the schema is correct:
# Download the rust toolchain, if not already installed.
brew install rust-up
rustup-init
# Ensure the workflows can successfully be converted into Rust.
cargo build
What Makes a Useful Workflow?
A good workflow is one that includes a command with many flags or arguments or one that is hard to remember.
Additionally, a workflow must include:
- A descriptive title that includes the name of the command--this is useful for improving the experience of searching for workflows in Warp or commands.dev.
- A tag that accurately categorizes the workflows. Avoid many repetitive tags to improve searchability of workflows within Warp.
- A description for the workflow and each of its arguments, if applicable.
- A default value for each argument, if applicable.
24 Oct 6, 2022
8 Mar 2, 2023
4 Feb 26, 2024
8 Aug 10, 2023
364 Dec 28, 2022
4 Nov 7, 2023
1 Dec 20, 2022
20 Apr 8, 2023
39 Jun 19, 2023
4 Jan 16, 2023
2 Mar 2, 2022
5 Sep 11, 2022
4 Dec 31, 2022
104 Oct 7, 2023
4.6k Jan 1, 2023
18 Oct 24, 2022
4 Jun 25, 2023
9 Oct 9, 2022
13 Jan 18, 2023