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 Prompt?
  • How to save and edit Prompts
  • Working with arguments
  • Editing Prompts with a team
  • How to execute Prompts
  • Import and Export Prompts in Warp Drive

Was this helpful?

  1. 📕Features
  2. Warp Drive

Prompts

Save and reuse parameterized Agent Mode prompts to run on-demand.

PreviousWorkflowsNextEnvironment Variables

Last updated 1 month ago

Was this helpful?

What is a Prompt?

A Prompt is a parameterized natural language query you can name and save in Warp to use with Agent Mode.

Prompts are searchable and easily accessed from the Command Palette so you can find and execute them without switching context. They allow you to save and reuse specific and complex AI workflows, making it easier to repeat multi-step tasks with Agent Mode.

How to save and edit Prompts

You can create a new Prompt from Warp Drive by clicking the + button and selecting "Prompt".

  • Name your Prompt

  • Edit the natural language query 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)

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

Working with arguments

In the Prompt 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 Prompt argument. When you insert a Prompt 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.

Editing Prompts with a team

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

If a Prompt 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 Prompt, you will not be able to save changes; you will need to check out the latest version and try again.

How to execute Prompts

You can execute a Prompt in several ways:

  • From Warp Drive, click the Prompt

  • From the Command Palette or Command Search, search for a Prompt by name or type "prompts:" to see all available prompts and your prompt history

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

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

You can make any adjustments you need to the arguments before running the Prompt in your input editor.

Import and Export Prompts in Warp Drive

For detailed information about creating and using enum type arguments, please see the .

Please see our instructions.

Enum type arguments section in Workflows documentation
Command view of a Prompt in Warp Drive
Edit view of a Prompt in Warp Drive
Search for Prompts in the Command Palette with CMD + P
Search for Prompts in Command Search with CTRL + R
View of a Prompt in Warp Drive showing the command view interface
View of the Prompt editor interface showing the edit form with fields for name, query, description, and arguments
Command Palette interface showing a search for Prompts with results displayed
Command Search interface showing a search for Prompts with results displayed
Warp Drive Import and Export