singularity-forge/docs/dev/what-is-pi/12-the-message-queue-talking-while-pi-thinks.md
Jeremy 872b0adb48 docs: reorganize into user-docs/ and dev/ subdirectories
Split flat docs/ into user-docs/ (guides, config, troubleshooting) and
dev/ (ADRs, architecture, extension guides, proposals). Updated
docs/README.md index to reflect new paths.
2026-04-10 09:25:31 -05:00

20 lines
1,015 B
Markdown

# The Message Queue — Talking While Pi Thinks
Pi doesn't make you wait for the agent to finish before sending more instructions. You can queue messages while the agent is streaming:
| Key | Behavior |
|-----|----------|
| **Enter** | Queue a **steering** message — delivered after current tool, interrupts remaining tools |
| **Alt+Enter** | Queue a **follow-up** message — delivered after agent finishes all work |
| **Escape** | Abort the agent and restore queued messages to editor |
| **Alt+Up** | Retrieve queued messages back to editor |
**Steering** is for course-correction: "Stop, do this instead." The message is delivered after the current tool finishes, but remaining tool calls in the LLM's response are skipped.
**Follow-up** is for chaining: "After you're done with that, also do this." The message waits until the agent has no more tool calls to make.
**Settings:**
- `steeringMode`: `"one-at-a-time"` (default) or `"all"` (deliver all queued at once)
- `followUpMode`: same options
---