@bulletproof-sh/ctrl-daemon 0.0.6 → 0.0.8

package/README.md

@@ -26,10 +26,27 @@ npx @bulletproof-sh/ctrl-daemon --port 3001 --host 127.0.0.1
 | `--port <number>` | `3001` | Port to listen on |
 | `--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 |
 | `--help`, `-h` | — | Print usage |
 
 Without `--project-dir`, the daemon scans `~/.claude/projects/` and watches every session it finds there.
 
+## Sharing your office
+
+Run the daemon and an [ngrok](https://ngrok.com) tunnel in parallel to share a live view with anyone:
+
+```sh
+# Terminal 1 — start the daemon
+npx @bulletproof-sh/ctrl-daemon
+
+# Terminal 2 — expose it publicly
+ngrok http 3001
+```
+
+Then open [bulletproof.sh](https://bulletproof.sh), go to **Settings → Share Office** and copy the generated link. Anyone who opens it will see your agents in real time — no auth or setup required on their end.
+
+> **Note:** Free ngrok URLs rotate each time you restart the tunnel. A paid ngrok plan gives you a stable domain.
+
 ## WebSocket API
 
 Connect to `ws://localhost:3001/ws`. The daemon broadcasts JSON messages whenever agent state changes — the same message format used by the VS Code extension's internal webview protocol.

package/dist/index.js

@@ -4245,6 +4245,70 @@ async function shutdownAnalytics() {
   await client.shutdown();
 }
 
+// src/banner.ts
+var BG = "\x1B[92m";
+var CY = "\x1B[36m";
+var YL = "\x1B[33m";
+var DM = "\x1B[2m";
+var BD = "\x1B[1m";
+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     ",
+  " \u2588\u2588\u2554\u2550\u2550\u2550\u2550\u255D\u255A\u2550\u2550\u2588\u2588\u2554\u2550\u2550\u255D\u2588\u2588\u2554\u2550\u2550\u2588\u2588\u2557\u2588\u2588\u2551     ",
+  " \u2588\u2588\u2551        \u2588\u2588\u2551   \u2588\u2588\u2588\u2588\u2588\u2588\u2554\u255D\u2588\u2588\u2551     ",
+  " \u2588\u2588\u2551        \u2588\u2588\u2551   \u2588\u2588\u2554\u2550\u2550\u2588\u2588\u2557\u2588\u2588\u2551     ",
+  " \u255A\u2588\u2588\u2588\u2588\u2588\u2588\u2557   \u2588\u2588\u2551   \u2588\u2588\u2551  \u2588\u2588\u2551\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2557",
+  "  \u255A\u2550\u2550\u2550\u2550\u2550\u255D   \u255A\u2550\u255D   \u255A\u2550\u255D  \u255A\u2550\u255D\u255A\u2550\u2550\u2550\u2550\u2550\u2550\u255D"
+];
+function printBanner() {
+  process.stdout.write(`
+`);
+  for (const line of LOGO_LINES) {
+    process.stdout.write(`${BD}${BG}${line}${RS}
+`);
+  }
+  process.stdout.write(`
+`);
+}
+var SPINNER_FRAMES = [
+  "\u280B",
+  "\u2819",
+  "\u2839",
+  "\u2838",
+  "\u283C",
+  "\u2834",
+  "\u2826",
+  "\u2827",
+  "\u2807",
+  "\u280F"
+];
+function startSpinner(text) {
+  let i = 0;
+  const clearWidth = text.length + 4;
+  const timer = setInterval(() => {
+    process.stdout.write(`\r${CY}${SPINNER_FRAMES[i++ % SPINNER_FRAMES.length]}${RS} ${text}`);
+  }, 80);
+  return () => {
+    clearInterval(timer);
+    process.stdout.write(`\r${" ".repeat(clearWidth)}\r`);
+  };
+}
+function printReady(port, version2, updateMsg) {
+  const versionStr = version2 ? ` ${DM}v${version2}${RS}` : "";
+  if (updateMsg) {
+    process.stdout.write(`
+${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(`  ${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("");
+}
+
 // src/projectScanner.ts
 import * as fs2 from "fs";
 import * as path2 from "path";
@@ -4255,7 +4319,7 @@ var PROJECT_SCAN_INTERVAL_MS = 1000;
 var TOOL_DONE_DELAY_MS = 300;
 var PERMISSION_TIMER_DELAY_MS = 7000;
 var TEXT_IDLE_DELAY_MS = 5000;
-var AGENT_IDLE_TIMEOUT_MS = 5 * 60 * 1000;
+var AGENT_IDLE_TIMEOUT_MS = 15 * 60 * 1000;
 var BASH_COMMAND_DISPLAY_MAX_LENGTH = 30;
 var TASK_DESCRIPTION_DISPLAY_MAX_LENGTH = 40;
 
@@ -4715,7 +4779,7 @@ function collectAllJsonlFiles(projectsRoot) {
   }
   return files;
 }
-function startProjectScanner(rootDir, scanAll, agents, fileWatchers, pollingTimers, waitingTimers, permissionTimers, broadcast) {
+function startProjectScanner(rootDir, scanAll, agents, fileWatchers, pollingTimers, waitingTimers, permissionTimers, broadcast, idleTimeoutMs) {
   const knownJsonlFiles = new Set;
   let nextAgentId = 1;
   function scan() {
@@ -4724,9 +4788,9 @@ function startProjectScanner(rootDir, scanAll, agents, fileWatchers, pollingTime
     for (const { filePath, mtimeMs } of fileInfos) {
       if (knownJsonlFiles.has(filePath))
         continue;
-      knownJsonlFiles.add(filePath);
-      if (now - mtimeMs > AGENT_IDLE_TIMEOUT_MS)
+      if (now - mtimeMs > idleTimeoutMs)
         continue;
+      knownJsonlFiles.add(filePath);
       const id = nextAgentId++;
       const agentProjectDir = path2.dirname(filePath);
       const agent = {
@@ -4753,7 +4817,7 @@ function startProjectScanner(rootDir, scanAll, agents, fileWatchers, pollingTime
     }
     for (const [agentId, agent] of agents) {
       const lastActivity = agent.lastActivityAt || 0;
-      const idle = now - lastActivity > AGENT_IDLE_TIMEOUT_MS;
+      const idle = now - lastActivity > idleTimeoutMs;
       const removed = !fs2.existsSync(agent.jsonlFile);
       if (removed || idle) {
         const reason = removed ? "JSONL removed" : "idle timeout";
@@ -4889,13 +4953,11 @@ async function checkForUpdate() {
     getLatestVersion()
   ]);
   if (!current || !latest)
-    return;
+    return null;
   if (!isNewer(current, latest))
-    return;
-  console.log(`
-[ctrl-daemon] Update available: v${current} \u2192 v${latest}
-` + `  Run: npx ${PACKAGE_NAME}@latest
-`);
+    return null;
+  return `  \u2B06  Update available: v${current} \u2192 v${latest}
+` + `     Run: npx ${PACKAGE_NAME}@latest`;
 }
 
 // src/index.ts
@@ -4903,10 +4965,11 @@ function printUsage() {
   console.log(`Usage: ctrl-daemon [options]
 
 Options:
-  --port <number>      Port to listen on (default: 3001)
-  --host <address>     Host/address to bind to (default: 0.0.0.0)
-  --project-dir <path> Watch a single project directory
-  --help, -h           Show this help message
+  --port <number>         Port to listen on (default: 3001)
+  --host <address>        Host/address to bind to (default: 0.0.0.0)
+  --project-dir <path>    Watch a single project directory
+  --idle-timeout <minutes> Agent idle timeout in minutes (default: 15)
+  --help, -h              Show this help message
 
 Without --project-dir, watches ALL projects in ~/.claude/projects/.
 With --project-dir, watches only that specific project.`);
@@ -4916,6 +4979,7 @@ function parseArgs() {
   let projectDir;
   let port = 3001;
   let host = "0.0.0.0";
+  let idleTimeoutMs = 15 * 60 * 1000;
   for (let i = 0;i < args.length; i++) {
     if (args[i] === "--help" || args[i] === "-h") {
       printUsage();
@@ -4926,17 +4990,25 @@ function parseArgs() {
       port = Number.parseInt(args[++i], 10);
     } else if (args[i] === "--host" && args[i + 1]) {
       host = args[++i];
+    } else if (args[i] === "--idle-timeout" && args[i + 1]) {
+      idleTimeoutMs = Number.parseInt(args[++i], 10) * 60 * 1000;
     }
   }
-  return { projectDir, port, host };
+  return { projectDir, port, host, idleTimeoutMs };
 }
 function resolveProjectsRoot(claudeHome) {
   const home = claudeHome || path3.join(process.env.HOME || "~", ".claude");
   return path3.join(home, "projects");
 }
 async function main() {
+  printBanner();
+  const stopSpinner = startSpinner("Starting\u2026");
   const analyticsConfig = initAnalytics();
-  const [version2] = await Promise.all([getCurrentVersion(), checkForUpdate()]);
+  const [version2, updateMsg] = await Promise.all([
+    getCurrentVersion(),
+    checkForUpdate()
+  ]);
+  stopSpinner();
   process.on("uncaughtException", async (err) => {
     console.error("[ctrl-daemon] Uncaught exception:", err);
     trackException(err, { ...systemInfo, crash_type: "uncaughtException" });
@@ -4950,18 +5022,14 @@ async function main() {
     await shutdownAnalytics();
     process.exit(1);
   });
-  const { projectDir, port, host } = parseArgs();
+  const { projectDir, port, host, idleTimeoutMs } = parseArgs();
   const claudeHome = process.env.CLAUDE_HOME;
-  console.log("[ctrl-daemon] Contribute or report issues: https://github.com/bulletproof-sh/ctrl");
   let scanDirs;
   if (projectDir) {
     const dir = resolveProjectDir(projectDir, claudeHome);
     scanDirs = [dir];
-    console.log(`[ctrl-daemon] Project dir: ${projectDir}`);
-    console.log(`[ctrl-daemon] Session dir: ${dir}`);
   } else {
     const projectsRoot = resolveProjectsRoot(claudeHome);
-    console.log(`[ctrl-daemon] Watching all projects in: ${projectsRoot}`);
     scanDirs = [projectsRoot];
   }
   const agents = new Map;
@@ -4970,6 +5038,7 @@ async function main() {
   const waitingTimers = new Map;
   const permissionTimers = new Map;
   const server = createServer({ port, host, agents });
+  printReady(port, version2, updateMsg);
   trackEvent("daemon_started", {
     version: version2 ?? "unknown",
     port,
@@ -4979,7 +5048,7 @@ async function main() {
     ...analyticsConfig
   });
   const scanAll = !projectDir;
-  const scanner = startProjectScanner(scanDirs[0], scanAll, agents, fileWatchers, pollingTimers, waitingTimers, permissionTimers, server.broadcast);
+  const scanner = startProjectScanner(scanDirs[0], scanAll, agents, fileWatchers, pollingTimers, waitingTimers, permissionTimers, server.broadcast, idleTimeoutMs);
   async function shutdown() {
     console.log(`
 [ctrl-daemon] Shutting down...`);

package/package.json

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