@matheusbbarni/pi-message-queue

A Pi extension that keeps a session-local FIFO queue of user messages and sends them to the agent one at a time.

Pi already has native steering/follow-up keys in recent versions. This package adds an explicit, persistent queue with slash commands, a footer status, and an optional queue widget.

Install / run

From this repository:

pi -e ./index.ts

Install from npm:

pi install npm:@matheusbbarni/pi-message-queue

Or install it as a local Pi package:

pi install ./pi-message-queue

Commands

Command	What it does
/queue <message>	Append a message to the queue.
/queue add <message>	Append a message to the queue.
/q <message>	Short alias for /queue add.
/queue next <message>	Put a message at the front of the queue.
/queue list	Show pending messages.
/queue remove <n>	Remove the 1-based queue position.
/queue remove #<id>	Remove by message id.
/queue edit-last	Pull the last queued message back into the editor.
/queue pause	Stop dispatching new queued messages.
/queue resume	Resume dispatching.
/queue clear	Clear all pending messages.
/queue show / /queue hide	Toggle the below-editor queue widget.
/queue help	Show a compact help summary.

Shortcut:

• Ctrl+Shift+Q queues the current editor text and clears the editor.
• Shift+Left pulls the last queued message back into the editor for editing.

Behavior

• Queued messages are shown in a compact below-editor widget similar to Pi's built-in follow-up queue display.
• Ordinary user messages and slash commands submitted while Pi is working are captured into this persistent queue instead of Pi's native steering/follow-up queue.
• Skill invocations such as /skill:git-commit feat and prompt templates are expanded when dispatched.
• Typing /new or /reload while Pi is working also queues those commands instead of showing Pi's built-in wait warning.
• Queued messages are sent only when Pi is idle and there are no native Pi pending messages.
• Queued /new and /reload entries run Pi's built-in commands instead of being sent to the agent as prompt text.
• After a queued message completes, the next queued message is sent automatically.
• Queue state is stored as custom session entries, so it survives /reload, session resume, and tree navigation on the active branch.
• Custom state entries do not participate in LLM context.

Package shape

Pi discovers the extension through package.json:

{
  "pi": {
    "extensions": ["index.ts"]
  }
}

Development

npm install
npm run typecheck