{"id":45690,"library":"opencode-q","title":"opencode-q","description":"opencode-q is a prompt queue plugin for OpenCode (an AI coding assistant) that provides a web-based UI at http://localhost:4321 to manage per-session prompt queues. Developers can stage prompts, send them one-by-one, and track status (queued → pending → sent → done/failed) across multiple projects and sessions. v1.1.4 (latest) uses Bun and must be installed globally. It persists all state to disk, surviving OpenCode restarts. Unlike CLI-based prompts, this is a pure web interface with no TUI commands. Alternative to manually copying prompts or using OpenCode's built-in chat without queuing.","status":"active","version":"1.1.4","language":"javascript","source_language":"en","source_url":"https://github.com/dev3am/opencode-q","tags":["javascript","opencode","opencode-plugin","prompt-queue","ai","agent","task-queue","open-source"],"install":[{"cmd":"npm install opencode-q","lang":"bash","label":"npm"},{"cmd":"yarn add opencode-q","lang":"bash","label":"yarn"},{"cmd":"pnpm add opencode-q","lang":"bash","label":"pnpm"}],"dependencies":[{"reason":"Runtime dependency: OpenCode must be installed and running for the plugin to function","package":"opencode","optional":false}],"imports":[{"note":"The plugin is a global npm package; import is only for type definitions. The actual usage is via web UI after global install.","wrong":"const opencodeQ = require('opencode-q')","symbol":"default","correct":"import opencodeQ from 'opencode-q'"},{"note":"runQueue is an internal function, not meant to be called directly. Use the web UI.","wrong":"const { runQueue } = require('opencode-q')","symbol":"runQueue","correct":"import { runQueue } from 'opencode-q'"},{"note":"QueueStatus is a type, use type import for TypeScript.","wrong":"import { QueueStatus } from 'opencode-q'","symbol":"QueueStatus","correct":"import type { QueueStatus } from 'opencode-q'"}],"quickstart":{"code":"npm install -g opencode-q\n# Ensure OpenCode is running in at least one project\nopen http://localhost:4321\n# In browser, select project and session, then:\n# - Add prompts (they appear as 'queued')\n# - Click 'Send' to send each prompt one-by-one\n# - Track status: queued → pending → sent → done/failed\n# - Reorder, edit, delete queued items; retry failed ones","lang":"javascript","description":"Global install via npm, then open the web UI to manage prompt queues with per-session tracking."},"warnings":[{"fix":"Use npm install -g opencode-q instead of npm install opencode-q in a project.","message":"Must be installed globally (npm install -g). Local per-project install is not supported.","severity":"breaking","affected_versions":">=1.0.0"},{"fix":"Keep OpenCode open in at least one project. If stuck, restart OpenCode.","message":"Web UI only works while at least one OpenCode instance is running. If all instances are closed, http://localhost:4321 becomes unreachable.","severity":"gotcha","affected_versions":">=1.0.0"},{"fix":"Kill the process using port 4321 or configure OpenCode to use a different port (not directly supported yet).","message":"Port 4321 must be free. If another process uses it, the web UI fails to start.","severity":"gotcha","affected_versions":">=1.0.0"},{"fix":"Use a single OpenCode instance per project to keep session queues consistent.","message":"Session queues are independent per OpenCode instance. Reopening the same project in a new instance creates a separate queue.","severity":"gotcha","affected_versions":">=1.0.0"}],"env_vars":null,"search_vec":"'4321':27 'across':52 'agent':114 'ai':15,113 'altern':90 'assist':17 'base':23,78 'built':100 'built-in':99 'bun':60 'chat':102 'cli':77 'cli-bas':76 'code':16 'command':89 'copi':93 'develop':35 'disk':71 'done/failed':51 'global':65 'instal':64 'interfac':85 'javascript':105 'latest':58 'localhost':26 'manag':29 'manual':92 'multipl':53 'must':62 'one':42,44 'one-by-on':41 'open':119 'open-sourc':118 'opencod':2,5,13,73,97,106,108 'opencode-plugin':107 'opencode-q':1,4 'pend':49 'per':31 'per-sess':30 'persist':67 'plugin':11,109 'project':54 'prompt':9,33,38,79,94,111 'prompt-queu':110 'provid':19 'pure':83 'q':3,6 'queu':48,104 'queue':10,34,112,117 'restart':74 'send':39 'sent':50 'session':32,56 'sourc':120 'stage':37 'state':69 'status':47 'surviv':72 'task':116 'task-queu':115 'track':46 'tui':88 'ui':24 'unlik':75 'use':59,96 'v1.1.4':57 'web':22,84 'web-bas':21 'without':103","created_at":"2026-06-07T12:56:14.685477+00:00","updated_at":"2026-06-07T12:56:14.685477+00:00","problems":[{"fix":"Run with sudo: sudo npm install -g opencode-q","cause":"Global install without sudo on macOS/Linux.","error":"Error: EACCES: permission denied, mkdir '/usr/local/lib/node_modules/opencode-q'"},{"fix":"Do not import opencode-q directly in Node.js. Only use it via OpenCode.","cause":"OpenCode requires Bun runtime to run plugins. The plugin is run inside OpenCode's Bun context, but if you try to import directly in Node.js, it fails.","error":"ReferenceError: Bun is not defined"},{"fix":"Run npm install -g opencode-q","cause":"Plugin not installed globally.","error":"Cannot find module 'opencode-q'"}],"ecosystem":"npm","meta_description":null,"install_score":null,"quickstart_score":null,"quickstart_tag":null,"pypi_latest":null,"cli_name":null,"cli_version":null,"type":"library","homepage":"https://github.com/dev3am/opencode-q#readme","github":"https://github.com/dev3am/opencode-q","docs":null,"changelog":null,"pypi":null,"npm":"opencode-q","openapi_spec":null,"status_page":null,"smithery":null,"categories":["ai-ml","productivity"],"base_url":null,"auth_type":null,"provenance":{"verified_status":null,"verified_at":null,"last_verified":"2026-06-07","next_check":"2026-09-05","install_tag":null}}