Skip to content

README.md

Latest commit

 

History

History
116 lines (92 loc) · 4.22 KB

README.md

File metadata and controls

116 lines (92 loc) · 4.22 KB

opencode-queue

npm version CI npm downloads

Queue OpenCode input until the current session is idle.

opencode-queue adds a real /queue slash command. It lets you type the next prompt, slash command, or shell command while an agent is still working, without interrupting the current run.

Install

Add the plugin to your OpenCode config:

{
  "plugin": ["opencode-queue"]
}

Restart OpenCode after installing. OpenCode installs npm plugins automatically at startup.

Quick Examples

/queue continue after this task
continue after this task /queue
/queue front do this next
do this next /queue front

/queue /review
/review /queue
/queue front /review
/review /queue front

/queue !ls
/queue front !pwd

/queue list
/queue stop
/queue start
/queue flush
/queue clear
/queue clear 1
/queue clear 2 3

Syntax

Input What it does
/queue message Queue a normal prompt.
message /queue Queue a normal prompt using trailing syntax.
/queue front message Queue a normal prompt before existing queued entries.
message /queue front Queue a normal prompt before existing queued entries using trailing syntax.
/queue /review Queue a slash command.
/review /queue Queue a slash command using trailing syntax.
/queue front /review Queue a slash command before existing queued entries.
/review /queue front Queue a slash command before existing queued entries using trailing syntax.
/queue !ls Queue an OpenCode shell block.
/queue front !ls Queue an OpenCode shell block before existing queued entries.
/queue Show the current queue.
/queue list Show the current queue.
/queue stop Pause automatic sending of queued entries.
/queue start Resume automatic sending of queued entries.
/queue flush Send all queued entries immediately.
/queue clear Clear the current queue.
/queue clear 1 Clear item 1 from the current queue.
/queue clear 2 3 Clear items 2 and 3 from the current queue.

Behavior

When the session is busy:

  • Queued entries are hidden from the transcript and from the running agent.
  • The current agent run keeps using its original agent, model, and thinking variant.
  • Queued entries replay in order after the session completes normally and becomes idle.
  • /queue front ... puts an entry before the existing queued entries.
  • Only one queued entry is sent per idle transition, so queued work runs one item at a time.
  • Queued entries are kept in place after an error or abort.
  • /queue stop pauses automatic replay without clearing queued entries, and /queue start resumes it.
  • /queue flush sends all queued entries immediately, even before the session is idle.

When the session is idle:

  • /queue message sends message immediately.
  • message /queue sends message immediately.
  • /queue /review runs /review immediately.
  • /review /queue runs /review immediately.
  • /queue !ls runs ls immediately as an OpenCode shell block.
  • /queue and /queue list show the current queue.
  • /queue stop pauses automatic replay, and /queue start resumes it.
  • /queue flush sends all queued entries immediately.
  • /queue clear clears the current queue, and /queue clear 1 clears a specific queued item.

Queue Management

/queue
/queue list
/queue stop
/queue start
/queue flush
/queue clear
/queue clear 1
/queue clear 2 3

The queue is in-memory and scoped to the current session.

Notes

  • This plugin registers /queue as a real OpenCode slash command.
  • It does not add a keyboard shortcut. OpenCode plugins cannot currently register custom TUI keybindings.
  • Queued placeholders are hidden instead of deleted, then filtered out before messages are sent to the model.
  • If plan mode asks to switch to the build agent while more queued work is waiting, the plugin answers No so the queue can continue.