sessioncast-cli 2.0.7 → 2.0.9

package/README.md

@@ -26,6 +26,20 @@ Expand-Archive -Path "$env:TEMP\itmux.zip" -DestinationPath "C:\itmux" -Force
 npm install -g sessioncast-cli
 ```
 
+#### Use PowerShell in tmux sessions (recommended)
+
+By default, itmux opens sessions with bash. Sessions created by SessionCast automatically use PowerShell, but if you also want PowerShell when using itmux manually:
+
+```powershell
+# Create tmux config to use PowerShell as default shell
+$tmuxConf = "C:\itmux\home\$env:USERNAME\.tmux.conf"
+New-Item -Path $tmuxConf -ItemType File -Force
+Add-Content -Path $tmuxConf -Value 'set-option -g default-command "powershell.exe"'
+
+# For PowerShell 7+ (pwsh), use this instead:
+# Add-Content -Path $tmuxConf -Value 'set-option -g default-command "pwsh.exe"'
+```
+
 ## Quick Start
 
 ### 1. Login

package/dist/agent/runner.js

@@ -105,23 +105,38 @@ 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\n\n' +
+                    '  PowerShell as default shell (recommended):\n' +
+                    '    Sessions created by SessionCast automatically use PowerShell.\n' +
+                    '    For manual itmux sessions, add to C:\\itmux\\home\\<username>\\.tmux.conf:\n' +
+                    '      set-option -g default-command "powershell.exe"';
+            }
+            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.d.ts

@@ -70,6 +70,10 @@ export declare class WindowsTmuxExecutor implements TmuxExecutor {
     getVersion(): string | null;
     getActivePane(session: string): string | null;
     getPaneCwd(session: string, paneId?: string): string | null;
+    /**
+     * Detect the best Windows shell available (PowerShell 7 > Windows PowerShell > bash).
+     */
+    private detectWindowsShell;
     private escapeSession;
     private windowsToCygwinPath;
     /**

package/dist/agent/tmux-executor.js

@@ -368,6 +368,11 @@ class WindowsTmuxExecutor {
             else {
                 cmd = `tmux new-session -d -s '${sanitized}'`;
             }
+            // Use PowerShell as default shell for Windows sessions
+            const shell = this.detectWindowsShell();
+            if (shell) {
+                cmd += ` '${shell}'`;
+            }
             this.executeCommand(cmd);
             return true;
         }
@@ -414,6 +419,18 @@ class WindowsTmuxExecutor {
             return null;
         }
     }
+    /**
+     * Detect the best Windows shell available (PowerShell 7 > Windows PowerShell > bash).
+     */
+    detectWindowsShell() {
+        // Prefer PowerShell 7+ (pwsh.exe), then Windows PowerShell (powershell.exe)
+        for (const shell of ['pwsh.exe', 'powershell.exe']) {
+            const result = this.executeCommand(`command -v ${shell} 2>/dev/null`);
+            if (result)
+                return shell;
+        }
+        return null;
+    }
     escapeSession(session) {
         return session.replace(/'/g, "'\\''");
     }
@@ -436,12 +453,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 +487,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;
             }
         }
@@ -481,6 +517,11 @@ function createTmuxExecutor() {
                 '  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' +
+                '  PowerShell as default shell (recommended):\n' +
+                '    SessionCast automatically uses PowerShell for new sessions.\n' +
+                '    To also use PowerShell when opening itmux manually, create\n' +
+                '    C:\\itmux\\home\\<username>\\.tmux.conf with:\n' +
+                '      set-option -g default-command "powershell.exe"\n\n' +
                 '━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━\n');
         }
         return new WindowsTmuxExecutor(itmuxPath);

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 };
     }
@@ -106,6 +143,10 @@ function showWelcome() {
         if (isWindows) {
             console.log(chalk_1.default.gray('  Install itmux: https://github.com/itefixnet/itmux'));
             console.log(chalk_1.default.gray('  Or: choco install itmux'));
+            console.log('');
+            console.log(chalk_1.default.gray('  Use PowerShell in itmux sessions:'));
+            console.log(chalk_1.default.gray('    Add to C:\\itmux\\home\\<username>\\.tmux.conf:'));
+            console.log(chalk_1.default.gray('      set-option -g default-command "powershell.exe"'));
         }
         else if (os.platform() === 'darwin') {
             console.log(chalk_1.default.gray('  Install: brew install tmux'));

package/package.json

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