Skip to content

Commit 3ee9146

Browse files
docs(message-queueing): clarify queued-message implicit approval (even if auto-approval is off) (#345)
Changes: - Overview and How It Works now state that processing a queued message implicitly approves the next action. - Warning block clarifies distinction from settings-based Auto-Approving Actions. - FAQ entry added: “Why are my queued messages triggering auto-approval?” with guidance and link to Auto-Approving Actions. Rationale: Prevents surprises; documents critical behavior that affects safety and workflow control.
1 parent d5bf1b4 commit 3ee9146

File tree

1 file changed

+12
-4
lines changed

1 file changed

+12
-4
lines changed

docs/features/message-queueing.md

Lines changed: 12 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -23,7 +23,7 @@ No more waiting! Type your follow-up thoughts, corrections, or additional reques
2323

2424
## Overview
2525

26-
Message queueing lets you type and send messages while Roo is still working. Just type your message and hit Enter - it gets queued and will be processed as soon as Roo is ready for your next input, right before it would typically ask for an approval. This feature is particularly useful for quick corrections or additions to your request.
26+
Message queueing lets you type and send messages while Roo is still working. Just type your message and hit Enter - it gets queued and will be processed as soon as Roo is ready for your next input. When a queued message is processed, Roo implicitly approves whatever would normally require your confirmation (tool calls, file writes, running commands)—even if auto-approval is disabled. This is useful for quick corrections or additions when you want to keep work moving without manual prompts.
2727

2828
---
2929

@@ -34,7 +34,7 @@ While Roo is working:
3434
1. **Type your message** as normal
3535
2. **Press Enter** or click Send
3636
3. **Message gets queued** and appears with "Queued Messages:" label
37-
4. **Roo processes the queued message** as soon as it's ready for your next input, right before it would typically ask for an approval
37+
4. **Roo processes the queued message** as soon as it's ready for your next input and implicitly approves the next pending action (e.g., a tool call, file write, or command)—even if auto-approval is disabled
3838

3939
<img src="/img/message-queueing/message-queueing.png" alt="Message queueing interface showing active processing and three queued messages" width="800" />
4040

@@ -46,8 +46,10 @@ While Roo is working:
4646

4747
The input field stays active so you can type anytime - just hit Enter to queue your message.
4848

49-
:::warning Interacting with Queued Messages
50-
Editing or deleting a queued message requires clicking on it before it's processed. If you have auto-approval enabled, the time to do this may be very short or non-existent, as the queued message and the next action can be processed almost instantly. For workflows where you anticipate needing to edit queued messages, consider temporarily disabling auto-approval.
49+
:::warning Queued Messages Implicitly Approve
50+
Queued messages act as approval for the next action. When a queued message is processed, Roo proceeds with whatever would normally require confirmation (tool calls, file writes, running commands)—even if auto-approval is disabled.
51+
Editing or deleting a queued message requires clicking it before it's processed. In fast workflows this window can be extremely short; if you need a manual review step, avoid queueing until you're ready to approve.
52+
Note: This behavior is distinct from [Auto-Approving Actions](/features/auto-approving-actions) and is not controlled by its settings.
5153
:::
5254

5355

@@ -61,6 +63,12 @@ A: There is no hard limit on the number of messages you can queue. The queue siz
6163
**Q: Can I reorder queued messages?**
6264
A: No, messages are always processed in the order they were sent (FIFO).
6365

66+
**Q: Do queued messages require approval?**
67+
A: No. When processed, a queued message implicitly approves the next pending action (tool calls, file writes, running commands), even if auto-approval is disabled. If you need a manual review step, do not queue the message; wait for the approval prompt and confirm manually.
68+
69+
**Q: Why are my queued messages triggering auto-approval?**
70+
A: This isn’t the Auto-Approving Actions setting. Queueing a message tells Roo to proceed without pausing for confirmations, so the queued message implicitly approves the next action. To avoid this, don’t queue when you need a manual review—wait for the approval prompt and confirm manually. See [Auto-Approving Actions](/features/auto-approving-actions) for settings-based approvals.
71+
6472
**Q: What happens if Roo encounters an error?**
6573
A: Queued messages remain in the queue. You can choose to cancel them or let processing continue.
6674

0 commit comments

Comments
 (0)