pi-msg-queue

Adds a /q command to pi-coding-agent for sending quick follow-up messages to the agent without leaving the input line.

What you get

• /q <message> — sends the message as a follow-up (deliverAs: "followUp"), so it is processed after the current turn finishes instead of interrupting it.
• Input hygiene. The message is trimmed, and an empty message is rejected with a usage hint instead of being sent.
• Immediate feedback. A notification confirms the message was sent.

Quick start

While the agent is working, queue the next instruction:

/q continue with the next step

The message is delivered as a follow-up and processed once the current turn completes.

Installation

pi install npm:pi-msg-queue

From a local checkout:

pi install /path/to/pi-msg-queue

Usage

| Command | Description | | --- | --- | | /q <message> | Send <message> as a follow-up to the agent. |

Notes:

• The message is trimmed of leading and trailing whitespace before sending.
• An empty message shows Usage: /q <message> - sends a follow-up message to the agent and sends nothing.
• /q requires interactive (TUI) mode; outside the TUI it reports an error.
• If the message cannot be sent, an error notification is shown.

Troubleshooting

• "/q requires interactive mode." The command only works in the pi TUI, not in headless mode.
• The agent doesn't answer immediately. Follow-up messages are queued behind the current turn by design — the agent picks them up when the turn finishes.

Development

Requires Node.js ≥ 22.19 and npm.

npm install
npm test
npm run typecheck

Credits

• badlogic, pi-coding-agent and the command API

License

MIT