@bulletproof-sh/ctrl-daemon 0.0.5 → 0.0.7

package/README.md

@@ -1,6 +1,6 @@
 # @bulletproof-sh/ctrl-daemon
 
-WebSocket daemon for [Ctrl / Cubicles](https://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.
 
 ## Requirements
 
@@ -30,6 +30,22 @@ npx @bulletproof-sh/ctrl-daemon --port 3001 --host 127.0.0.1
 
 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.
@@ -42,7 +58,7 @@ The [Ctrl web app](https://ctrl.bulletproof.sh) connects here by default. You ca
 |---|---|
 | `CLAUDE_HOME` | Override the Claude home directory (default: `~/.claude`) |
 
-Analytics are always enabled and use a built-in PostHog key — no configuration needed. Crash reports use PostHog Error Tracking.
+Crash reports use PostHog analytics.
 
 ## Auto-update
 

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";
@@ -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
@@ -4935,8 +4997,14 @@ function resolveProjectsRoot(claudeHome) {
   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" });
@@ -4956,11 +5024,8 @@ async function main() {
   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;
@@ -4969,6 +5034,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,

package/package.json

@@ -1,9 +1,9 @@
 {
 	"name": "@bulletproof-sh/ctrl-daemon",
-	"version": "0.0.5",
+	"version": "0.0.7",
 	"description": "WebSocket daemon for ctrl — watches Claude Code sessions and broadcasts agent state",
 	"type": "module",
-	"license": "MIT",
+	"license": "BUSL-1.1",
 	"bin": {
 		"ctrl-daemon": "bin/ctrl-daemon.js"
 	},