pi-msg-queue

Pi extension: /q command to send quick follow-up messages to the agent

Packages

Package details

extension

Install pi-msg-queue from npm and Pi will load the resources declared by the package manifest.

$ pi install npm:pi-msg-queue
Package
pi-msg-queue
Version
1.0.2
Published
Aug 13, 2026
Downloads
240/mo · 10/wk
Author
yugimob
License
MIT
Types
extension
Size
4.6 KB
Dependencies
0 dependencies · 1 peer
Pi manifest JSON
{
  "extensions": [
    "./index.ts"
  ]
}

Security note

Pi packages can execute code and influence agent behavior. Review the source before installing third-party packages.

README

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