sandboxbox 2.2.3 → 2.2.4

package/CLAUDE.md

@@ -76,10 +76,12 @@ if (process.platform === 'win32' && isBundled) {
 
 ### Portable Podman Architecture
 - **Direct Podman Execution**: Uses bundled Podman binary without complex machine management
-- **Rootless Operation**: Always runs in rootless mode for portability
+- **Rootless Operation**: Always runs in rootless mode for portability (--rootful=false)
 - **Self-Contained**: All dependencies included in the package
-- **Simple Configuration**: No complex connection or machine setup required
+- **Simple Configuration**: Minimal backend setup only when needed
 - **Auto-Download**: Downloads platform-specific binaries automatically
+- **NPX Compatible**: Works via npx without global installation
+- **Windows Podman Remote**: Uses podman-remote-release-windows_amd64.zip as portable client
 
 ## Isolation Architecture
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "sandboxbox",
-  "version": "2.2.3",
+  "version": "2.2.4",
   "description": "Portable container runner with Podman - Claude Code & Playwright support. Works on Windows, macOS, and Linux.",
   "type": "module",
   "main": "cli.js",

package/utils/podman.js

@@ -69,19 +69,34 @@ export function checkPodman() {
           if (infoError.message.includes('Cannot connect to Podman')) {
             console.log('\n🔧 Setting up portable Podman backend...');
             try {
-              execSync(`"${newPodmanPath}" machine init --rootful=false`, {
-                stdio: 'inherit',
-                shell: true,
-                cwd: __dirname
-              });
+              // Try to start existing machine first
               execSync(`"${newPodmanPath}" machine start`, {
                 stdio: 'inherit',
                 shell: true,
                 cwd: __dirname
               });
-              console.log('\n✅ Portable Podman backend ready!');
-            } catch (machineError) {
-              console.log('\n⚠️  Podman backend setup needed on first container run');
+              console.log('\n✅ Portable Podman backend started!');
+            } catch (startError) {
+              if (startError.message.includes('does not exist') || startError.message.includes('not found')) {
+                try {
+                  // Create new machine if none exists
+                  execSync(`"${newPodmanPath}" machine init --rootful=false`, {
+                    stdio: 'inherit',
+                    shell: true,
+                    cwd: __dirname
+                  });
+                  execSync(`"${newPodmanPath}" machine start`, {
+                    stdio: 'inherit',
+                    shell: true,
+                    cwd: __dirname
+                  });
+                  console.log('\n✅ Portable Podman backend created and started!');
+                } catch (initError) {
+                  console.log('\n⚠️  Podman backend setup needed on first container run');
+                }
+              } else {
+                console.log('\n⚠️  Podman backend setup needed on first container run');
+              }
             }
           }
         }