From 9797e095b7c268cf2d4e7b8d35a5f04a7d363fb1 Mon Sep 17 00:00:00 2001
From: Adam Malczewski <github@tradam.dev>
Date: Sun, 21 Jun 2026 22:55:31 +0900
Subject: feat(cli): add 'open' command to signal frontend without sending a
 message

dispatch open <conversationId> broadcasts a conversation.open WS message
to all connected frontend clients without sending any message. Useful
after 'read' or 'send --queue' when you just want the frontend to
open/focus a conversation's tab.
---
 packages/cli/src/main.ts | 17 +++++++++++++++++
 1 file changed, 17 insertions(+)

(limited to 'packages/cli/src/main.ts')

diff --git a/packages/cli/src/main.ts b/packages/cli/src/main.ts
index 04e7231..365096a 100644
--- a/packages/cli/src/main.ts
+++ b/packages/cli/src/main.ts
@@ -24,6 +24,7 @@ const USAGE = `Usage:
   dispatch models [--server <url>]
   dispatch list [<prefix>] [--server <url>]
   dispatch read <conversationId> [--server <url>]
+  dispatch open <conversationId> [--server <url>]
   dispatch send <conversationId> --text "..." [--queue] [--open] [--cwd <dir>] [--effort <level>] [--server <url>]
   dispatch <modelName> --text "..." [--file <path>] [--cwd <dir>] [--conversation <id>] [--effort <level>] [--server <url>] [--show-reasoning] [--open]
   dispatch --help
@@ -73,6 +74,22 @@ async function main(): Promise<void> {
 			if (last.content.length > 0) process.stdout.write(`${last.content}\n`);
 			break;
 		}
+		case "open": {
+			const resolved = await resolveConversationId(
+				{ fetchImpl: globalThis.fetch },
+				{ server: parsed.server, shortId: parsed.conversationId },
+			);
+			if (typeof resolved !== "string") {
+				process.stderr.write(`${resolved.error}\n`);
+				process.exit(1);
+			}
+			await openConversation(
+				{ fetchImpl: globalThis.fetch },
+				{ server: parsed.server, conversationId: resolved },
+			);
+			process.stdout.write(`Signaled frontend to open ${resolved}\n`);
+			break;
+		}
 		case "send": {
 			const resolved = await resolveConversationId(
 				{ fetchImpl: globalThis.fetch },
-- 
cgit v1.2.3