claude-threads 0.31.2 → 0.32.0

package/CHANGELOG.md

@@ -7,6 +7,16 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [0.32.0] - 2026-01-03
+
+### Added
+- **Claude CLI version check** - Validates Claude CLI version at startup and exits if incompatible (bypass with `--skip-version-check`). Compatible versions: `>=2.0.74 <=2.0.76`. Version is displayed in terminal startup output, sticky channel message, and session headers.
+
+## [0.31.3] - 2026-01-03
+
+### Fixed
+- **Clean up stale browser bridge sockets** - Removes stale `claude-mcp-browser-bridge-*` socket files from temp directory before starting Claude CLI. This works around a Claude CLI bug where it tries to `fs.watch()` existing socket files, which fails with `EOPNOTSUPP`. The socket files are left over from previous Chrome integration sessions.
+
 ## [0.31.2] - 2026-01-03
 
 ### Fixed

package/dist/index.js

@@ -8933,7 +8933,7 @@ var require_minimist = __commonJS((exports, module) => {
 // node_modules/rc/index.js
 var require_rc = __commonJS((exports, module) => {
   var cc = require_utils();
-  var join2 = __require("path").join;
+  var join3 = __require("path").join;
   var deepExtend = require_deep_extend();
   var etc = "/etc";
   var win = process.platform === "win32";
@@ -8959,15 +8959,15 @@ var require_rc = __commonJS((exports, module) => {
     }
     if (!win)
       [
-        join2(etc, name, "config"),
-        join2(etc, name + "rc")
+        join3(etc, name, "config"),
+        join3(etc, name + "rc")
       ].forEach(addConfigFile);
     if (home)
       [
-        join2(home, ".config", name, "config"),
-        join2(home, ".config", name),
-        join2(home, "." + name, "config"),
-        join2(home, "." + name + "rc")
+        join3(home, ".config", name, "config"),
+        join3(home, ".config", name),
+        join3(home, "." + name, "config"),
+        join3(home, "." + name + "rc")
       ].forEach(addConfigFile);
     addConfigFile(cc.find("." + name + "rc"));
     if (env3.config)
@@ -12879,6 +12879,8 @@ var dim = (s) => `${colors.dim}${s}${colors.reset}`;
 var bold = (s) => `${colors.bold}${s}${colors.reset}`;
 var cyan = (s) => `${colors.cyan}${s}${colors.reset}`;
 var green = (s) => `${colors.green}${s}${colors.reset}`;
+var red = (s) => `${colors.red}${s}${colors.reset}`;
+var yellow = (s) => `${colors.yellow}${s}${colors.reset}`;
 function log(emoji, message) {
   console.log(`  ${emoji} ${message}`);
 }
@@ -15729,8 +15731,30 @@ import { spawn } from "child_process";
 import { EventEmitter as EventEmitter2 } from "events";
 import { resolve as resolve2, dirname as dirname2 } from "path";
 import { fileURLToPath } from "url";
-import { existsSync as existsSync4, readFileSync as readFileSync4, watchFile, unwatchFile, unlinkSync } from "fs";
+import { existsSync as existsSync4, readFileSync as readFileSync4, watchFile, unwatchFile, unlinkSync, statSync, readdirSync } from "fs";
+import { tmpdir } from "os";
+import { join as join2 } from "path";
 var log8 = createLogger("claude");
+function cleanupBrowserBridgeSockets() {
+  try {
+    const tempDir = tmpdir();
+    const files = readdirSync(tempDir);
+    for (const file of files) {
+      if (file.startsWith("claude-mcp-browser-bridge-")) {
+        const filePath = join2(tempDir, file);
+        try {
+          const stats = statSync(filePath);
+          if (stats.isSocket()) {
+            unlinkSync(filePath);
+            log8.debug(`Removed stale browser bridge socket: ${file}`);
+          }
+        } catch {}
+      }
+    }
+  } catch (err) {
+    log8.debug(`Browser bridge cleanup failed: ${err}`);
+  }
+}
 
 class ClaudeCli extends EventEmitter2 {
   process = null;
@@ -15784,6 +15808,7 @@ class ClaudeCli extends EventEmitter2 {
     if (this.process)
       throw new Error("Already running");
     this.stderrBuffer = "";
+    cleanupBrowserBridgeSockets();
     const claudePath = process.env.CLAUDE_PATH || "claude";
     const args = [
       "--input-format",
@@ -15969,7 +15994,7 @@ class ClaudeCli extends EventEmitter2 {
 // src/session/commands.ts
 import { randomUUID as randomUUID2 } from "crypto";
 import { resolve as resolve5 } from "path";
-import { existsSync as existsSync7, statSync } from "fs";
+import { existsSync as existsSync7, statSync as statSync2 } from "fs";
 
 // node_modules/update-notifier/update-notifier.js
 import process10 from "process";
@@ -16698,7 +16723,7 @@ class Configstore {
 var ANSI_BACKGROUND_OFFSET = 10;
 var wrapAnsi16 = (offset = 0) => (code) => `\x1B[${code + offset}m`;
 var wrapAnsi256 = (offset = 0) => (code) => `\x1B[${38 + offset};5;${code}m`;
-var wrapAnsi16m = (offset = 0) => (red, green2, blue) => `\x1B[${38 + offset};2;${red};${green2};${blue}m`;
+var wrapAnsi16m = (offset = 0) => (red2, green2, blue) => `\x1B[${38 + offset};2;${red2};${green2};${blue}m`;
 var styles = {
   modifier: {
     reset: [0, 0],
@@ -16786,17 +16811,17 @@ function assembleStyles() {
   styles.bgColor.ansi16m = wrapAnsi16m(ANSI_BACKGROUND_OFFSET);
   Object.defineProperties(styles, {
     rgbToAnsi256: {
-      value(red, green2, blue) {
-        if (red === green2 && green2 === blue) {
-          if (red < 8) {
+      value(red2, green2, blue) {
+        if (red2 === green2 && green2 === blue) {
+          if (red2 < 8) {
             return 16;
           }
-          if (red > 248) {
+          if (red2 > 248) {
             return 231;
           }
-          return Math.round((red - 8) / 247 * 24) + 232;
+          return Math.round((red2 - 8) / 247 * 24) + 232;
         }
-        return 16 + 36 * Math.round(red / 255 * 5) + 6 * Math.round(green2 / 255 * 5) + Math.round(blue / 255 * 5);
+        return 16 + 36 * Math.round(red2 / 255 * 5) + 6 * Math.round(green2 / 255 * 5) + Math.round(blue / 255 * 5);
       },
       enumerable: false
     },
@@ -16831,25 +16856,25 @@ function assembleStyles() {
         if (code < 16) {
           return 90 + (code - 8);
         }
-        let red;
+        let red2;
         let green2;
         let blue;
         if (code >= 232) {
-          red = ((code - 232) * 10 + 8) / 255;
-          green2 = red;
-          blue = red;
+          red2 = ((code - 232) * 10 + 8) / 255;
+          green2 = red2;
+          blue = red2;
         } else {
           code -= 16;
           const remainder = code % 36;
-          red = Math.floor(code / 36) / 5;
+          red2 = Math.floor(code / 36) / 5;
           green2 = Math.floor(remainder / 6) / 5;
           blue = remainder % 6 / 5;
         }
-        const value = Math.max(red, green2, blue) * 2;
+        const value = Math.max(red2, green2, blue) * 2;
         if (value === 0) {
           return 30;
         }
-        let result = 30 + (Math.round(blue) << 2 | Math.round(green2) << 1 | Math.round(red));
+        let result = 30 + (Math.round(blue) << 2 | Math.round(green2) << 1 | Math.round(red2));
         if (value === 2) {
           result += 60;
         }
@@ -16858,7 +16883,7 @@ function assembleStyles() {
       enumerable: false
     },
     rgbToAnsi: {
-      value: (red, green2, blue) => styles.ansi256ToAnsi(styles.rgbToAnsi256(red, green2, blue)),
+      value: (red2, green2, blue) => styles.ansi256ToAnsi(styles.rgbToAnsi256(red2, green2, blue)),
       enumerable: false
     },
     hexToAnsi: {
@@ -18425,7 +18450,7 @@ var import_ansi_align = __toESM(require_ansi_align(), 1);
 var ANSI_BACKGROUND_OFFSET2 = 10;
 var wrapAnsi162 = (offset = 0) => (code) => `\x1B[${code + offset}m`;
 var wrapAnsi2562 = (offset = 0) => (code) => `\x1B[${38 + offset};5;${code}m`;
-var wrapAnsi16m2 = (offset = 0) => (red, green2, blue) => `\x1B[${38 + offset};2;${red};${green2};${blue}m`;
+var wrapAnsi16m2 = (offset = 0) => (red2, green2, blue) => `\x1B[${38 + offset};2;${red2};${green2};${blue}m`;
 var styles3 = {
   modifier: {
     reset: [0, 0],
@@ -18513,17 +18538,17 @@ function assembleStyles2() {
   styles3.bgColor.ansi16m = wrapAnsi16m2(ANSI_BACKGROUND_OFFSET2);
   Object.defineProperties(styles3, {
     rgbToAnsi256: {
-      value(red, green2, blue) {
-        if (red === green2 && green2 === blue) {
-          if (red < 8) {
+      value(red2, green2, blue) {
+        if (red2 === green2 && green2 === blue) {
+          if (red2 < 8) {
             return 16;
           }
-          if (red > 248) {
+          if (red2 > 248) {
             return 231;
           }
-          return Math.round((red - 8) / 247 * 24) + 232;
+          return Math.round((red2 - 8) / 247 * 24) + 232;
         }
-        return 16 + 36 * Math.round(red / 255 * 5) + 6 * Math.round(green2 / 255 * 5) + Math.round(blue / 255 * 5);
+        return 16 + 36 * Math.round(red2 / 255 * 5) + 6 * Math.round(green2 / 255 * 5) + Math.round(blue / 255 * 5);
       },
       enumerable: false
     },
@@ -18558,25 +18583,25 @@ function assembleStyles2() {
         if (code < 16) {
           return 90 + (code - 8);
         }
-        let red;
+        let red2;
         let green2;
         let blue;
         if (code >= 232) {
-          red = ((code - 232) * 10 + 8) / 255;
-          green2 = red;
-          blue = red;
+          red2 = ((code - 232) * 10 + 8) / 255;
+          green2 = red2;
+          blue = red2;
         } else {
           code -= 16;
           const remainder = code % 36;
-          red = Math.floor(code / 36) / 5;
+          red2 = Math.floor(code / 36) / 5;
           green2 = Math.floor(remainder / 6) / 5;
           blue = remainder % 6 / 5;
         }
-        const value = Math.max(red, green2, blue) * 2;
+        const value = Math.max(red2, green2, blue) * 2;
         if (value === 0) {
           return 30;
         }
-        let result = 30 + (Math.round(blue) << 2 | Math.round(green2) << 1 | Math.round(red));
+        let result = 30 + (Math.round(blue) << 2 | Math.round(green2) << 1 | Math.round(red2));
         if (value === 2) {
           result += 60;
         }
@@ -18585,7 +18610,7 @@ function assembleStyles2() {
       enumerable: false
     },
     rgbToAnsi: {
-      value: (red, green2, blue) => styles3.ansi256ToAnsi(styles3.rgbToAnsi256(red, green2, blue)),
+      value: (red2, green2, blue) => styles3.ansi256ToAnsi(styles3.rgbToAnsi256(red2, green2, blue)),
       enumerable: false
     },
     hexToAnsi: {
@@ -19918,6 +19943,58 @@ function isValidBranchName(name) {
   return true;
 }
 
+// src/claude/version-check.ts
+var import_semver3 = __toESM(require_semver2(), 1);
+import { execSync } from "child_process";
+var CLAUDE_CLI_VERSION_RANGE = ">=2.0.74 <=2.0.76";
+function getClaudeCliVersion() {
+  const claudePath = process.env.CLAUDE_PATH || "claude";
+  try {
+    const output = execSync(`${claudePath} --version`, {
+      encoding: "utf8",
+      timeout: 5000,
+      stdio: ["pipe", "pipe", "pipe"]
+    }).trim();
+    const match = output.match(/^([\d.]+)/);
+    return match ? match[1] : null;
+  } catch {
+    return null;
+  }
+}
+function isVersionCompatible(version) {
+  const semverVersion = import_semver3.coerce(version);
+  if (!semverVersion)
+    return false;
+  return import_semver3.satisfies(semverVersion, CLAUDE_CLI_VERSION_RANGE);
+}
+function validateClaudeCli() {
+  const version = getClaudeCliVersion();
+  if (!version) {
+    return {
+      installed: false,
+      version: null,
+      compatible: false,
+      message: "Claude CLI not found. Install it with: npm install -g @anthropic-ai/claude-code"
+    };
+  }
+  const compatible = isVersionCompatible(version);
+  if (!compatible) {
+    return {
+      installed: true,
+      version,
+      compatible: false,
+      message: `Claude CLI version ${version} is not compatible. Required: ${CLAUDE_CLI_VERSION_RANGE}
+` + `Install a compatible version: npm install -g @anthropic-ai/claude-code@2.0.76`
+    };
+  }
+  return {
+    installed: true,
+    version,
+    compatible: true,
+    message: `Claude CLI ${version} \u2713`
+  };
+}
+
 // src/session/commands.ts
 var log9 = createLogger("commands");
 async function restartClaudeSession(session, cliOptions, ctx, actionName) {
@@ -19993,7 +20070,7 @@ async function changeDirectory(session, newDir, username, ctx) {
     await postError(session, `Directory does not exist: \`${newDir}\``);
     return;
   }
-  if (!statSync(absoluteDir).isDirectory()) {
+  if (!statSync2(absoluteDir).isDirectory()) {
     await postError(session, `Not a directory: \`${newDir}\``);
     return;
   }
@@ -20175,6 +20252,10 @@ async function updateSessionHeader(session, ctx) {
   if (otherParticipants) {
     rows.push(`| \uD83D\uDC65 **Participants** | ${otherParticipants} |`);
   }
+  const claudeVersion = getClaudeCliVersion();
+  if (claudeVersion) {
+    rows.push(`| \uD83E\uDD16 **Claude CLI** | \`${claudeVersion}\` |`);
+  }
   rows.push(`| \uD83C\uDD94 **Session ID** | \`${session.claudeSessionId.substring(0, 8)}\` |`);
   const updateInfo = getUpdateInfo();
   const updateNotice = updateInfo ? `
@@ -21304,7 +21385,9 @@ function formatHistoryEntry(session) {
 }
 async function buildStatusBar(sessionCount, config) {
   const items = [];
-  items.push(`\`v${VERSION}\``);
+  const claudeVersion = getClaudeCliVersion();
+  const versionStr = claudeVersion ? `v${VERSION} \xB7 CLI ${claudeVersion}` : `v${VERSION}`;
+  items.push(`\`${versionStr}\``);
   items.push(`\`${sessionCount}/${config.maxSessions} sessions\``);
   const permMode = config.skipPermissions ? "\u26A1 Auto" : "\uD83D\uDD10 Interactive";
   items.push(`\`${permMode}\``);
@@ -22103,7 +22186,7 @@ class SessionManager {
   }
 }
 // src/index.ts
-program.name("claude-threads").version(VERSION).description("Share Claude Code sessions in Mattermost").option("--url <url>", "Mattermost server URL").option("--token <token>", "Mattermost bot token").option("--channel <id>", "Mattermost channel ID").option("--bot-name <name>", "Bot mention name (default: claude-code)").option("--allowed-users <users>", "Comma-separated allowed usernames").option("--skip-permissions", "Skip interactive permission prompts").option("--no-skip-permissions", "Enable interactive permission prompts (override env)").option("--chrome", "Enable Claude in Chrome integration").option("--no-chrome", "Disable Claude in Chrome integration").option("--worktree-mode <mode>", "Git worktree mode: off, prompt, require (default: prompt)").option("--keep-alive", "Enable system sleep prevention (default: enabled)").option("--no-keep-alive", "Disable system sleep prevention").option("--setup", "Run interactive setup wizard (reconfigure existing settings)").option("--debug", "Enable debug logging").parse();
+program.name("claude-threads").version(VERSION).description("Share Claude Code sessions in Mattermost").option("--url <url>", "Mattermost server URL").option("--token <token>", "Mattermost bot token").option("--channel <id>", "Mattermost channel ID").option("--bot-name <name>", "Bot mention name (default: claude-code)").option("--allowed-users <users>", "Comma-separated allowed usernames").option("--skip-permissions", "Skip interactive permission prompts").option("--no-skip-permissions", "Enable interactive permission prompts (override env)").option("--chrome", "Enable Claude in Chrome integration").option("--no-chrome", "Disable Claude in Chrome integration").option("--worktree-mode <mode>", "Git worktree mode: off, prompt, require (default: prompt)").option("--keep-alive", "Enable system sleep prevention (default: enabled)").option("--no-keep-alive", "Disable system sleep prevention").option("--setup", "Run interactive setup wizard (reconfigure existing settings)").option("--debug", "Enable debug logging").option("--skip-version-check", "Skip Claude CLI version compatibility check").parse();
 var opts = program.opts();
 function hasRequiredCliArgs(args) {
   return !!(args.url && args.token && args.channel);
@@ -22151,11 +22234,21 @@ async function main() {
   }
   const config = newConfig;
   printLogo();
+  const claudeValidation = validateClaudeCli();
   console.log(dim(`  v${VERSION}`));
   console.log("");
   console.log(`  \uD83D\uDCC2 ${cyan(workingDir)}`);
   console.log(`  \uD83D\uDCAC ${cyan("@" + platformConfig.botName)}`);
   console.log(`  \uD83C\uDF10 ${dim(platformConfig.url)}`);
+  if (claudeValidation.installed) {
+    if (claudeValidation.compatible) {
+      console.log(`  \uD83E\uDD16 ${dim(`Claude CLI ${claudeValidation.version}`)}`);
+    } else {
+      console.log(`  \uD83E\uDD16 ${yellow(`Claude CLI ${claudeValidation.version} (incompatible)`)}`);
+    }
+  } else {
+    console.log(`  \uD83E\uDD16 ${red("Claude CLI not found")}`);
+  }
   if (platformConfig.skipPermissions) {
     console.log(`  \u26A0\uFE0F ${dim("Permissions disabled")}`);
   } else {
@@ -22168,6 +22261,13 @@ async function main() {
     console.log(`  \u2615 ${dim("Keep-alive enabled")}`);
   }
   console.log("");
+  if (!claudeValidation.compatible && !opts.skipVersionCheck) {
+    console.error(red(`  \u274C ${claudeValidation.message}`));
+    console.error("");
+    console.error(dim(`  Use --skip-version-check to bypass this check (not recommended)`));
+    console.error("");
+    process.exit(1);
+  }
   const mattermost = new MattermostClient(platformConfig);
   const session = new SessionManager(workingDir, platformConfig.skipPermissions, config.chrome, config.worktreeMode);
   session.addPlatform(platformConfig.id, mattermost);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "claude-threads",
-  "version": "0.31.2",
+  "version": "0.32.0",
   "description": "Share Claude Code sessions live in a Mattermost channel with interactive features",
   "main": "dist/index.js",
   "type": "module",