@bulletproof-sh/ctrl-daemon 0.0.9 → 0.0.10

package/README.md

@@ -1,6 +1,6 @@
 # @bulletproof-sh/ctrl-daemon
 
-WebSocket daemon for [Ctrl / Cubicles](https://ctrl.bulletproof.sh) — watches Claude Code sessions on disk and broadcasts live agent state to connected web clients.
+WebSocket daemon for [Ctrl / Cubicles](https://ctrl.bulletproof.sh) — watches Claude Code sessions on disk and broadcasts live agent state to connected web clients. Features a full-screen animated Matrix rain TUI with a centered log panel showing daemon events in real time.
 
 ## Requirements
 
@@ -17,20 +17,32 @@ npx @bulletproof-sh/ctrl-daemon --project-dir /path/to/your/project
 
 # Custom port / host
 npx @bulletproof-sh/ctrl-daemon --port 3001 --host 127.0.0.1
+
+# Disable the Matrix rain TUI (plain text output)
+npx @bulletproof-sh/ctrl-daemon --no-tui
 ```
 
 ### Options
 
 | Flag | Default | Description |
 |---|---|---|
-| `--port <number>` | `3001` | Port to listen on |
+| `--port <number>` | `3001` | Port to listen on (auto-increments if in use) |
 | `--host <address>` | `0.0.0.0` | Host/address to bind to |
 | `--project-dir <path>` | — | Watch a single project; omit to watch all projects |
 | `--idle-timeout <minutes>` | `15` | Agent idle timeout in minutes |
+| `--no-tui` | — | Disable Matrix rain TUI (also auto-disabled when not a TTY) |
 | `--help`, `-h` | — | Print usage |
 
 Without `--project-dir`, the daemon scans `~/.claude/projects/` and watches every session it finds there.
 
+If the requested port is already in use, the daemon automatically tries the next port (up to 10 attempts).
+
+## Terminal UI
+
+When running in a TTY, the daemon displays an animated Matrix rain effect with a centered panel showing the CTRL logo, live agent/client counts, and scrolling daemon event logs. The TUI handles terminal resize and restores the terminal cleanly on exit.
+
+Pass `--no-tui` to disable the TUI and use plain text output instead. The TUI is also automatically disabled when stdout is not a TTY (e.g. when piping output or running in CI).
+
 ## Sharing your office
 
 Run the daemon and an [ngrok](https://ngrok.com) tunnel in parallel to share a live view with anyone:
@@ -63,11 +75,11 @@ Crash reports use PostHog analytics.
 
 ## Auto-update
 
-On startup the daemon checks npm for a newer version and prints a notice if one is available:
+On startup — and every 5 minutes in the background — the daemon checks npm for a newer version. If one is found, a notice is printed (or logged to the TUI panel):
 
 ```
-[ctrl-daemon] Update available: v0.0.2 → v0.0.3
-  Run: npm install -g @bulletproof-sh/ctrl-daemon@latest
+  ⬆  Update available: v0.0.8 → v0.0.9
+     Run: npx @bulletproof-sh/ctrl-daemon@latest
 ```
 
 The check is non-blocking and fails silently if the registry is unreachable.
@@ -85,5 +97,5 @@ bun run check      # biome lint + format
 
 ## License
 
-MIT
+BUSL-1.1
 

package/dist/index.js

@@ -4245,12 +4245,110 @@ async function shutdownAnalytics() {
   await client.shutdown();
 }
 
+// src/tui/constants.ts
+var KATAKANA_START = 65382;
+var KATAKANA_END = 65437;
+var KATAKANA_CHARS = [];
+for (let i = KATAKANA_START;i <= KATAKANA_END; i++) {
+  KATAKANA_CHARS.push(String.fromCharCode(i));
+}
+var EXTRA_CHARS = "0123456789$+-*/%=#@&<>~^".split("");
+var RAIN_CHARS = [...KATAKANA_CHARS, ...EXTRA_CHARS];
+var TRAIL_GRADIENT = [
+  231,
+  159,
+  123,
+  49,
+  48,
+  46,
+  40,
+  34,
+  28,
+  22,
+  23,
+  29,
+  24,
+  18,
+  17
+];
+var LAYERS = {
+  back: {
+    speedMin: 0.15,
+    speedMax: 0.3,
+    trailMin: 8,
+    trailMax: 16,
+    spawnRate: 0.01,
+    mutationInterval: 12,
+    brightnessOffset: 4
+  },
+  mid: {
+    speedMin: 0.3,
+    speedMax: 0.6,
+    trailMin: 10,
+    trailMax: 25,
+    spawnRate: 0.02,
+    mutationInterval: 8,
+    brightnessOffset: 2
+  },
+  front: {
+    speedMin: 0.6,
+    speedMax: 1.2,
+    trailMin: 6,
+    trailMax: 14,
+    spawnRate: 0.015,
+    mutationInterval: 5,
+    brightnessOffset: 0
+  }
+};
+var LIGHTNING_CHANCE = 0.002;
+var LIGHTNING_SPEED_MIN = 2;
+var LIGHTNING_SPEED_MAX = 4;
+var LIGHTNING_TRAIL_LEN = 4;
+var TARGET_FPS = 8;
+var FRAME_INTERVAL_MS = Math.round(1000 / TARGET_FPS);
+var UPDATE_CHECK_INTERVAL_MS = 5 * 60 * 1000;
+var WEB_APP_BASE_URL = "https://ctrl.bulletproof.sh";
+var DEFAULT_WS_PORT = 3001;
+var PANEL_MAX_WIDTH = 80;
+var PANEL_MAX_HEIGHT = 24;
+var PANEL_MARGIN_X = 5;
+var PANEL_MARGIN_Y = 3;
+var PANEL_MIN_WIDTH = 40;
+var PANEL_MIN_HEIGHT = 12;
+var PANEL_HEADER_HEIGHT = 8;
+var LOG_RING_SIZE = 200;
+var BORDER_GLOW_SPEED = 0.05;
+var BOX = {
+  topLeft: "\u2554",
+  topRight: "\u2557",
+  bottomLeft: "\u255A",
+  bottomRight: "\u255D",
+  horizontal: "\u2550",
+  vertical: "\u2551",
+  teeLeft: "\u2560",
+  teeRight: "\u2563"
+};
+var FG256_TABLE = [];
+for (let i = 0;i < 256; i++) {
+  FG256_TABLE.push(`\x1B[38;5;${i}m`);
+}
+var fg256 = (n) => FG256_TABLE[n];
+var BOLD = "\x1B[1m";
+var DIM = "\x1B[2m";
+var RESET = "\x1B[0m";
+var BRIGHT_GREEN_FG = "\x1B[92m";
+var CYAN_FG = "\x1B[36m";
+var YELLOW_FG = "\x1B[33m";
+var RED_FG = "\x1B[31m";
+var ORANGE_FG = "\x1B[38;5;208m";
+
 // src/banner.ts
 var BG = "\x1B[92m";
 var CY = "\x1B[36m";
 var YL = "\x1B[33m";
 var DM = "\x1B[2m";
 var BD = "\x1B[1m";
+var UL = "\x1B[4m";
 var RS = "\x1B[0m";
 var LOGO_LINES = [
   "  \u2588\u2588\u2588\u2588\u2588\u2588\u2557\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2557\u2588\u2588\u2588\u2588\u2588\u2588\u2557 \u2588\u2588\u2557     ",
@@ -4270,18 +4368,7 @@ function printBanner() {
   process.stdout.write(`
 `);
 }
-var SPINNER_FRAMES = [
-  "\u280B",
-  "\u2819",
-  "\u2839",
-  "\u2838",
-  "\u283C",
-  "\u2834",
-  "\u2826",
-  "\u2827",
-  "\u2807",
-  "\u280F"
-];
+var SPINNER_FRAMES = ["\u280B", "\u2819", "\u2839", "\u2838", "\u283C", "\u2834", "\u2826", "\u2827", "\u2807", "\u280F"];
 function startSpinner(text) {
   let i = 0;
   const clearWidth = text.length + 4;
@@ -4293,8 +4380,15 @@ function startSpinner(text) {
     process.stdout.write(`\r${" ".repeat(clearWidth)}\r`);
   };
 }
-function printReady(port, version2, updateMsg) {
+function buildWebUrl(port, host) {
+  if (port === DEFAULT_WS_PORT)
+    return WEB_APP_BASE_URL;
+  const wsUrl = `ws://${host}:${port}/ws`;
+  return `${WEB_APP_BASE_URL}?daemon=${encodeURIComponent(wsUrl)}`;
+}
+function printReady(port, host, version2, updateMsg) {
   const versionStr = version2 ? ` ${DM}v${version2}${RS}` : "";
+  const webUrl = buildWebUrl(port, host);
   if (updateMsg) {
     process.stdout.write(`
 ${YL}${updateMsg}${RS}
@@ -4304,6 +4398,8 @@ ${YL}${updateMsg}${RS}
   console.log(`  ${BG}\u2713${RS} WebSocket server on :${port}${versionStr}`);
   console.log(`  ${BG}\u2713${RS} Watching Claude sessions`);
   console.log("");
+  console.log(`  ${CY}Open: ${UL}${webUrl}${RS}`);
+  console.log("");
   console.log(`  ${DM}Share: run \`ngrok http ${port}\`, then open Settings \u2192 Share${RS}`);
   console.log(`  ${DM}Issues: https://github.com/bulletproof-sh/ctrl${RS}`);
   console.log("");
@@ -4660,101 +4756,6 @@ function processProgressRecord(agentId, record, agents, waitingTimers, permissio
     }
   }
 }
-// src/tui/constants.ts
-var KATAKANA_START = 65382;
-var KATAKANA_END = 65437;
-var KATAKANA_CHARS = [];
-for (let i = KATAKANA_START;i <= KATAKANA_END; i++) {
-  KATAKANA_CHARS.push(String.fromCharCode(i));
-}
-var EXTRA_CHARS = "0123456789$+-*/%=#@&<>~^".split("");
-var RAIN_CHARS = [...KATAKANA_CHARS, ...EXTRA_CHARS];
-var TRAIL_GRADIENT = [
-  231,
-  159,
-  123,
-  49,
-  48,
-  46,
-  40,
-  34,
-  28,
-  22,
-  23,
-  29,
-  24,
-  18,
-  17
-];
-var LAYERS = {
-  back: {
-    speedMin: 0.15,
-    speedMax: 0.3,
-    trailMin: 8,
-    trailMax: 16,
-    spawnRate: 0.01,
-    mutationInterval: 12,
-    brightnessOffset: 4
-  },
-  mid: {
-    speedMin: 0.3,
-    speedMax: 0.6,
-    trailMin: 10,
-    trailMax: 25,
-    spawnRate: 0.02,
-    mutationInterval: 8,
-    brightnessOffset: 2
-  },
-  front: {
-    speedMin: 0.6,
-    speedMax: 1.2,
-    trailMin: 6,
-    trailMax: 14,
-    spawnRate: 0.015,
-    mutationInterval: 5,
-    brightnessOffset: 0
-  }
-};
-var LIGHTNING_CHANCE = 0.002;
-var LIGHTNING_SPEED_MIN = 2;
-var LIGHTNING_SPEED_MAX = 4;
-var LIGHTNING_TRAIL_LEN = 4;
-var TARGET_FPS = 8;
-var FRAME_INTERVAL_MS = Math.round(1000 / TARGET_FPS);
-var UPDATE_CHECK_INTERVAL_MS = 5 * 60 * 1000;
-var PANEL_MAX_WIDTH = 80;
-var PANEL_MAX_HEIGHT = 24;
-var PANEL_MARGIN_X = 5;
-var PANEL_MARGIN_Y = 3;
-var PANEL_MIN_WIDTH = 40;
-var PANEL_MIN_HEIGHT = 12;
-var PANEL_HEADER_HEIGHT = 8;
-var LOG_RING_SIZE = 200;
-var BORDER_GLOW_SPEED = 0.05;
-var BOX = {
-  topLeft: "\u2554",
-  topRight: "\u2557",
-  bottomLeft: "\u255A",
-  bottomRight: "\u255D",
-  horizontal: "\u2550",
-  vertical: "\u2551",
-  teeLeft: "\u2560",
-  teeRight: "\u2563"
-};
-var FG256_TABLE = [];
-for (let i = 0;i < 256; i++) {
-  FG256_TABLE.push(`\x1B[38;5;${i}m`);
-}
-var fg256 = (n) => FG256_TABLE[n];
-var BOLD = "\x1B[1m";
-var DIM = "\x1B[2m";
-var RESET = "\x1B[0m";
-var BRIGHT_GREEN_FG = "\x1B[92m";
-var CYAN_FG = "\x1B[36m";
-var YELLOW_FG = "\x1B[33m";
-var RED_FG = "\x1B[31m";
-var ORANGE_FG = "\x1B[38;5;208m";
-
 // src/tui/logSink.ts
 var logBuffer = [];
 var tuiActive = false;
@@ -5290,7 +5291,7 @@ function writeString(buf, row, col, str, fg, bold, dim) {
     setCell(buf, row, col + i, str[i], fg, bold, dim);
   }
 }
-function renderPanel(buf, panel, logs, agentCount, clientCount, version2, wsUrl) {
+function renderPanel(buf, panel, logs, agentCount, clientCount, version2, webUrl) {
   if (!panel.visible)
     return;
   const { x, y, width, height } = panel;
@@ -5327,13 +5328,21 @@ function renderPanel(buf, panel, logs, agentCount, clientCount, version2, wsUrl)
       setCell(buf, logoStartRow + i, x + 2 + c, line[c], BRIGHT_GREEN_FG, true, false);
     }
   }
-  if (LOGO_LINES.length >= 3) {
-    const infoStr = `${version2 ? `v${version2}` : ""} \xB7 ${wsUrl}`;
-    const maxInfoLen = innerWidth - (LOGO_LINES[2]?.length || 0) - 3;
-    if (maxInfoLen > 10) {
-      const trimmed = infoStr.slice(0, maxInfoLen);
-      const infoCol = x + width - 2 - trimmed.length;
-      writeString(buf, logoStartRow + 2, infoCol, trimmed, CYAN_FG, false, true);
+  if (version2 && LOGO_LINES.length >= 3) {
+    const vStr = `v${version2}`;
+    const maxLen = innerWidth - (LOGO_LINES[2]?.length || 0) - 3;
+    if (maxLen > 4) {
+      const trimmed = vStr.slice(0, maxLen);
+      const col = x + width - 2 - trimmed.length;
+      writeString(buf, logoStartRow + 2, col, trimmed, CYAN_FG, false, true);
+    }
+  }
+  if (LOGO_LINES.length >= 4) {
+    const maxLen = innerWidth - (LOGO_LINES[3]?.length || 0) - 3;
+    if (maxLen > 10) {
+      const trimmed = webUrl.slice(0, maxLen);
+      const col = x + width - 2 - trimmed.length;
+      writeString(buf, logoStartRow + 3, col, trimmed, CYAN_FG, false, true);
     }
   }
   if (LOGO_LINES.length >= 5) {
@@ -5575,8 +5584,7 @@ function renderFrame() {
   tickRain(rainLayers, current.rows);
   clearBuffer(current);
   renderRain(rainLayers, current, panel);
-  const wsUrl = `ws://${tuiOptions.host}:${tuiOptions.port}`;
-  renderPanel(current, panel, getLogEntries(), tuiOptions.agentCount(), tuiOptions.clientCount(), tuiOptions.version, wsUrl);
+  renderPanel(current, panel, getLogEntries(), tuiOptions.agentCount(), tuiOptions.clientCount(), tuiOptions.version, tuiOptions.webUrl);
   flushDiff(current, hasPrevious ? previous : null);
   currentIsA = !currentIsA;
   hasPrevious = true;
@@ -5762,7 +5770,7 @@ async function main() {
   const permissionTimers = new Map;
   const server = createServer({ port, host, agents });
   const boundPort = server.port;
-  printReady(boundPort, version2, updateMsg);
+  printReady(boundPort, host, version2, updateMsg);
   const rawBroadcast = server.broadcast;
   const broadcast = (msg) => {
     rawBroadcast(msg);
@@ -5772,7 +5780,7 @@ async function main() {
     startTui({
       version: version2,
       port: boundPort,
-      host,
+      webUrl: buildWebUrl(boundPort, host),
       agentCount: () => agents.size,
       clientCount: () => server.clientCount()
     });

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@bulletproof-sh/ctrl-daemon",
-	"version": "0.0.9",
+	"version": "0.0.10",
 	"description": "WebSocket daemon for ctrl — watches Claude Code sessions and broadcasts agent state",
 	"type": "module",
 	"license": "BUSL-1.1",