feat: add gateway TUI

src/cli/program.ts

@@ -24,6 +24,7 @@ import { registerGatewayCli } from "./gateway-cli.js";
 import { registerHooksCli } from "./hooks-cli.js";
 import { registerNodesCli } from "./nodes-cli.js";
 import { forceFreePort } from "./ports.js";
+import { registerTuiCli } from "./tui-cli.js";
 
 export { forceFreePort };
 
@@ -394,6 +395,7 @@ Examples:
   registerCanvasCli(program);
   registerGatewayCli(program);
   registerNodesCli(program);
+  registerTuiCli(program);
   registerCronCli(program);
   registerDnsCli(program);
   registerHooksCli(program);

src/cli/tui-cli.ts

@@ -0,0 +1,42 @@
+import type { Command } from "commander";
+import { defaultRuntime } from "../runtime.js";
+import { runTui } from "../tui/tui.js";
+
+export function registerTuiCli(program: Command) {
+  program
+    .command("tui")
+    .description("Open a terminal UI connected to the Gateway")
+    .option(
+      "--url <url>",
+      "Gateway WebSocket URL (defaults to gateway.remote.url when configured)",
+    )
+    .option("--token <token>", "Gateway token (if required)")
+    .option("--password <password>", "Gateway password (if required)")
+    .option(
+      "--session <key>",
+      "Session key (default: session.mainKey from config)",
+    )
+    .option("--deliver", "Deliver assistant replies", false)
+    .option("--thinking <level>", "Thinking level override")
+    .option("--timeout-ms <ms>", "Agent timeout in ms", "30000")
+    .option("--history-limit <n>", "History entries to load", "200")
+    .action(async (opts) => {
+      try {
+        const timeoutMs = Number.parseInt(String(opts.timeoutMs ?? "30000"), 10);
+        const historyLimit = Number.parseInt(String(opts.historyLimit ?? "200"), 10);
+        await runTui({
+          url: opts.url as string | undefined,
+          token: opts.token as string | undefined,
+          password: opts.password as string | undefined,
+          session: opts.session as string | undefined,
+          deliver: Boolean(opts.deliver),
+          thinking: opts.thinking as string | undefined,
+          timeoutMs: Number.isNaN(timeoutMs) ? undefined : timeoutMs,
+          historyLimit: Number.isNaN(historyLimit) ? undefined : historyLimit,
+        });
+      } catch (err) {
+        defaultRuntime.error(String(err));
+        defaultRuntime.exit(1);
+      }
+    });
+}