opencode-q 1.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 dev3am
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.ja.md

@@ -0,0 +1,73 @@
+# opencode-q
+
+**OpenCode用プロンプトキュープラグイン** — OpenCode を起動し `http://localhost:4321` を開いて、セッションごとのプロンプトキューを ToDo リストのように管理します。プロンプトを事前に積んでおき、AI に1つずつ送信し、ステータスをリアルタイムで追跡します。
+
+[English](https://github.com/dev3am/opencode-q/blob/main/README.md) | [한국어](https://github.com/dev3am/opencode-q/blob/main/README.ko.md) | [中文](https://github.com/dev3am/opencode-q/blob/main/README.zh.md)
+
+---
+
+## 何ができるか
+
+opencode-q は **Web 専用** の OpenCode プラグインです。CLI も TUI コマンドもありません — すべて1つの Web UI から操作します。
+
+- **すべてのプロジェクトを1つの Web で** — `http://localhost:4321` に、起動中のすべての OpenCode インスタンスが集まります。
+- **プロジェクト別・セッション別のキュー** — 各会話(セッション)が独立したキューを持ちます。
+- **ToDo スタイルのステータス追跡** — 各項目は `queued → pending → sent → done`(または `failed`)を経ます。
+- **手動・1つずつ** — キューのプロンプトを明示的に送信し、前のものが終わってから次を送ります。常にユーザーが流れを制御します。
+- キュー項目の **並び替え・編集・削除**、失敗項目の **再送信**。
+- **堅牢な設計** — すべての状態をディスクに保存するため、OpenCode のウィンドウが開閉してもシステムは動作し続けます。
+
+## インストール
+
+### 前提条件
+
+- [OpenCode](https://opencode.ai) 1.x([Bun](https://bun.sh) 上で動作し、プラグインも Bun を使用します)
+
+### npm
+
+```bash
+npm install -g opencode-q
+```
+
+インストール時に postinstall ステップで自動的に `~/.config/opencode/plugins/` に登録されます。OpenCode を再起動するだけで使用できます。
+
+> **注意:** プラグインはグローバルパス(`~/.config/opencode/plugins/`)に登録されるため、グローバルインストール(`-g`)が必要です。プロジェクト単位のインストールはサポートされていません。
+
+## 使い方
+
+1. 任意のプロジェクトで OpenCode を起動します(複数のプロジェクトで同時に起動しても構いません)。
+2. ブラウザで **`http://localhost:4321`** を開きます。
+3. サイドバーでプロジェクトを選び、セッションタブを選択して:
+   - プロンプトを **追加** — `queued` として表示されます。
+   - キュー項目を **送信** — `pending` → AI 作業中は `sent` → AI 完了時に `done` に変わります。送信中の項目があるとボタンが無効になり、プロンプトが重なりません。
+   - キュー項目の **並び替え**(ドラッグ)・**編集**・**削除**。
+   - 項目が `failed` になったら **再送信** をクリックします。
+
+OpenCode インスタンスが起動していないプロジェクトは **オフライン**(グレー表示)になり、キューは保持され、再起動時にそのまま残ります。
+
+## Web UI の概要
+
+| 要素 | 用途 |
+|------|------|
+| サイドバー | 起動中のすべてのプロジェクト(オフラインはグレー) |
+| セッションタブ | プロジェクトのセッション間を切り替え |
+| ステータスバッジ | 項目ごとの `queued` / `pending` / `sent` / `done` / `failed` |
+| 送信 / 再送信 | キュー項目の送信、失敗項目の再試行(セッションごとに1つずつ) |
+
+Web サーバーはプラグインのロード時に自動起動し、常にポート `4321` を使用します。
+
+## トラブルシューティング
+
+- OpenCode インスタンスが1つ以上起動しているか確認してください — Web UI はプラグインが提供するため、OpenCode が起動しているときのみ `http://localhost:4321` にアクセスできます。
+- ページが開かない場合、他のプログラムがすでにポート `4321` を使用していないか確認してください。
+- バグを見つけましたか? 再現手順を添えて [GitHub Issue](https://github.com/dev3am/opencode-q/issues) を開いていただけると大変助かります。
+
+## アーキテクチャ
+
+opencode-q は **ディスクを唯一の信頼できる情報源** として使用します。各 OpenCode インスタンスがプラグインをロードし、ポート `4321` を確保したインスタンスが(ステートレスな)Web UI を提供し、各インスタンスは自身のセッションのキュープロンプトを実行します。プロセス間のネットワークコールバックがないため、どのインスタンスが起動・終了しても他に影響しません。
+
+開発セットアップと詳細は [CONTRIBUTING.md](https://github.com/dev3am/opencode-q/blob/main/CONTRIBUTING.md) を参照してください。
+
+## ライセンス
+
+MIT

package/README.ko.md

@@ -0,0 +1,73 @@
+# opencode-q
+
+**OpenCode용 프롬프트 큐 플러그인** — OpenCode를 실행하고 `http://localhost:4321`에 접속해, 세션별 프롬프트 큐를 할 일 목록처럼 관리합니다. 프롬프트를 미리 쌓아두고 AI에게 하나씩 전송하며, 상태를 실시간으로 추적합니다.
+
+[English](https://github.com/dev3am/opencode-q/blob/main/README.md) | [日本語](https://github.com/dev3am/opencode-q/blob/main/README.ja.md) | [中文](https://github.com/dev3am/opencode-q/blob/main/README.zh.md)
+
+---
+
+## 무엇을 하나요
+
+opencode-q는 **웹 전용** OpenCode 플러그인입니다. CLI도, TUI 명령어도 없습니다 — 모든 조작은 하나의 웹 UI에서 합니다.
+
+- **모든 프로젝트를 한 웹에서** — `http://localhost:4321`에 실행 중인 모든 OpenCode 인스턴스가 한곳에 모입니다.
+- **프로젝트별·세션별 큐** — 각 대화(세션)가 독립된 큐를 가집니다.
+- **할 일 스타일 상태 추적** — 모든 항목은 `queued → pending → sent → done`(또는 `failed`)을 거칩니다.
+- **수동·한 번에 하나** — 큐에 쌓인 프롬프트를 직접 전송하고, 이전 것이 끝나야 다음을 보냅니다. 항상 사용자가 흐름을 제어합니다.
+- 큐 항목 **순서 변경·편집·삭제**, 실패 항목 **재전송**.
+- **견고한 설계** — 모든 상태가 디스크에 저장되어, OpenCode 창이 열리고 닫혀도 시스템이 계속 동작합니다.
+
+## 설치
+
+### 필수 조건
+
+- [OpenCode](https://opencode.ai) 1.x ([Bun](https://bun.sh) 위에서 동작하며 플러그인도 Bun을 사용합니다)
+
+### npm
+
+```bash
+npm install -g opencode-q
+```
+
+설치 시 postinstall 단계에서 자동으로 `~/.config/opencode/plugins/`에 등록됩니다. OpenCode를 재시작하면 바로 사용 가능합니다.
+
+> **참고:** 플러그인이 전역 경로(`~/.config/opencode/plugins/`)에 등록되므로 반드시 글로벌 설치(`-g`)가 필요합니다. 프로젝트별 설치는 지원하지 않습니다.
+
+## 사용법
+
+1. 아무 프로젝트에서 OpenCode를 실행합니다 (여러 프로젝트에서 동시에 실행해도 됩니다).
+2. 브라우저에서 **`http://localhost:4321`**을 엽니다.
+3. 사이드바에서 프로젝트를 고르고, 세션 탭을 선택한 뒤:
+   - 프롬프트 **추가** — `queued` 상태로 나타납니다.
+   - 큐 항목 **전송** — `pending` → AI 작업 중 `sent` → AI 완료 시 `done`으로 바뀝니다. 전송 중인 항목이 있으면 보내기 버튼이 비활성화되어 프롬프트가 겹치지 않습니다.
+   - 큐 항목 **순서 변경**(드래그)·**편집**·**삭제**.
+   - 항목이 `failed`가 되면 **재전송**을 누릅니다.
+
+OpenCode 인스턴스가 더 이상 실행 중이지 않은 프로젝트는 **오프라인**(회색)으로 표시되며, 큐는 보존되어 재시작 시 그대로 남아 있습니다.
+
+## 웹 UI 한눈에 보기
+
+| 요소 | 용도 |
+|------|------|
+| 사이드바 | 실행 중인 모든 프로젝트 (오프라인은 회색) |
+| 세션 탭 | 프로젝트의 세션 간 전환 |
+| 상태 배지 | 항목별 `queued` / `pending` / `sent` / `done` / `failed` |
+| 보내기 / 재전송 | 큐 항목 전송, 실패 항목 재시도 (세션당 한 번에 하나) |
+
+웹 서버는 플러그인이 로드될 때 자동으로 시작되며, 항상 `4321` 포트를 사용합니다.
+
+## 문제 해결
+
+- OpenCode 인스턴스가 하나 이상 실행 중인지 확인하세요 — 웹 UI는 플러그인이 제공하므로 OpenCode가 켜져 있을 때만 `http://localhost:4321`에 접속할 수 있습니다.
+- 페이지가 안 열리면, 다른 프로그램이 `4321` 포트를 이미 쓰고 있지 않은지 확인하세요.
+- 버그를 발견하셨나요? 재현 단계와 함께 [GitHub Issue](https://github.com/dev3am/opencode-q/issues)를 열어주시면 큰 도움이 됩니다.
+
+## 아키텍처
+
+opencode-q는 **디스크를 유일한 진실원**으로 사용합니다. 각 OpenCode 인스턴스가 플러그인을 로드하고, `4321` 포트를 잡은 인스턴스가 (무상태) 웹 UI를 제공하며, 각 인스턴스는 자기 세션의 큐 프롬프트를 실행합니다. 프로세스 간 네트워크 콜백이 없어, 어떤 인스턴스가 켜지고 꺼지든 나머지에 영향을 주지 않습니다.
+
+개발 설정 및 상세 내용은 [CONTRIBUTING.md](https://github.com/dev3am/opencode-q/blob/main/CONTRIBUTING.md)를 참조하세요.
+
+## 라이선스
+
+MIT

package/README.md

@@ -0,0 +1,77 @@
+# opencode-q
+
+<p align="center">
+  <img src="https://raw.githubusercontent.com/dev3am/opencode-q/main/assets/readme_hero_pixel.png" alt="opencode-q" width="600" />
+</p>
+
+**Prompt queue plugin for OpenCode** — run OpenCode, open `http://localhost:4321`, and manage a per-session prompt queue like a todo list: stage prompts ahead of time and send them to the AI one at a time, with live status tracking.
+
+[한국어](https://github.com/dev3am/opencode-q/blob/main/README.ko.md) | [日本語](https://github.com/dev3am/opencode-q/blob/main/README.ja.md) | [中文](https://github.com/dev3am/opencode-q/blob/main/README.zh.md)
+
+---
+
+## What it does
+
+opencode-q is a **web-only** OpenCode plugin. There is no CLI and there are no TUI commands — you drive everything from one web UI.
+
+- **One web UI for every project** at `http://localhost:4321` — all running OpenCode instances show up in one place.
+- **Per-project, per-session queues** — each conversation (session) has its own independent queue.
+- **Todo-style status tracking** — every item moves through `queued → pending → sent → done` (or `failed`).
+- **Manual, one at a time** — you send a queued prompt explicitly; the next one is sent only after the previous finishes. You stay in control.
+- **Reorder, edit, delete** queued items; **resend** failed ones.
+- **Robust by design** — all state lives on disk, so the system keeps working even as OpenCode windows open and close.
+
+## Installation
+
+### Prerequisites
+
+- [OpenCode](https://opencode.ai) 1.x (it runs on [Bun](https://bun.sh), which the plugin uses too)
+
+### npm
+
+```bash
+npm install -g opencode-q
+```
+
+The plugin auto-installs to `~/.config/opencode/plugins/` via a postinstall step. Restart OpenCode and it works.
+
+> **Note:** Global install (`-g`) is required because the plugin registers globally at `~/.config/opencode/plugins/`. Per-project install is not supported.
+
+## Usage
+
+1. Start OpenCode in any project (start it in several projects if you like).
+2. Open **`http://localhost:4321`** in your browser.
+3. In the sidebar, pick a project; pick a session tab; then:
+   - **Add** a prompt — it appears as `queued`.
+   - **Send** a queued prompt — it goes to `pending`, then `sent` while the AI works, then `done` when the AI finishes. Send is disabled while an item is in flight, so prompts never overlap.
+   - **Reorder** (drag), **edit**, or **delete** queued items.
+   - If an item ends up `failed`, click **resend**.
+
+Projects whose OpenCode instance is no longer running are shown as **offline** (greyed out); their queues are preserved for when you restart.
+
+## Web UI at a glance
+
+| Element | Purpose |
+|---------|---------|
+| Sidebar | All running projects (offline ones greyed) |
+| Session tabs | Switch between a project's sessions |
+| Status badge | `queued` / `pending` / `sent` / `done` / `failed` per item |
+| Send / Resend | Dispatch a queued item, or retry a failed one (one at a time per session) |
+
+The web server starts automatically when the plugin loads. It always listens on port `4321`.
+
+## Troubleshooting
+
+- Make sure at least one OpenCode instance is running — the web UI is served by the plugin, so `http://localhost:4321` is only available while OpenCode is open.
+- If the page does not load, confirm nothing else on your machine is already using port `4321`.
+- Found a bug? Please open a [GitHub Issue](https://github.com/dev3am/opencode-q/issues) with steps to reproduce — it helps a lot.
+
+## Architecture
+
+opencode-q uses **disk as the single source of truth**. Each OpenCode instance loads the plugin; whichever instance grabs port `4321` serves the (stateless) web UI, and every instance executes the queued prompts for its own sessions. There are no cross-process network callbacks, so any instance can come and go without breaking the others.
+
+For development setup and details, see [CONTRIBUTING.md](https://github.com/dev3am/opencode-q/blob/main/CONTRIBUTING.md).
+
+## License
+
+MIT

package/README.zh.md

@@ -0,0 +1,73 @@
+# opencode-q
+
+**OpenCode 的提示队列插件** — 运行 OpenCode，打开 `http://localhost:4321`，像管理待办清单一样管理每个会话的提示队列：提前暂存提示，逐个发送给 AI，并实时追踪状态。
+
+[English](https://github.com/dev3am/opencode-q/blob/main/README.md) | [한국어](https://github.com/dev3am/opencode-q/blob/main/README.ko.md) | [日本語](https://github.com/dev3am/opencode-q/blob/main/README.ja.md)
+
+---
+
+## 它能做什么
+
+opencode-q 是一个 **纯 Web** 的 OpenCode 插件。没有 CLI，也没有 TUI 命令 — 所有操作都在一个 Web UI 中完成。
+
+- **一个 Web 管理所有项目** — `http://localhost:4321` 汇集所有正在运行的 OpenCode 实例。
+- **按项目、按会话的队列** — 每个对话（会话）拥有独立的队列。
+- **待办式状态追踪** — 每个项目经历 `queued → pending → sent → done`（或 `failed`）。
+- **手动、逐个发送** — 显式发送队列中的提示，上一个完成后才发送下一个。始终由用户掌控流程。
+- 队列项目的 **重新排序、编辑、删除**，失败项目的 **重新发送**。
+- **稳健的设计** — 所有状态保存在磁盘上，因此即使 OpenCode 窗口开关，系统也能持续工作。
+
+## 安装
+
+### 前提条件
+
+- [OpenCode](https://opencode.ai) 1.x（运行于 [Bun](https://bun.sh) 之上，插件也使用 Bun）
+
+### npm
+
+```bash
+npm install -g opencode-q
+```
+
+安装时通过 postinstall 步骤自动注册到 `~/.config/opencode/plugins/`。重启 OpenCode 即可使用。
+
+> **注意：** 由于插件注册到全局路径（`~/.config/opencode/plugins/`），因此必须使用全局安装（`-g`）。不支持按项目安装。
+
+## 使用方法
+
+1. 在任意项目中启动 OpenCode（也可以在多个项目中同时启动）。
+2. 在浏览器中打开 **`http://localhost:4321`**。
+3. 在侧边栏选择项目，选择会话标签，然后：
+   - **添加** 提示 — 显示为 `queued`。
+   - **发送** 队列项目 — 变为 `pending` → AI 工作时为 `sent` → AI 完成时为 `done`。有项目正在发送时按钮会被禁用，避免提示重叠。
+   - 队列项目的 **重新排序**（拖拽）、**编辑**、**删除**。
+   - 项目变为 `failed` 时，点击 **重新发送**。
+
+OpenCode 实例已不再运行的项目会显示为 **离线**（灰色），其队列会被保留，重启时仍然存在。
+
+## Web UI 一览
+
+| 元素 | 用途 |
+|------|------|
+| 侧边栏 | 所有正在运行的项目（离线为灰色） |
+| 会话标签 | 在项目的会话间切换 |
+| 状态徽章 | 每个项目的 `queued` / `pending` / `sent` / `done` / `failed` |
+| 发送 / 重新发送 | 发送队列项目，重试失败项目（每个会话一次一个） |
+
+Web 服务器在插件加载时自动启动，始终使用端口 `4321`。
+
+## 问题排查
+
+- 确认至少有一个 OpenCode 实例正在运行 — Web UI 由插件提供，因此只有在 OpenCode 打开时才能访问 `http://localhost:4321`。
+- 如果页面无法打开，请确认没有其他程序已占用端口 `4321`。
+- 发现 Bug？请附上复现步骤开一个 [GitHub Issue](https://github.com/dev3am/opencode-q/issues)，这会很有帮助。
+
+## 架构
+
+opencode-q 以 **磁盘作为唯一可信来源**。每个 OpenCode 实例加载插件，抢到端口 `4321` 的实例提供（无状态的）Web UI，每个实例执行自身会话的队列提示。进程间没有网络回调，因此任何实例的启动或关闭都不会影响其他实例。
+
+开发设置和详细信息请参阅 [CONTRIBUTING.md](https://github.com/dev3am/opencode-q/blob/main/CONTRIBUTING.md)。
+
+## 许可证
+
+MIT

package/dist/cli.js

@@ -0,0 +1,296 @@
+#!/usr/bin/env bun
+// @bun
+var __create = Object.create;
+var __getProtoOf = Object.getPrototypeOf;
+var __defProp = Object.defineProperty;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __toESM = (mod, isNodeMode, target) => {
+  target = mod != null ? __create(__getProtoOf(mod)) : {};
+  const to = isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target;
+  for (let key of __getOwnPropNames(mod))
+    if (!__hasOwnProp.call(to, key))
+      __defProp(to, key, {
+        get: () => mod[key],
+        enumerable: true
+      });
+  return to;
+};
+var __require = import.meta.require;
+
+// cli/index.ts
+import * as http from "http";
+
+// src/constants.ts
+var PREVIEW_LENGTH = 50;
+var DEFAULT_PORT = 4321;
+
+// cli/index.ts
+var args = process.argv.slice(2);
+function parseFlag(args2, flag, shortFlag) {
+  const rest = [];
+  let value = null;
+  for (let i = 0;i < args2.length; i++) {
+    if (args2[i] === flag || args2[i] === shortFlag) {
+      value = args2[i + 1] || null;
+      i++;
+    } else {
+      rest.push(args2[i]);
+    }
+  }
+  return { value, rest };
+}
+var { value: projectPath, rest: rest1 } = parseFlag(args, "--project", "-p");
+var { value: rawSession, rest: positional } = parseFlag(rest1, "--session", "-s");
+var baseDir = projectPath || process.cwd();
+var sessionId = rawSession || "default";
+var serverPort = parseInt(process.env.OPENCODE_Q_PORT || String(DEFAULT_PORT), 10);
+function request2(method, path, body) {
+  return new Promise((resolve, reject) => {
+    const bodyStr = body !== undefined ? JSON.stringify(body) : undefined;
+    const opts = {
+      hostname: "127.0.0.1",
+      port: serverPort,
+      path,
+      method,
+      headers: { "Content-Type": "application/json" }
+    };
+    if (bodyStr)
+      opts.headers["Content-Length"] = Buffer.byteLength(bodyStr);
+    const req = http.request(opts, (res) => {
+      const chunks = [];
+      res.on("data", (chunk) => chunks.push(chunk));
+      res.on("end", () => {
+        const text = Buffer.concat(chunks).toString();
+        try {
+          resolve({ status: res.statusCode || 200, json: JSON.parse(text) });
+        } catch {
+          resolve({ status: res.statusCode || 200, json: text });
+        }
+      });
+    });
+    req.on("error", reject);
+    if (bodyStr)
+      req.write(bodyStr);
+    req.end();
+  });
+}
+function projectBase() {
+  return `/api/projects/${encodeURIComponent(baseDir)}`;
+}
+function queueBase() {
+  return `${projectBase()}/queue/${sessionId}`;
+}
+function showHelp() {
+  console.log(`opencode-q \u2014 Prompt queue manager for OpenCode
+
+Usage:
+  opencode-q add <text> [-p <path>] [-s <id>]     Add prompt
+  opencode-q list [-p <path>] [-s <id>]            List queue
+  opencode-q remove <id> [-p <path>] [-s <id>]     Remove by ID
+  opencode-q clear [-p <path>] [-s <id>]           Clear queue
+  opencode-q reorder <from> <to> [-p <path>] [-s <id>]  Reorder (1-based)
+  opencode-q peek [-p <path>] [-s <id>]            Show next prompt
+  opencode-q next [-p <path>] [-s <id>]            Execute next (dequeue)
+  opencode-q sessions [-p <path>]                  List sessions
+  opencode-q projects                              List active projects
+  opencode-q logs                                  Show error logs
+  opencode-q help                                  Show this help
+
+Options:
+  --project, -p <path>   Target project directory (default: cwd)
+  --session, -s <id>     Target session ID (default: "default")
+
+Environment:
+  OPENCODE_Q_PORT   Server port (default: 4321)`);
+}
+async function requireServer() {
+  try {
+    await request2("GET", "/api/projects");
+    return true;
+  } catch {
+    console.error(`Error: opencode-q server is not running on port ${serverPort}`);
+    console.error(`Start OpenCode first, or the server will auto-start when a plugin loads.`);
+    return false;
+  }
+}
+var command = positional[0];
+async function main() {
+  switch (command) {
+    case "projects": {
+      if (!await requireServer())
+        return;
+      const res = await request2("GET", "/api/projects");
+      if (res.json.projects.length === 0) {
+        console.log("No active projects");
+        return;
+      }
+      for (const p of res.json.projects) {
+        const name = p.baseDir.split("/").pop() || p.baseDir;
+        const sessions = p.sessions.map((s) => `${s.sessionId} (${s.status})`).join(", ");
+        console.log(`  ${name} \u2014 ${p.baseDir} [${sessions}]`);
+      }
+      return;
+    }
+    case "logs": {
+      const { homedir } = await import("os");
+      const { join } = await import("path");
+      const { existsSync, readFileSync } = await import("fs");
+      const logFile = join(homedir(), ".config", "opencode", "opencode-q-errors.log");
+      if (!existsSync(logFile)) {
+        console.log("No error logs found.");
+        return;
+      }
+      const raw = readFileSync(logFile, "utf-8").trim();
+      if (!raw) {
+        console.log("No error logs found.");
+        return;
+      }
+      const logs = raw.split(`
+`);
+      console.log(`--- Error Logs (${logs.length} entries) ---`);
+      for (const line of logs) {
+        if (!line)
+          continue;
+        try {
+          const entry = JSON.parse(line);
+          console.log(`[${entry.timestamp}] Project: ${entry.project || "none"}`);
+          console.log(`Message: ${entry.message}`);
+          if (entry.stack) {
+            console.log(`Stack:
+${entry.stack.split(`
+`).slice(0, 5).join(`
+`)}`);
+          }
+          console.log("-".repeat(40));
+        } catch {
+          console.log(line);
+        }
+      }
+      return;
+    }
+    case "add": {
+      if (!await requireServer())
+        return;
+      const text = positional.slice(1).join(" ");
+      if (!text) {
+        console.error("Error: prompt text required");
+        process.exit(1);
+      }
+      const res = await request2("POST", queueBase(), { text });
+      if (res.status !== 201) {
+        console.error(`Error: ${res.json.error}`);
+        process.exit(1);
+      }
+      console.log(`Added #${res.json.item.id} [project: ${baseDir.split("/").pop()}, session: ${sessionId}]`);
+      return;
+    }
+    case "list": {
+      if (!await requireServer())
+        return;
+      const res = await request2("GET", queueBase());
+      if (res.json.items.length === 0) {
+        console.log(`Queue is empty [session: ${sessionId}]`);
+        return;
+      }
+      console.log(`Project: ${baseDir.split("/").pop()} | Session: ${sessionId}`);
+      for (let i = 0;i < res.json.items.length; i++) {
+        const item = res.json.items[i];
+        const preview = item.text.length > PREVIEW_LENGTH ? item.text.slice(0, PREVIEW_LENGTH) + "..." : item.text;
+        console.log(`${i + 1}. [${item.id}] ${preview}`);
+      }
+      return;
+    }
+    case "remove": {
+      if (!await requireServer())
+        return;
+      const id = positional[1];
+      if (!id) {
+        console.error("Error: ID required");
+        process.exit(1);
+      }
+      const res = await request2("DELETE", `${queueBase()}/${id}`);
+      if (res.status !== 200) {
+        console.error(`Not found (${id})`);
+        process.exit(1);
+      }
+      console.log(`Removed (${id}) [session: ${sessionId}]`);
+      return;
+    }
+    case "clear": {
+      if (!await requireServer())
+        return;
+      await request2("DELETE", queueBase());
+      console.log(`Queue cleared [session: ${sessionId}]`);
+      return;
+    }
+    case "reorder": {
+      if (!await requireServer())
+        return;
+      const from = parseInt(positional[1], 10);
+      const to = parseInt(positional[2], 10);
+      if (isNaN(from) || isNaN(to)) {
+        console.error("Error: from and to positions required (numbers)");
+        process.exit(1);
+      }
+      const res = await request2("PATCH", `${queueBase()}/reorder`, { from, to });
+      if (res.status !== 200) {
+        console.error(`Error: ${res.json.error}`);
+        process.exit(1);
+      }
+      console.log(`Reordered [session: ${sessionId}]:`);
+      for (let i = 0;i < res.json.items.length; i++)
+        console.log(`  ${i + 1}. [${res.json.items[i].id}]`);
+      return;
+    }
+    case "peek": {
+      if (!await requireServer())
+        return;
+      const listRes = await request2("GET", queueBase());
+      if (listRes.json.items.length === 0) {
+        console.log(`Queue is empty [session: ${sessionId}]`);
+        return;
+      }
+      const item = listRes.json.items[0];
+      console.log(`[${item.id}] ${item.text} [session: ${sessionId}]`);
+      return;
+    }
+    case "next": {
+      if (!await requireServer())
+        return;
+      const res = await request2("POST", `${queueBase()}/next`);
+      if (!res.json.executed) {
+        console.log(`Queue is empty [session: ${sessionId}]`);
+        return;
+      }
+      console.log(res.json.item.text);
+      return;
+    }
+    case "sessions": {
+      if (!await requireServer())
+        return;
+      const projRes = await request2("GET", projectBase());
+      const data = projRes.json;
+      if (data.sessions) {
+        for (const s of data.sessions)
+          console.log(`  ${s.sessionId} (${s.status})`);
+      } else {
+        console.log("No sessions found");
+      }
+      return;
+    }
+    case "help":
+    case "--help":
+    case "-h":
+      showHelp();
+      return;
+    default:
+      console.error(`Unknown command: ${command || "(none)"}`);
+      showHelp();
+      process.exit(1);
+  }
+}
+main().catch((e) => {
+  console.error(`Fatal: ${e.message}`);
+  process.exit(1);
+});