@magpiecloud/mags 1.7.1 → 1.7.3

package/bin/mags.js

@@ -202,6 +202,7 @@ ${colors.bold}Commands:${colors.reset}
   new <name>                      Create a new persistent VM (returns ID only)
   run [options] <script>          Execute a script on a microVM
   ssh <workspace|name|id>         Open SSH session (auto-starts VM if needed)
+  exec <workspace> <command>      Run a command on an existing VM
   status <name|id>                Get job status
   logs <name|id>                  Get job logs
   list                            List recent jobs
@@ -240,6 +241,7 @@ ${colors.bold}Examples:${colors.reset}
   mags login
   mags new myvm                     # Create VM, get ID
   mags ssh myvm                     # SSH (auto-starts if needed)
+  mags exec myvm 'ls -la'           # Run command on existing VM
   mags run 'echo Hello World'
   mags run -e 'echo fast'           # Ephemeral (no S3 sync)
   mags run -f script.py 'python3 script.py'  # Upload + run file
@@ -1241,6 +1243,80 @@ async function sshToJob(nameOrId) {
   });
 }
 
+async function execOnJob(nameOrId, command) {
+  if (!nameOrId || !command) {
+    log('red', 'Error: Workspace and command required');
+    console.log(`\nUsage: mags exec <workspace|name|id> <command>\n`);
+    console.log('Examples:');
+    console.log('  mags exec myproject "ls -la"');
+    console.log('  mags exec myproject "node --version"');
+    process.exit(1);
+  }
+
+  // Find a running/sleeping job for this workspace
+  const existingJob = await findWorkspaceJob(nameOrId);
+
+  let jobID;
+  if (existingJob && existingJob.status === 'running') {
+    log('green', `Found running VM for '${nameOrId}'`);
+    jobID = existingJob.request_id;
+  } else if (existingJob && existingJob.status === 'sleeping') {
+    log('yellow', `Waking sleeping VM for '${nameOrId}'...`);
+    jobID = existingJob.request_id;
+  } else {
+    log('red', `No running or sleeping VM found for '${nameOrId}'`);
+    log('gray', `Start one with: mags new ${nameOrId}`);
+    process.exit(1);
+  }
+
+  // Enable SSH access
+  log('blue', 'Enabling SSH access...');
+  const accessResp = await request('POST', `/api/v1/mags-jobs/${jobID}/access`, { port: 22 });
+
+  if (!accessResp.success || !accessResp.ssh_host || !accessResp.ssh_port) {
+    log('red', 'Failed to enable SSH access');
+    if (accessResp.error) log('red', accessResp.error);
+    process.exit(1);
+  }
+
+  // Write SSH key to temp file
+  let keyFile = null;
+  const sshArgs = [
+    '-o', 'StrictHostKeyChecking=no',
+    '-o', 'UserKnownHostsFile=/dev/null',
+    '-o', 'LogLevel=ERROR',
+    '-p', accessResp.ssh_port.toString()
+  ];
+
+  if (accessResp.ssh_private_key) {
+    keyFile = path.join(os.tmpdir(), `mags_ssh_${Date.now()}`);
+    fs.writeFileSync(keyFile, accessResp.ssh_private_key, { mode: 0o600 });
+    sshArgs.push('-i', keyFile);
+  }
+
+  // Wrap command to use chroot if overlay is mounted, with proper env
+  const escaped = command.replace(/'/g, "'\\''");
+  const wrappedCmd = `if [ -d /overlay/bin ]; then chroot /overlay /bin/sh -lc '${escaped}'; else /bin/sh -lc '${escaped}'; fi`;
+  // Allocate TTY so interactive CLIs (e.g. claude) work
+  if (process.stdin.isTTY) {
+    sshArgs.push('-t');
+  }
+  sshArgs.push(`root@${accessResp.ssh_host}`, wrappedCmd);
+
+  const ssh = spawn('ssh', sshArgs, { stdio: 'inherit' });
+
+  ssh.on('error', (err) => {
+    if (keyFile) try { fs.unlinkSync(keyFile); } catch (e) {}
+    log('red', `SSH error: ${err.message}`);
+    process.exit(1);
+  });
+
+  ssh.on('close', (code) => {
+    if (keyFile) try { fs.unlinkSync(keyFile); } catch (e) {}
+    process.exit(code || 0);
+  });
+}
+
 async function main() {
   const args = process.argv.slice(2);
   const command = args[0];
@@ -1277,6 +1353,10 @@ async function main() {
         await requireAuth();
         await sshToJob(args[1]);
         break;
+      case 'exec':
+        await requireAuth();
+        await execOnJob(args[1], args.slice(2).join(' '));
+        break;
       case 'url':
         await requireAuth();
         await enableUrlAccess(args[1], parseInt(args[2]) || 8080);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@magpiecloud/mags",
-  "version": "1.7.1",
+  "version": "1.7.3",
   "description": "Mags CLI - Execute scripts on Magpie's instant VM infrastructure",
   "main": "index.js",
   "bin": {