diff --git a/src/assets/agent-platform/auto-queue-toggle.png b/src/assets/agent-platform/auto-queue-toggle.png new file mode 100644 index 00000000..bd24cce3 Binary files /dev/null and b/src/assets/agent-platform/auto-queue-toggle.png differ diff --git a/src/assets/agent-platform/prompt-queueing-cloud-locked-row.png b/src/assets/agent-platform/prompt-queueing-cloud-locked-row.png new file mode 100644 index 00000000..41589d37 Binary files /dev/null and b/src/assets/agent-platform/prompt-queueing-cloud-locked-row.png differ diff --git a/src/assets/agent-platform/prompt-queueing-panel.png b/src/assets/agent-platform/prompt-queueing-panel.png new file mode 100644 index 00000000..34fede12 Binary files /dev/null and b/src/assets/agent-platform/prompt-queueing-panel.png differ diff --git a/src/assets/agent-platform/prompt-queueing-row-controls.png b/src/assets/agent-platform/prompt-queueing-row-controls.png new file mode 100644 index 00000000..cfefc3c7 Binary files /dev/null and b/src/assets/agent-platform/prompt-queueing-row-controls.png differ diff --git a/src/assets/agent-platform/prompt-submission-mode-setting.png b/src/assets/agent-platform/prompt-submission-mode-setting.png new file mode 100644 index 00000000..33c76f49 Binary files /dev/null and b/src/assets/agent-platform/prompt-submission-mode-setting.png differ diff --git a/src/content/docs/agent-platform/capabilities/slash-commands.mdx b/src/content/docs/agent-platform/capabilities/slash-commands.mdx index 5a2fa1e8..4f6190c4 100644 --- a/src/content/docs/agent-platform/capabilities/slash-commands.mdx +++ b/src/content/docs/agent-platform/capabilities/slash-commands.mdx @@ -18,7 +18,7 @@ As you type, the menu filters results in real time, making it easy to find and r Warp currently supports the following built-in Slash Commands: -
Slash CommandDescription
/add-mcpAdd a new MCP server.
/add-promptAdd a new Agent Prompt in Warp Drive.
/add-ruleAdd a new Global Rule for the Agent.
/agentStart a new agent conversation. Optionally include a prompt to send immediately.
/changelogOpen the latest Warp changelog.
/cloud-agentStart a new cloud agent conversation. {'*'}
/compactFree up context by summarizing conversation history.
/compact-andCompact the current conversation and then send a follow-up prompt.
/conversationsOpen conversation history.
/costToggle credit usage details in the current conversation.
/create-environmentCreate a Warp Environment (Docker image + repos) via guided setup. {'*'}
/create-new-projectHave the Agent walk you through creating a new coding project. {'*'}
/export-to-clipboardExport the current conversation to clipboard in markdown format.
/export-to-fileExport the current conversation to a markdown file.
/feedbackOpen the static feedback experience. See Using /feedback in Warp for details.
/forkForks the current conversation into a new thread with the full context and history of the original.

You can optionally include a prompt that will be sent immediately in the forked conversation.
/fork-and-compactForks the current conversation and automatically compacts the forked version.

Useful when you want a fresh, summarized starting point that preserves relevant context while trimming the rest.
/fork-fromOpen a searchable menu to fork the conversation from a specific query. Select a query to create a fork that includes everything up to that point.
/indexIndex the current codebase using Codebase Context.
/initIndex the current codebase and generate an AGENTS.md file. {'*'}
/modelSwitch the base agent model for the current conversation.
/newStart a new agent conversation (alias for /agent).
/open-code-reviewOpen the code review pane.
/open-fileOpen a file for editing in Warp's code editor.
/open-mcp-serversView the status of your MCP servers.
/open-project-rulesOpen the Project Rules file (AGENTS).
/open-repoSwitch to another indexed repository.
/open-rulesView all of your global and project rules.
/open-settings-fileOpen the Warp settings file (settings.toml) in Warp's code editor.
/open-skillOpen an interactive menu to browse and edit project or global skills.
/orchestrateBreak a task into subtasks and run them in parallel with multiple agents. {'*'}
/planPrompt the Agent to do some research and create a plan for a task.
/pr-commentsPull GitHub PR review comments into Warp. {'*'}
/profileSwitch the active execution profile.
/promptsSearch saved prompts.
/rename-tabRename the current tab. Include the new tab name as an argument (for example, /rename-tab deploy).
/rewindRewind to a previous point in the conversation.
/skillsInvoke a skill from a searchable menu.
/usageOpen billing and usage settings.
+
Slash CommandDescription
/add-mcpAdd a new MCP server.
/add-promptAdd a new Agent Prompt in Warp Drive.
/add-ruleAdd a new Global Rule for the Agent.
/agentStart a new agent conversation. Optionally include a prompt to send immediately.
/changelogOpen the latest Warp changelog.
/cloud-agentStart a new cloud agent conversation. {'*'}
/compactFree up context by summarizing conversation history.
/compact-andCompact the current conversation and then send a follow-up prompt.
/conversationsOpen conversation history.
/costToggle credit usage details in the current conversation.
/create-environmentCreate a Warp Environment (Docker image + repos) via guided setup. {'*'}
/create-new-projectHave the Agent walk you through creating a new coding project. {'*'}
/export-to-clipboardExport the current conversation to clipboard in markdown format.
/export-to-fileExport the current conversation to a markdown file.
/feedbackOpen the static feedback experience. See Using /feedback in Warp for details.
/forkForks the current conversation into a new thread with the full context and history of the original.

You can optionally include a prompt that will be sent immediately in the forked conversation.
/fork-and-compactForks the current conversation and automatically compacts the forked version.

Useful when you want a fresh, summarized starting point that preserves relevant context while trimming the rest.
/fork-fromOpen a searchable menu to fork the conversation from a specific query. Select a query to create a fork that includes everything up to that point.
/indexIndex the current codebase using Codebase Context.
/initIndex the current codebase and generate an AGENTS.md file. {'*'}
/modelSwitch the base agent model for the current conversation.
/newStart a new agent conversation (alias for /agent).
/open-code-reviewOpen the code review pane.
/open-fileOpen a file for editing in Warp's code editor.
/open-mcp-serversView the status of your MCP servers.
/open-project-rulesOpen the Project Rules file (AGENTS).
/open-repoSwitch to another indexed repository.
/open-rulesView all of your global and project rules.
/open-settings-fileOpen the Warp settings file (settings.toml) in Warp's code editor.
/open-skillOpen an interactive menu to browse and edit project or global skills.
/orchestrateBreak a task into subtasks and run them in parallel with multiple agents. {'*'}
/planPrompt the Agent to do some research and create a plan for a task.
/pr-commentsPull GitHub PR review comments into Warp. {'*'}
/profileSwitch the active execution profile.
/promptsSearch saved prompts.
/queueQueue a prompt to send after the agent finishes responding. See Prompt Queueing.
/rename-tabRename the current tab. Include the new tab name as an argument (for example, /rename-tab deploy).
/rewindRewind to a previous point in the conversation.
/skillsInvoke a skill from a searchable menu.
/usageOpen billing and usage settings.
:::caution Slash commands marked with a `*` consume credits to complete the task. diff --git a/src/content/docs/agent-platform/local-agents/interacting-with-agents/index.mdx b/src/content/docs/agent-platform/local-agents/interacting-with-agents/index.mdx index 7d09b3ff..ddab4d85 100644 --- a/src/content/docs/agent-platform/local-agents/interacting-with-agents/index.mdx +++ b/src/content/docs/agent-platform/local-agents/interacting-with-agents/index.mdx @@ -36,6 +36,8 @@ By default, if you ask an AI query immediately after interacting in Agent Mode, * Open the **Conversations menu** (`CMD + Y` on macOS, `CTRL + SHIFT + Y` on Windows/Linux), select a conversation, and then enter your query. * Alternatively, click the pink conversation chip in the input field to resume. +You don't have to wait for the agent to finish before lining up your next prompt. With [prompt queueing](/agent-platform/local-agents/interacting-with-agents/prompt-queueing/), you can queue follow-ups while the agent is still responding and have them send automatically in order. +
![Continuing an Agent conversation in Classic Input (with indicator)](../../../../../assets/agent-platform/classic-input-follow-up.png)
Continuing an agent conversation in Classic Input.
diff --git a/src/content/docs/agent-platform/local-agents/interacting-with-agents/prompt-queueing.mdx b/src/content/docs/agent-platform/local-agents/interacting-with-agents/prompt-queueing.mdx new file mode 100644 index 00000000..d2c253a6 --- /dev/null +++ b/src/content/docs/agent-platform/local-agents/interacting-with-agents/prompt-queueing.mdx @@ -0,0 +1,129 @@ +--- +title: Prompt queueing +description: >- + Queue follow-up prompts while an agent is still responding, then have Warp + send them automatically and in order as each response finishes. +--- + +Prompt queueing lets you line up follow-up prompts while an agent is still working. Instead of waiting for the agent to finish—or interrupting it to send your next idea—you queue prompts and Warp sends them automatically, one at a time, as each response completes. + +
+![An agent conversation with the queued prompts panel showing three queued prompts above the input.](../../../../../assets/agent-platform/prompt-queueing-panel.png) +
The queued prompts panel, with three prompts queued while the agent responds.
+
+ +## Key features + +* **Auto-queue toggle** - Turn on auto-queue so every prompt you submit while the agent is busy joins the queue instead of interrupting the current response. +* **`/queue` slash command** - Queue a single follow-up prompt inline, without switching modes. +* **Queued prompts panel** - View, reorder, edit, and remove every pending prompt from one collapsible panel above the input. +* **Automatic sequential sending** - Queued prompts fire one at a time as the agent finishes each response, in the order you set. +* **Per-conversation queues** - Each conversation keeps its own queue and auto-queue state, which persist when you leave and re-enter the conversation. +* **Cloud agent support** - Queue follow-ups for cloud agents, even while the environment is still setting up. + +## How it works + +Each agent conversation has its own queue. When the current response finishes successfully, Warp sends the next prompt in the queue. This continues one prompt at a time until the queue is empty. + +Queued prompts use the same submission flow as prompts you send manually, so slash commands, skills, and other input behave the same way. + +A few things to know: + +* **Shell commands are never queued.** If you submit in shell mode, Warp runs the command in the terminal immediately, regardless of your auto-queue setting. +* **Queues don't persist across restarts.** A conversation's queue is cleared when the conversation is deleted or cleared, and queues do not persist after an app restart. +* **One prompt is in flight at a time.** Warp waits for the current response to finish before sending the next queued prompt. + +## Queueing a prompt + +There are three ways to queue prompts. The auto-queue toggle and `/queue` act on the active conversation; the default submission mode setting controls what happens app-wide. + +### Auto-queue toggle + +The auto-queue toggle is the fastest way to queue several prompts in a row. While the agent is responding, a clock-plus icon appears in the warping indicator (the status bar above the input). + +
+![The auto-queue toggle active in the warping indicator, with a tooltip reading 'Auto-queue is on: your next prompt will be queued.'](../../../../../assets/agent-platform/auto-queue-toggle.png) +
The auto-queue toggle in the warping indicator.
+
+ +1. Click the clock-plus icon, or press `⌘+Shift+J` (macOS) or `Ctrl+Shift+J` (Windows/Linux). The icon turns the accent color to show auto-queue is on. +2. Type a prompt and press `Enter`. Because the conversation is in progress, the prompt is added to the queue instead of interrupting the current response. The input refocuses so you can keep queuing. + +The toggle is per-conversation and stays on across responses until you turn it off, so you can queue as many prompts as you like. Switching to another conversation shows that conversation's own toggle state. + +### `/queue` slash command + +Use `/queue` to add one follow-up prompt without turning on auto-queue. + +1. In an agent conversation, type `/queue` followed by the prompt—for example, `/queue run the tests and fix any failures`. +2. Press `Enter`. The prompt is added to the queue and the input clears. + +`/queue` requires an active conversation and a prompt. If you run `/queue` without a prompt, Warp shows an error. + +Note: If the agent is idle, `/queue` sends the prompt immediately. It only queues prompts while a response is in progress. + +### Set the default submission mode + +By default, submitting a prompt while the agent is responding interrupts the current response and sends your new prompt right away. You can change this default so new conversations queue instead. + +1. In the Warp app, go to **Settings** > **Agents** > **Warp Agent** > **Input**. +2. For **Default prompt submission mode**, choose one of: + * **Interrupt response** - Cancel the in-flight response and send the new prompt immediately (the default). + * **Queue until response finishes** - Hold the new prompt until the current response finishes, then send it. + +This setting is the default for conversations that you haven't explicitly toggled. The per-conversation auto-queue toggle always overrides it for that conversation. + +
+![The Default prompt submission mode dropdown in Agent input settings, open to show 'Interrupt response' and 'Queue until response finishes.'](../../../../../assets/agent-platform/prompt-submission-mode-setting.png) +
The Default prompt submission mode setting under Agent input settings.
+
+ +## Managing queued prompts + +When a conversation has at least one queued prompt, the queued prompts panel appears between the warping indicator and the input box. Its header shows the count, such as **2 queued**, with a chevron to collapse or expand the list. The panel is expanded by default, and prompts are listed from top (next to send) to bottom (last to send). + +Hovering a row reveals controls for that prompt: + +* **Reorder** - Drag a row up or down by its handle to change the order. The row at the top of the list always sends next. +* **Send now** - Click the up-arrow icon to send that prompt immediately instead of waiting for the agent to finish the current response. +* **Edit** - Click the pencil icon to edit the prompt inline. Press `Enter` to save your changes or `Esc` to cancel. +* **Delete** - Click the trash icon to remove the prompt from the queue. If the input is empty, Warp moves the deleted prompt into the input so you can revise and resend it. If the input already has text, the deleted prompt is discarded. + +
+![A queued prompt row showing the drag handle on the left and send now, edit, and delete controls on the right.](../../../../../assets/agent-platform/prompt-queueing-row-controls.png) +
A queued row with its send now, edit, and delete controls revealed on hover.
+
+ +Deleting the last prompt removes the panel, since the queue is now empty. + +## When sending pauses + +Queued prompts only continue after a response finishes successfully. If the response errors, is stopped, or is interrupted with `Ctrl+C`, Warp pauses the queue so you can review what should happen next. The queue stays intact, and no queued prompts are discarded. + +When sending pauses and you're viewing that conversation, Warp helps you pick up where you left off: + +* If the input box is empty, the first queued prompt is removed from the queue and its text is placed in the input so you can review and resend it. +* If the input box already has text, the queue is left untouched. + +Any remaining prompts stay in the panel so you can review, edit, reorder, or delete them. Sending resumes automatically the next time the conversation completes a response cleanly. + +## Prompt queueing with cloud agents + +Prompt queueing also works for [cloud agents](/agent-platform/cloud-agents/overview/), including while a cloud environment is still setting up. You can queue follow-up work before the agent is live, and Warp sends those prompts once the agent is ready and the current response finishes. + +For cloud agents, the prompt that started the run appears as a locked first row in the queue because it has already been accepted by the agent. You can't edit, reorder, or delete that first prompt, but any follow-up prompts queued behind it remain editable. + +
+![A cloud agent connecting to its host, with a locked initial prompt row and a tooltip reading 'The first cloud-mode prompt cannot be changed.'](../../../../../assets/agent-platform/prompt-queueing-cloud-locked-row.png) +
A cloud run's locked initial prompt during environment setup.
+
+ +While the environment is setting up, queued prompts wait until the cloud agent is live. After setup, the locked row is removed and the rest of the queue sends in order as each response completes. + +Because cloud conversations keep running after you leave the agent view, their queues continue to send in the background and are restored when you return. + +## Related pages + +* [Slash Commands](/agent-platform/capabilities/slash-commands/) - The full list of built-in commands, including `/queue`. +* [Terminal and Agent modes](/agent-platform/local-agents/interacting-with-agents/terminal-and-agent-modes/) - How input is routed between the terminal and the agent. +* [Cloud agents overview](/agent-platform/cloud-agents/overview/) - Run agents in the cloud from any trigger. diff --git a/src/sidebar.ts b/src/sidebar.ts index 6d741ab3..439c3cd7 100644 --- a/src/sidebar.ts +++ b/src/sidebar.ts @@ -277,6 +277,7 @@ export const sidebarTopics: StarlightSidebarTopicsUserConfig = [ items: [ { slug: 'agent-platform/local-agents/interacting-with-agents', label: 'Overview' }, 'agent-platform/local-agents/interacting-with-agents/terminal-and-agent-modes', + { slug: 'agent-platform/local-agents/interacting-with-agents/prompt-queueing', label: 'Prompt queueing' }, { slug: 'agent-platform/local-agents/interacting-with-agents/conversation-forking', label: 'Conversation forking' }, { slug: 'agent-platform/local-agents/code-diffs', label: 'Code diffs' }, 'agent-platform/local-agents/interacting-with-agents/voice',