@justin0713/opspilot 1.0.6 → 1.0.7

package/bin/opspilot.js

@@ -56,11 +56,75 @@ function tryRun(cmd) {
 }
 
 function checkDocker() {
-  if (!tryRun('docker --version')) {
+  if (tryRun('docker --version')) return;   // already installed
+
+  const platform = os.platform();
+  warn('Docker is not installed. Attempting auto-install...');
+
+  if (platform === 'darwin') {
+    // macOS — prefer Colima (lightweight, no GUI, works on managed Macs)
+    if (tryRun('brew --version')) {
+      log('Installing Colima + Docker CLI via Homebrew (no Docker Desktop needed)...');
+      try {
+        run('brew install colima docker');
+        log('Starting Colima...');
+        run('colima start');
+        ok('Docker is ready via Colima.');
+        return;
+      } catch (e) {
+        warn('Colima install failed. Trying Docker Desktop...');
+        try {
+          run('brew install --cask docker');
+          warn('Docker Desktop installed. Please open Docker Desktop from Applications,');
+          warn('wait for the whale icon in the menu bar, then run: opspilot start again.');
+          process.exit(0);
+        } catch (_) {}
+      }
+    }
+    // No Homebrew
     die(
-      'Docker is not installed or not in PATH.\n' +
-      '  Install Docker Desktop: https://docs.docker.com/get-docker/'
+      'Docker is required but could not be auto-installed.\n\n' +
+      '  Option 1 — Install Homebrew first, then retry:\n' +
+      '    /bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"\n\n' +
+      '  Option 2 — Install OrbStack (lightweight Docker Desktop alternative):\n' +
+      '    https://orbstack.dev\n\n' +
+      '  Option 3 — Run without Docker (Python only):\n' +
+      '    opspilot install-guide'
     );
+
+  } else if (platform === 'linux') {
+    log('Installing Docker via get.docker.com...');
+    try {
+      run('curl -fsSL https://get.docker.com | sh');
+      const user = tryRun('whoami');
+      if (user && user !== 'root') {
+        try { run(`sudo usermod -aG docker ${user}`); } catch (_) {}
+        warn(`Added ${user} to docker group. You may need to log out and back in.`);
+      }
+      ok('Docker installed. Starting Docker service...');
+      try { run('sudo systemctl enable --now docker'); } catch (_) {}
+      return;
+    } catch (e) {
+      die(
+        'Auto-install failed. Install Docker manually:\n' +
+        '  https://docs.docker.com/engine/install/'
+      );
+    }
+
+  } else {
+    // Windows or unknown
+    die(
+      'Docker is required.\n\n' +
+      '  Download Docker Desktop for Windows:\n' +
+      '    https://docs.docker.com/desktop/install/windows-install/\n\n' +
+      '  After installing, open Docker Desktop and wait for it to start,\n' +
+      '  then run: opspilot start'
+    );
+  }
+
+  // Final check after auto-install
+  if (!tryRun('docker --version')) {
+    die('Docker still not available after install. Please reopen your terminal and try again.');
   }
 }
 
@@ -276,6 +340,50 @@ function cmdConfig() {
   console.log(JSON.stringify(safe, null, 2));
 }
 
+function cmdInstallGuide() {
+  const platform = os.platform();
+  console.log(`
+${BOLD}${CYAN}OpsPilot Local — Docker Install Guide${RESET}
+
+Docker is required to run OpsPilot Local.
+The CLI will auto-install Docker when you run ${CYAN}opspilot start${RESET}.
+
+${BOLD}Auto-install behaviour by platform:${RESET}
+
+  ${BOLD}macOS${RESET}
+    • If Homebrew is installed → installs ${CYAN}Colima + Docker CLI${RESET} automatically
+      (lightweight, no Docker Desktop, works on managed/corporate Macs)
+    • If Homebrew is missing → installs Homebrew first:
+        /bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
+      Then retry: ${CYAN}opspilot start --token <token>${RESET}
+
+  ${BOLD}Linux${RESET}
+    • Runs the official Docker install script automatically:
+        curl -fsSL https://get.docker.com | sh
+
+  ${BOLD}Windows${RESET}
+    • Cannot auto-install. Download Docker Desktop:
+        https://docs.docker.com/desktop/install/windows-install/
+
+${BOLD}Manual install options (macOS):${RESET}
+
+  1. ${CYAN}Colima${RESET} — lightweight, CLI-only, free (recommended for managed Macs)
+       brew install colima docker
+       colima start
+
+  2. ${CYAN}OrbStack${RESET} — lightweight Docker Desktop alternative
+       brew install orbstack
+       # or: https://orbstack.dev
+
+  3. ${CYAN}Docker Desktop${RESET} — official GUI app
+       brew install --cask docker
+       # or: https://www.docker.com/products/docker-desktop/
+
+${BOLD}Current platform:${RESET} ${platform}
+${BOLD}Docker status  :${RESET} ${tryRun('docker --version') || RED + 'not found' + RESET}
+`);
+}
+
 function printHelp() {
   console.log(`
 ${BOLD}${CYAN}OpsPilot Local${RESET} — CLI v${PKG_VERSION}
@@ -284,13 +392,14 @@ ${BOLD}Usage:${RESET}
   opspilot <command> [options]
 
 ${BOLD}Commands:${RESET}
-  ${CYAN}start${RESET}     Pull image and start the container
-  ${CYAN}stop${RESET}      Stop and remove the container
-  ${CYAN}logs${RESET}      Show container logs  (-f to follow)
-  ${CYAN}update${RESET}    Pull latest image and restart
-  ${CYAN}status${RESET}    Show container status
-  ${CYAN}config${RESET}    Show saved local config
-  ${CYAN}password${RESET}  Show first-run admin password  (--clear to delete after reading)
+  ${CYAN}start${RESET}          Pull image and start the container  ${YELLOW}(auto-installs Docker if missing)${RESET}
+  ${CYAN}stop${RESET}           Stop and remove the container
+  ${CYAN}logs${RESET}           Show container logs  (-f to follow)
+  ${CYAN}update${RESET}         Pull latest image and restart
+  ${CYAN}status${RESET}         Show container status
+  ${CYAN}config${RESET}         Show saved local config
+  ${CYAN}password${RESET}       Show first-run admin password  (--clear to delete after reading)
+  ${CYAN}install-guide${RESET}  Show Docker installation instructions for your platform
 
 ${BOLD}Start options:${RESET}
   --token      <token>  License token from OpsPilot Cloud  ${YELLOW}(required)${RESET}
@@ -329,8 +438,9 @@ switch (cmd) {
       cmdStart(Object.assign({}, cfg, parsed.flags));
     })();
     break;
-  case 'status':   cmdStatus();           break;
-  case 'config':   cmdConfig();           break;
+  case 'status':        cmdStatus();       break;
+  case 'config':        cmdConfig();       break;
+  case 'install-guide': cmdInstallGuide(); break;
   case 'password':
     if (parsed.flags.clear) {
       try { fs.unlinkSync(CREDENTIALS_FILE); ok('Credentials file cleared.'); }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@justin0713/opspilot",
-  "version": "1.0.6",
+  "version": "1.0.7",
   "description": "CLI installer for OpsPilot Local — self-hosted SSH operations platform",
   "license": "MIT",
   "homepage": "https://github.com/Albert0977/ShellShare#readme",