sessioncast-cli 2.0.7 → 2.0.8

package/dist/agent/runner.js

@@ -105,23 +105,34 @@ class AgentRunner {
         console.log(`Machine ID: ${this.config.machineId}`);
         console.log(`Relay: ${this.config.relay}`);
         console.log(`Token: ${this.config.token ? 'present' : 'none'}`);
-        // Check tmux availability before starting
+        // Check tmux/itmux availability before starting
         if (!tmux.isAvailable()) {
             const platform = os.platform();
             let installHint;
-            if (platform === 'darwin') {
+            if (platform === 'win32') {
+                installHint = '  itmux required for Windows\n\n' +
+                    '  Download: https://github.com/itefixnet/itmux/releases/latest\n' +
+                    '  Or set ITMUX_HOME environment variable\n\n' +
+                    '  Quick install (PowerShell):\n' +
+                    '    Invoke-WebRequest -Uri "https://github.com/itefixnet/itmux/releases/download/v1.1.0/itmux_1.1.0_x64_free.zip" -OutFile "$env:TEMP\\itmux.zip"\n' +
+                    '    Expand-Archive -Path "$env:TEMP\\itmux.zip" -DestinationPath "C:\\itmux" -Force\n\n' +
+                    '  Or with Chocolatey:\n' +
+                    '    choco install itmux';
+            }
+            else if (platform === 'darwin') {
                 installHint = '  Install: brew install tmux';
             }
             else {
                 installHint = '  Install: sudo apt install tmux  (Debian/Ubuntu)\n' +
                     '           sudo yum install tmux  (RHEL/CentOS)';
             }
+            const binaryName = platform === 'win32' ? 'itmux' : 'tmux';
             throw new Error('\n━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━\n' +
-                '  tmux not found - required for SessionCast Agent\n' +
+                `  ${binaryName} not found - required for SessionCast Agent\n` +
                 '━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━\n\n' +
                 `${installHint}\n\n` +
-                '  After installing, start a tmux session:\n' +
-                '    tmux new -s main\n\n' +
+                `  After installing, start a ${binaryName} session:\n` +
+                `    ${binaryName} new -s main\n\n` +
                 '  Then run the agent:\n' +
                 '    sessioncast agent\n\n' +
                 '━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━');

package/dist/agent/tmux-executor.js

@@ -436,12 +436,31 @@ class WindowsTmuxExecutor {
      * Find itmux installation path on Windows.
      */
     static findItmuxPath() {
-        // 1. Check environment variable
+        const checkBashPath = (basePath) => {
+            return fs.existsSync(path.join(basePath, 'bin', 'bash.exe'));
+        };
+        // 1. Check environment variable (highest priority)
         const envPath = process.env.ITMUX_HOME;
-        if (envPath && fs.existsSync(path.join(envPath, 'bin', 'bash.exe'))) {
+        if (envPath && checkBashPath(envPath)) {
             return envPath;
         }
-        // 2. Check common locations
+        // 2. Check PATH (covers Chocolatey, manual installs, etc.)
+        const pathEnv = process.env.PATH || '';
+        const pathSep = pathEnv.includes(';') ? ';' : ':';
+        const dirs = pathEnv.split(pathSep);
+        for (const dir of dirs) {
+            const normalizedDir = dir.toLowerCase();
+            if (normalizedDir.includes('itmux') || normalizedDir.includes('cygwin')) {
+                let checkPath = dir;
+                if (dir.endsWith('\\bin') || dir.endsWith('/bin')) {
+                    checkPath = path.dirname(dir);
+                }
+                if (checkBashPath(checkPath)) {
+                    return checkPath;
+                }
+            }
+        }
+        // 3. Check hardcoded paths as fallback
         const locations = [
             path.join(os.homedir(), 'itmux'),
             'C:\\itmux',
@@ -451,7 +470,7 @@ class WindowsTmuxExecutor {
             path.join(process.env.ProgramFiles || '', 'itmux'),
         ];
         for (const loc of locations) {
-            if (loc && fs.existsSync(path.join(loc, 'bin', 'bash.exe'))) {
+            if (loc && checkBashPath(loc)) {
                 return loc;
             }
         }

package/dist/agent/tmux.js

@@ -127,7 +127,12 @@ function isAvailable() {
     try {
         return getExecutor().isAvailable();
     }
-    catch {
+    catch (error) {
+        // If it's the itmux not found error, re-throw to preserve Windows context
+        // so the user gets the detailed Windows instructions from runner.ts
+        if (error instanceof Error && error.message.includes('itmux not found')) {
+            throw error;
+        }
         return false;
     }
 }

package/dist/index.js

@@ -65,20 +65,57 @@ process.on('unhandledRejection', async (reason) => {
 function checkTmux() {
     const isWindows = os.platform() === 'win32';
     if (isWindows) {
-        // Check for itmux on Windows
+        // Helper function to check if bash.exe exists in a path
+        function checkBashPath(basePath) {
+            try {
+                const fs = require('fs');
+                const path = require('path');
+                return fs.existsSync(path.join(basePath, 'bin', 'bash.exe'));
+            }
+            catch {
+                return false;
+            }
+        }
+        // Check PATH for itmux (covers Chocolatey, manual PATH additions, etc.)
+        function checkItmuxInPath() {
+            const pathEnv = process.env.PATH || '';
+            const pathSep = pathEnv.includes(';') ? ';' : ':';
+            const dirs = pathEnv.split(pathSep);
+            const path = require('path');
+            for (const dir of dirs) {
+                const normalizedDir = dir.toLowerCase();
+                if (normalizedDir.includes('itmux') || normalizedDir.includes('cygwin')) {
+                    let checkPath = dir;
+                    // If we're in the bin folder, go up one level
+                    if (dir.endsWith('\\bin') || dir.endsWith('/bin')) {
+                        checkPath = path.dirname(dir);
+                    }
+                    if (checkBashPath(checkPath)) {
+                        return checkPath;
+                    }
+                }
+            }
+            return null;
+        }
+        // 1. Check environment variable first (highest priority)
+        if (process.env.ITMUX_HOME && checkBashPath(process.env.ITMUX_HOME)) {
+            return { available: true, isWindows: true };
+        }
+        // 2. Check PATH (covers Chocolatey, manual PATH additions, etc.)
+        if (checkItmuxInPath()) {
+            return { available: true, isWindows: true };
+        }
+        // 3. Check hardcoded paths as fallback
         const paths = [
-            process.env.ITMUX_HOME,
             `${os.homedir()}/itmux`,
             'C:\\itmux',
             `${os.homedir()}\\itmux`,
             'C:\\Program Files\\itmux',
         ].filter(Boolean);
         for (const p of paths) {
-            try {
-                require('fs').accessSync(p);
+            if (checkBashPath(p)) {
                 return { available: true, isWindows: true };
             }
-            catch { }
         }
         return { available: false, isWindows: true };
     }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "sessioncast-cli",
-  "version": "2.0.7",
+  "version": "2.0.8",
   "description": "SessionCast CLI - Control your agents from anywhere",
   "main": "dist/index.js",
   "bin": {