cli-remote-agent 1.0.5 → 1.0.7

package/dist/index.js

@@ -251,18 +251,58 @@ function startLocalControl(port, onHook) {
   return server;
 }
 
+// src/pty-helper-fix.ts
+var import_node_module = require("module");
+var import_node_child_process = require("child_process");
+var import_fs3 = __toESM(require("fs"));
+var import_path3 = __toESM(require("path"));
+function ensurePtyHelperExecutable() {
+  if (process.platform === "win32") return;
+  try {
+    const nodeRequire = (0, import_node_module.createRequire)(__filename);
+    const ptyMain = nodeRequire.resolve("node-pty");
+    const ptyDir = import_path3.default.dirname(import_path3.default.dirname(ptyMain));
+    const candidates = [import_path3.default.join(ptyDir, "build", "Release", "spawn-helper")];
+    const prebuilds = import_path3.default.join(ptyDir, "prebuilds");
+    try {
+      for (const d of import_fs3.default.readdirSync(prebuilds)) {
+        candidates.push(import_path3.default.join(prebuilds, d, "spawn-helper"));
+      }
+    } catch {
+    }
+    for (const file of candidates) {
+      try {
+        const mode = import_fs3.default.statSync(file).mode;
+        if (!(mode & 73)) {
+          import_fs3.default.chmodSync(file, mode | 493);
+          logger.info({ file }, "Restored execute bit on node-pty spawn-helper");
+        }
+      } catch {
+      }
+    }
+    if (process.platform === "darwin") {
+      (0, import_node_child_process.execFile)("xattr", ["-dr", "com.apple.quarantine", ptyDir], () => {
+      });
+    }
+  } catch (err) {
+    logger.warn({ error: err?.message }, "Could not verify node-pty spawn-helper permissions");
+  }
+}
+
 // src/tmux.ts
 var import_child_process2 = require("child_process");
 var import_util2 = require("util");
+var import_fs5 = __toESM(require("fs"));
+var import_path5 = __toESM(require("path"));
 
 // src/claude-live.ts
-var import_fs3 = __toESM(require("fs"));
-var import_path3 = __toESM(require("path"));
+var import_fs4 = __toESM(require("fs"));
+var import_path4 = __toESM(require("path"));
 var import_os2 = __toESM(require("os"));
 var import_child_process = require("child_process");
 var import_util = require("util");
 var execFileAsync = (0, import_util.promisify)(import_child_process.execFile);
-var LIVE_SESSIONS_DIR = import_path3.default.join(import_os2.default.homedir(), ".claude", "sessions");
+var LIVE_SESSIONS_DIR = import_path4.default.join(import_os2.default.homedir(), ".claude", "sessions");
 function isAlive(pid) {
   try {
     process.kill(pid, 0);
@@ -274,14 +314,14 @@ function isAlive(pid) {
 function getLiveClaudeSessions() {
   let files;
   try {
-    files = import_fs3.default.readdirSync(LIVE_SESSIONS_DIR).filter((f) => f.endsWith(".json"));
+    files = import_fs4.default.readdirSync(LIVE_SESSIONS_DIR).filter((f) => f.endsWith(".json"));
   } catch {
     return [];
   }
   const out = [];
   for (const f of files) {
     try {
-      const obj = JSON.parse(import_fs3.default.readFileSync(import_path3.default.join(LIVE_SESSIONS_DIR, f), "utf-8"));
+      const obj = JSON.parse(import_fs4.default.readFileSync(import_path4.default.join(LIVE_SESSIONS_DIR, f), "utf-8"));
       if (typeof obj?.pid !== "number" || !isAlive(obj.pid)) continue;
       out.push({
         pid: obj.pid,
@@ -320,8 +360,28 @@ function isDescendantOf(pid, ancestor, parents) {
 // src/tmux.ts
 var execFileAsync2 = (0, import_util2.promisify)(import_child_process2.execFile);
 var IS_WIN = process.platform === "win32";
+var cachedTmuxPath;
+function resolveTmuxPath() {
+  if (cachedTmuxPath !== void 0) return cachedTmuxPath;
+  const dirs = (process.env.PATH || "").split(import_path5.default.delimiter).filter(Boolean);
+  for (const extra of ["/opt/homebrew/bin", "/usr/local/bin", "/usr/bin", "/bin", "/opt/local/bin"]) {
+    if (!dirs.includes(extra)) dirs.push(extra);
+  }
+  for (const dir of dirs) {
+    const candidate = import_path5.default.join(dir, "tmux");
+    try {
+      import_fs5.default.accessSync(candidate, import_fs5.default.constants.X_OK);
+      cachedTmuxPath = candidate;
+      return candidate;
+    } catch {
+    }
+  }
+  cachedTmuxPath = null;
+  return null;
+}
 function tmuxCmd(args) {
-  return IS_WIN ? { file: "wsl.exe", args: ["tmux", ...args] } : { file: "tmux", args };
+  if (IS_WIN) return { file: "wsl.exe", args: ["tmux", ...args] };
+  return { file: resolveTmuxPath() || "tmux", args };
 }
 async function listTmuxSessions() {
   const fmt = "#{session_name}	#{session_windows}	#{session_attached}	#{session_activity}";
@@ -360,8 +420,8 @@ async function enrichWithPanesAndClaude(sessions2) {
     const { file, args } = tmuxCmd(["list-panes", "-a", "-F", paneFmt]);
     const { stdout } = await execFileAsync2(file, args, { timeout: 6e3 });
     const panes = stdout.split("\n").map((line) => line.replace(/\r$/, "").trim()).filter(Boolean).map((line) => {
-      const [session, pid, path8, activeFlags] = line.split("	");
-      return { session, pid: parseInt(pid, 10) || 0, path: path8 || "", active: activeFlags === "11" };
+      const [session, pid, path10, activeFlags] = line.split("	");
+      return { session, pid: parseInt(pid, 10) || 0, path: path10 || "", active: activeFlags === "11" };
     });
     const byName = new Map(sessions2.map((s) => [s.name, s]));
     for (const pane of panes) {
@@ -383,21 +443,35 @@ async function enrichWithPanesAndClaude(sessions2) {
   } catch {
   }
 }
-function shq(v) {
-  return `'${v.replace(/'/g, `'\\''`)}'`;
-}
-function buildTmuxLaunch(name, launch, shell) {
+function buildTmuxLaunch(name, launch) {
   const trimmed = launch && launch.trim() ? launch.trim() : void 0;
   if (IS_WIN) {
-    const args = ["tmux", "new-session", "-A", "-s", name];
-    if (trimmed) args.push(trimmed);
-    return { file: "wsl.exe", args };
-  }
-  let cmd = `tmux set-option -g aggressive-resize on 2>/dev/null; exec tmux new-session -A -s ${shq(name)}`;
-  if (trimmed) cmd += ` ${shq(trimmed)}`;
-  return { file: shell, args: ["-l", "-c", cmd] };
+    const args2 = ["tmux", "new-session", "-A", "-s", name];
+    if (trimmed) args2.push(trimmed);
+    return { file: "wsl.exe", args: args2 };
+  }
+  const tmuxBin = resolveTmuxPath();
+  if (!tmuxBin) return null;
+  execFileAsync2(tmuxBin, ["set-option", "-g", "aggressive-resize", "on"], { timeout: 4e3 }).catch(
+    () => {
+    }
+  );
+  const args = ["new-session", "-A", "-s", name];
+  if (trimmed) args.push(trimmed);
+  return { file: tmuxBin, args };
 }
 
+// src/heartbeat.ts
+var import_os4 = __toESM(require("os"));
+var import_path7 = __toESM(require("path"));
+var import_child_process4 = require("child_process");
+
+// src/pty-session.ts
+var pty = __toESM(require("node-pty"));
+var import_fs6 = require("fs");
+var import_path6 = require("path");
+var import_os3 = require("os");
+
 // src/shell.ts
 var import_child_process3 = require("child_process");
 function detectShell(preference) {
@@ -413,33 +487,24 @@ function detectShell(preference) {
   return process.env.SHELL || "/bin/bash";
 }
 
-// src/heartbeat.ts
-var import_os4 = __toESM(require("os"));
-var import_path5 = __toESM(require("path"));
-var import_child_process4 = require("child_process");
-
 // src/pty-session.ts
-var pty = __toESM(require("node-pty"));
-var import_fs4 = require("fs");
-var import_path4 = require("path");
-var import_os3 = require("os");
 var THRESHOLD = 3;
-var INIT_DIR = (0, import_path4.join)((0, import_os3.tmpdir)(), "crc-shell-init");
-var BASH_INIT = (0, import_path4.join)(INIT_DIR, "bashrc");
-var ZSH_DIR = (0, import_path4.join)(INIT_DIR, "zsh");
-var ZSH_RC = (0, import_path4.join)(ZSH_DIR, ".zshrc");
-var ZSH_ENV = (0, import_path4.join)(ZSH_DIR, ".zshenv");
+var INIT_DIR = (0, import_path6.join)((0, import_os3.tmpdir)(), "crc-shell-init");
+var BASH_INIT = (0, import_path6.join)(INIT_DIR, "bashrc");
+var ZSH_DIR = (0, import_path6.join)(INIT_DIR, "zsh");
+var ZSH_RC = (0, import_path6.join)(ZSH_DIR, ".zshrc");
+var ZSH_ENV = (0, import_path6.join)(ZSH_DIR, ".zshenv");
 var INIT_VERSION = "2";
 function ensureInitFiles() {
-  const versionFile = (0, import_path4.join)(INIT_DIR, ".version");
-  if ((0, import_fs4.existsSync)(versionFile)) {
+  const versionFile = (0, import_path6.join)(INIT_DIR, ".version");
+  if ((0, import_fs6.existsSync)(versionFile)) {
     try {
-      if ((0, import_fs4.readFileSync)(versionFile, "utf-8").trim() === INIT_VERSION) return;
+      if ((0, import_fs6.readFileSync)(versionFile, "utf-8").trim() === INIT_VERSION) return;
     } catch {
     }
   }
-  (0, import_fs4.mkdirSync)(ZSH_DIR, { recursive: true });
-  (0, import_fs4.writeFileSync)(BASH_INIT, [
+  (0, import_fs6.mkdirSync)(ZSH_DIR, { recursive: true });
+  (0, import_fs6.writeFileSync)(BASH_INIT, [
     "[ -f ~/.bash_profile ] && source ~/.bash_profile",
     "[ -f ~/.bashrc ] && source ~/.bashrc",
     "__crc_s=$SECONDS",
@@ -450,11 +515,11 @@ function ensureInitFiles() {
     `PROMPT_COMMAND='[ "$__crc_armed" = 1 ] && [ \${__crc_elapsed:-0} -ge ${THRESHOLD} ] && printf "\\a"; __crc_armed=1; eval "$__crc_orig_pc"'`,
     ""
   ].join("\n"), "utf-8");
-  (0, import_fs4.writeFileSync)(ZSH_ENV, [
+  (0, import_fs6.writeFileSync)(ZSH_ENV, [
     '[ -f "${ZDOTDIR_ORIG:-$HOME}/.zshenv" ] && source "${ZDOTDIR_ORIG:-$HOME}/.zshenv"',
     ""
   ].join("\n"), "utf-8");
-  (0, import_fs4.writeFileSync)(ZSH_RC, [
+  (0, import_fs6.writeFileSync)(ZSH_RC, [
     '[ -f "${ZDOTDIR_ORIG:-$HOME}/.zshrc" ] && source "${ZDOTDIR_ORIG:-$HOME}/.zshrc"',
     "__crc_s=$SECONDS",
     "__crc_armed=0",
@@ -467,14 +532,14 @@ function ensureInitFiles() {
     "fi",
     ""
   ].join("\n"), "utf-8");
-  (0, import_fs4.writeFileSync)(versionFile, INIT_VERSION, "utf-8");
+  (0, import_fs6.writeFileSync)(versionFile, INIT_VERSION, "utf-8");
 }
 function resolveCwd(cwd) {
   const candidates = process.platform === "win32" ? [cwd, (0, import_os3.homedir)(), process.env.USERPROFILE, process.env.HOME] : [cwd, (0, import_os3.homedir)(), process.env.HOME, process.env.USERPROFILE];
   for (const c of candidates) {
     if (c) {
       try {
-        if ((0, import_fs4.existsSync)(c)) return c;
+        if ((0, import_fs6.existsSync)(c)) return c;
       } catch {
       }
     }
@@ -700,7 +765,7 @@ function buildHeartbeat(homeDir) {
     memoryUsage: Math.round((totalMem - freeMem) / totalMem * 100),
     uptime: Math.round(import_os4.default.uptime()),
     activeSessions: getActiveSessionCount(),
-    pathSeparator: import_path5.default.sep,
+    pathSeparator: import_path7.default.sep,
     homeDirectory: homeDir || import_os4.default.homedir(),
     rootPaths: getRootPaths(),
     capabilities: { terminal: true, fileTransfer: false }
@@ -708,33 +773,33 @@ function buildHeartbeat(homeDir) {
 }
 
 // src/file-explorer.ts
-var import_fs5 = __toESM(require("fs"));
-var import_path6 = __toESM(require("path"));
+var import_fs7 = __toESM(require("fs"));
+var import_path8 = __toESM(require("path"));
 var import_os5 = __toESM(require("os"));
-var SECRET_DIR = import_path6.default.join(import_os5.default.homedir(), ".crc-agent");
+var SECRET_DIR = import_path8.default.join(import_os5.default.homedir(), ".crc-agent");
 function isInSecretDir(resolved) {
-  const rel = import_path6.default.relative(SECRET_DIR, resolved);
-  return rel === "" || !rel.startsWith(".." + import_path6.default.sep) && rel !== ".." && !import_path6.default.isAbsolute(rel);
+  const rel = import_path8.default.relative(SECRET_DIR, resolved);
+  return rel === "" || !rel.startsWith(".." + import_path8.default.sep) && rel !== ".." && !import_path8.default.isAbsolute(rel);
 }
 function listDirectory(dirPath) {
   try {
-    const resolved = import_path6.default.resolve(dirPath);
+    const resolved = import_path8.default.resolve(dirPath);
     if (isInSecretDir(resolved)) {
       return { entries: [], error: "Access denied" };
     }
-    if (!import_fs5.default.existsSync(resolved)) {
+    if (!import_fs7.default.existsSync(resolved)) {
       return { entries: [], error: "Path does not exist" };
     }
-    const stat = import_fs5.default.statSync(resolved);
+    const stat = import_fs7.default.statSync(resolved);
     if (!stat.isDirectory()) {
       return { entries: [], error: "Not a directory" };
     }
-    const dirents = import_fs5.default.readdirSync(resolved, { withFileTypes: true });
+    const dirents = import_fs7.default.readdirSync(resolved, { withFileTypes: true });
     const entries = [];
     for (const dirent of dirents) {
       try {
-        const fullPath = import_path6.default.join(resolved, dirent.name);
-        const s = import_fs5.default.statSync(fullPath);
+        const fullPath = import_path8.default.join(resolved, dirent.name);
+        const s = import_fs7.default.statSync(fullPath);
         entries.push({
           name: dirent.name,
           isDirectory: dirent.isDirectory(),
@@ -756,22 +821,22 @@ function listDirectory(dirPath) {
 }
 async function downloadFile(filePath, serverUrl, secret, agentId) {
   try {
-    const resolved = import_path6.default.resolve(filePath);
+    const resolved = import_path8.default.resolve(filePath);
     if (isInSecretDir(resolved)) {
       return { error: "Access denied" };
     }
-    if (!import_fs5.default.existsSync(resolved)) {
+    if (!import_fs7.default.existsSync(resolved)) {
       return { error: "File does not exist" };
     }
-    const stat = import_fs5.default.statSync(resolved);
+    const stat = import_fs7.default.statSync(resolved);
     if (stat.isDirectory()) {
       return { error: "Cannot download a directory" };
     }
     if (stat.size > FILE_MAX_SIZE) {
       return { error: `File too large (max ${FILE_MAX_SIZE} bytes)` };
     }
-    const fileName = import_path6.default.basename(resolved);
-    const fileStream = import_fs5.default.createReadStream(resolved);
+    const fileName = import_path8.default.basename(resolved);
+    const fileStream = import_fs7.default.createReadStream(resolved);
     const baseUrl = serverUrl.replace("wss://", "https://").replace("ws://", "http://");
     const url = `${baseUrl}/api/files/receive`;
     const res = await fetch(url, {
@@ -804,13 +869,13 @@ async function downloadFile(filePath, serverUrl, secret, agentId) {
 // src/vpn-manager.ts
 var import_child_process5 = require("child_process");
 var import_util3 = require("util");
-var import_fs6 = __toESM(require("fs"));
-var import_path7 = __toESM(require("path"));
+var import_fs8 = __toESM(require("fs"));
+var import_path9 = __toESM(require("path"));
 var import_os6 = __toESM(require("os"));
 var execAsync = (0, import_util3.promisify)(import_child_process5.exec);
 var isWindows = process.platform === "win32";
-var VPN_DIR = import_path7.default.join(import_os6.default.homedir(), ".crc-agent", "vpn");
-function shq2(value) {
+var VPN_DIR = import_path9.default.join(import_os6.default.homedir(), ".crc-agent", "vpn");
+function shq(value) {
   return value.replace(/'/g, "'\\''");
 }
 function psq(value) {
@@ -828,11 +893,11 @@ async function runCmd(cmd, shell) {
 }
 function getConfigPath(profile) {
   const file = profile.configFile || `${profile.id}.conf`;
-  if (import_path7.default.isAbsolute(file)) return file;
-  return import_path7.default.join(VPN_DIR, file);
+  if (import_path9.default.isAbsolute(file)) return file;
+  return import_path9.default.join(VPN_DIR, file);
 }
 async function getScutilStatus(serviceName) {
-  const { stdout } = await runCmd(`scutil --nc status '${shq2(serviceName)}'`);
+  const { stdout } = await runCmd(`scutil --nc status '${shq(serviceName)}'`);
   const firstLine = stdout.trim().split("\n")[0];
   if (firstLine === "Connected") return "connected";
   if (firstLine === "Connecting") return "connecting";
@@ -840,11 +905,11 @@ async function getScutilStatus(serviceName) {
   return "disconnected";
 }
 async function scutilStart(serviceName) {
-  const { stderr } = await runCmd(`scutil --nc start '${shq2(serviceName)}'`);
+  const { stderr } = await runCmd(`scutil --nc start '${shq(serviceName)}'`);
   return stderr || null;
 }
 async function scutilStop(serviceName) {
-  const { stderr } = await runCmd(`scutil --nc stop '${shq2(serviceName)}'`);
+  const { stderr } = await runCmd(`scutil --nc stop '${shq(serviceName)}'`);
   return stderr || null;
 }
 async function runOsascript(script) {
@@ -893,7 +958,7 @@ async function getWireGuardStatus(profile) {
     return getScutilStatus(profile.serviceName);
   }
   const tunnelName = profile.tunnelName || profile.id;
-  const { stdout } = await runCmd(`wg show '${shq2(tunnelName)}' 2>/dev/null`);
+  const { stdout } = await runCmd(`wg show '${shq(tunnelName)}' 2>/dev/null`);
   return stdout.trim() ? "connected" : "disconnected";
 }
 async function getOpenVpnStatus(profile) {
@@ -945,7 +1010,7 @@ async function connectWireGuard(profile) {
   const tunnelName = profile.tunnelName || profile.id;
   if (isWindows) {
     const confPath2 = getConfigPath(profile);
-    if (!import_fs6.default.existsSync(confPath2)) {
+    if (!import_fs8.default.existsSync(confPath2)) {
       return `Config file not found: ${confPath2}`;
     }
     const script = `
@@ -965,13 +1030,13 @@ async function connectWireGuard(profile) {
     return scutilStart(profile.serviceName);
   }
   const confPath = getConfigPath(profile);
-  const { stderr } = await runCmd(`sudo wg-quick up '${shq2(confPath)}'`);
+  const { stderr } = await runCmd(`sudo wg-quick up '${shq(confPath)}'`);
   return stderr || null;
 }
 async function connectOpenVpn(profile) {
   if (isWindows) {
     const confPath2 = getConfigPath(profile);
-    if (!import_fs6.default.existsSync(confPath2)) {
+    if (!import_fs8.default.existsSync(confPath2)) {
       return `Config file not found: ${confPath2}`;
     }
     const connector = "C:\\Program Files\\OpenVPN Connect\\ovpnconnector.exe";
@@ -998,16 +1063,16 @@ async function connectOpenVpn(profile) {
     return scutilStart(profile.serviceName);
   }
   const confPath = getConfigPath(profile);
-  if (!import_fs6.default.existsSync(confPath)) {
+  if (!import_fs8.default.existsSync(confPath)) {
     return `Config file not found: ${confPath}`;
   }
-  const { stderr } = await runCmd(`sudo openvpn --config '${shq2(confPath)}' --daemon`);
+  const { stderr } = await runCmd(`sudo openvpn --config '${shq(confPath)}' --daemon`);
   return stderr || null;
 }
 async function connectAzure(profile) {
   if (isWindows) {
     const confPath = getConfigPath(profile);
-    if (!import_fs6.default.existsSync(confPath)) {
+    if (!import_fs8.default.existsSync(confPath)) {
       return `Config file not found: ${confPath}`;
     }
     await runCmd(`& 'AzureVpn.exe' -i '${psq(confPath)}' 2>&1`);
@@ -1051,7 +1116,7 @@ async function disconnectWireGuard(profile) {
     return scutilStop(profile.serviceName);
   }
   const confPath = getConfigPath(profile);
-  const { stderr } = await runCmd(`sudo wg-quick down '${shq2(confPath)}'`);
+  const { stderr } = await runCmd(`sudo wg-quick down '${shq(confPath)}'`);
   return stderr || null;
 }
 async function disconnectOpenVpn(profile) {
@@ -1129,8 +1194,8 @@ async function disconnectVpn(configs, profileId) {
 }
 
 // src/claude-sessions.ts
-var import_fs7 = __toESM(require("fs"));
-var import_path8 = __toESM(require("path"));
+var import_fs9 = __toESM(require("fs"));
+var import_path10 = __toESM(require("path"));
 var import_os7 = __toESM(require("os"));
 var import_readline = __toESM(require("readline"));
 
@@ -1158,10 +1223,10 @@ function findProjectDirs(allDirs, filterProjectPath) {
 }
 
 // src/claude-sessions.ts
-var CLAUDE_PROJECTS_DIR = import_path8.default.join(import_os7.default.homedir(), ".claude", "projects");
+var CLAUDE_PROJECTS_DIR = import_path10.default.join(import_os7.default.homedir(), ".claude", "projects");
 async function parseSessionFile(filePath) {
   try {
-    const stream = import_fs7.default.createReadStream(filePath, { encoding: "utf-8" });
+    const stream = import_fs9.default.createReadStream(filePath, { encoding: "utf-8" });
     const rl = import_readline.default.createInterface({ input: stream, crlfDelay: Infinity });
     let firstMessage = "";
     let lastTimestamp = "";
@@ -1209,17 +1274,17 @@ async function parseSessionFile(filePath) {
 }
 async function listClaudeSessions(filterProjectPath) {
   const sessions2 = [];
-  if (!import_fs7.default.existsSync(CLAUDE_PROJECTS_DIR)) return sessions2;
+  if (!import_fs9.default.existsSync(CLAUDE_PROJECTS_DIR)) return sessions2;
   const isDirSafe = (d) => {
     try {
-      return import_fs7.default.statSync(import_path8.default.join(CLAUDE_PROJECTS_DIR, d)).isDirectory();
+      return import_fs9.default.statSync(import_path10.default.join(CLAUDE_PROJECTS_DIR, d)).isDirectory();
     } catch {
       return false;
     }
   };
   let allEntries;
   try {
-    allEntries = import_fs7.default.readdirSync(CLAUDE_PROJECTS_DIR);
+    allEntries = import_fs9.default.readdirSync(CLAUDE_PROJECTS_DIR);
   } catch {
     return sessions2;
   }
@@ -1232,16 +1297,16 @@ async function listClaudeSessions(filterProjectPath) {
     projectDirs = allEntries.filter((d) => isDirSafe(d) && !d.startsWith("-private-"));
   }
   for (const dirName of projectDirs) {
-    const dirPath = import_path8.default.join(CLAUDE_PROJECTS_DIR, dirName);
+    const dirPath = import_path10.default.join(CLAUDE_PROJECTS_DIR, dirName);
     let files;
     try {
-      files = import_fs7.default.readdirSync(dirPath).filter((f) => f.endsWith(".jsonl"));
+      files = import_fs9.default.readdirSync(dirPath).filter((f) => f.endsWith(".jsonl"));
     } catch {
       continue;
     }
     for (const file of files) {
       const sessionId = file.replace(".jsonl", "");
-      const parsed = await parseSessionFile(import_path8.default.join(dirPath, file));
+      const parsed = await parseSessionFile(import_path10.default.join(dirPath, file));
       if (!parsed) continue;
       const projectPath = parsed.cwd || dirName.replace(/^-/, "/").replace(/-/g, "/");
       sessions2.push({
@@ -1261,21 +1326,21 @@ async function listClaudeSessions(filterProjectPath) {
 }
 
 // src/claude-conversation.ts
-var import_fs8 = __toESM(require("fs"));
-var import_path9 = __toESM(require("path"));
+var import_fs10 = __toESM(require("fs"));
+var import_path11 = __toESM(require("path"));
 var import_os8 = __toESM(require("os"));
 var import_readline2 = __toESM(require("readline"));
-var CLAUDE_PROJECTS_DIR2 = import_path9.default.join(import_os8.default.homedir(), ".claude", "projects");
+var CLAUDE_PROJECTS_DIR2 = import_path11.default.join(import_os8.default.homedir(), ".claude", "projects");
 function findProjectDir(projectPath) {
   const encoded = encodeProjectPath(projectPath);
-  const dirPath = import_path9.default.join(CLAUDE_PROJECTS_DIR2, encoded);
-  if (import_fs8.default.existsSync(dirPath)) return dirPath;
-  if (!import_fs8.default.existsSync(CLAUDE_PROJECTS_DIR2)) return null;
+  const dirPath = import_path11.default.join(CLAUDE_PROJECTS_DIR2, encoded);
+  if (import_fs10.default.existsSync(dirPath)) return dirPath;
+  if (!import_fs10.default.existsSync(CLAUDE_PROJECTS_DIR2)) return null;
   let allDirs;
   try {
-    allDirs = import_fs8.default.readdirSync(CLAUDE_PROJECTS_DIR2).filter((d) => {
+    allDirs = import_fs10.default.readdirSync(CLAUDE_PROJECTS_DIR2).filter((d) => {
       try {
-        return import_fs8.default.statSync(import_path9.default.join(CLAUDE_PROJECTS_DIR2, d)).isDirectory();
+        return import_fs10.default.statSync(import_path11.default.join(CLAUDE_PROJECTS_DIR2, d)).isDirectory();
       } catch {
         return false;
       }
@@ -1285,23 +1350,23 @@ function findProjectDir(projectPath) {
   }
   const matches = findProjectDirs(allDirs, projectPath);
   if (matches.length > 0) {
-    return import_path9.default.join(CLAUDE_PROJECTS_DIR2, matches[0]);
+    return import_path11.default.join(CLAUDE_PROJECTS_DIR2, matches[0]);
   }
   return null;
 }
 function findSessionFileById(sessionId) {
   if (!/^[A-Za-z0-9._-]+$/.test(sessionId)) return null;
-  if (!import_fs8.default.existsSync(CLAUDE_PROJECTS_DIR2)) return null;
+  if (!import_fs10.default.existsSync(CLAUDE_PROJECTS_DIR2)) return null;
   let dirs;
   try {
-    dirs = import_fs8.default.readdirSync(CLAUDE_PROJECTS_DIR2);
+    dirs = import_fs10.default.readdirSync(CLAUDE_PROJECTS_DIR2);
   } catch {
     return null;
   }
   for (const dir of dirs) {
-    const candidate = import_path9.default.join(CLAUDE_PROJECTS_DIR2, dir, `${sessionId}.jsonl`);
+    const candidate = import_path11.default.join(CLAUDE_PROJECTS_DIR2, dir, `${sessionId}.jsonl`);
     try {
-      if (import_fs8.default.statSync(candidate).isFile()) return candidate;
+      if (import_fs10.default.statSync(candidate).isFile()) return candidate;
     } catch {
     }
   }
@@ -1312,20 +1377,20 @@ function findLatestSessionFile(projectPath) {
   if (!dirPath) return null;
   let entries;
   try {
-    entries = import_fs8.default.readdirSync(dirPath);
+    entries = import_fs10.default.readdirSync(dirPath);
   } catch {
     return null;
   }
   const files = entries.filter((f) => f.endsWith(".jsonl") && !f.includes("/")).map((f) => {
     try {
-      return { name: f, mtime: import_fs8.default.statSync(import_path9.default.join(dirPath, f)).mtimeMs };
+      return { name: f, mtime: import_fs10.default.statSync(import_path11.default.join(dirPath, f)).mtimeMs };
     } catch {
       return null;
     }
   }).filter((f) => f !== null).sort((a, b) => b.mtime - a.mtime);
   if (files.length === 0) return null;
   return {
-    filePath: import_path9.default.join(dirPath, files[0].name),
+    filePath: import_path11.default.join(dirPath, files[0].name),
     sessionId: files[0].name.replace(".jsonl", "")
   };
 }
@@ -1335,8 +1400,8 @@ async function readConversation(projectPath, afterLine = 0, specificSessionId) {
   if (specificSessionId) {
     sessionId = specificSessionId;
     const dirPath = findProjectDir(projectPath);
-    const direct = dirPath ? import_path9.default.join(dirPath, `${specificSessionId}.jsonl`) : null;
-    if (direct && import_fs8.default.existsSync(direct)) {
+    const direct = dirPath ? import_path11.default.join(dirPath, `${specificSessionId}.jsonl`) : null;
+    if (direct && import_fs10.default.existsSync(direct)) {
       filePath = direct;
     } else {
       const byId = findSessionFileById(specificSessionId);
@@ -1350,7 +1415,7 @@ async function readConversation(projectPath, afterLine = 0, specificSessionId) {
     sessionId = found.sessionId;
   }
   try {
-    const stream = import_fs8.default.createReadStream(filePath, { encoding: "utf-8" });
+    const stream = import_fs10.default.createReadStream(filePath, { encoding: "utf-8" });
     const rl = import_readline2.default.createInterface({ input: stream, crlfDelay: Infinity });
     const messages = [];
     let lineNum = 0;
@@ -1439,6 +1504,7 @@ if (!isConfigured()) {
 }
 var config = loadConfig();
 logger.info({ agentId: config.agentId, serverUrl: config.serverUrl }, "Starting agent");
+ensurePtyHelperExecutable();
 process.on("unhandledRejection", (reason) => {
   logger.error({ reason }, "Unhandled promise rejection (agent kept alive)");
 });
@@ -1498,7 +1564,18 @@ startLocalControl(LOCAL_CONTROL_PORT, (raw) => {
 socket.on(TERMINAL_OPEN, (payload) => {
   const { sessionId, cols, rows, tmux, launch } = payload;
   if (!sessionId) return;
-  const launchSpec = tmux ? buildTmuxLaunch(tmux, launch, detectShell(config.shell)) : void 0;
+  let launchSpec;
+  if (tmux) {
+    const spec = buildTmuxLaunch(tmux, launch);
+    if (!spec) {
+      const msg = "\r\n\x1B[31mtmux is not installed on this machine.\x1B[0m\r\nInstall it to use tmux mirroring:\r\n  macOS:  brew install tmux\r\n  Linux:  sudo apt install tmux  (or your package manager)\r\n\r\n";
+      socket.emit(TERMINAL_OUTPUT, { sessionId, data: msg });
+      socket.emit(TERMINAL_EXIT, { sessionId, exitCode: 1 });
+      logger.warn({ sessionId, tmux }, "tmux launch requested but tmux not found");
+      return;
+    }
+    launchSpec = spec;
+  }
   createTerminalSession(
     sessionId,
     cols,