@magpiecloud/mags 1.8.4 → 1.8.6

package/API.md

@@ -39,6 +39,7 @@ Creates a VM, runs a script, and returns. The VM boots in ~300ms from a pool.
   "workspace_id": "my-project",
   "base_workspace_id": "my-base",
   "persistent": false,
+  "no_sleep": false,
   "startup_command": "python3 -m http.server 8080",
   "environment": { "FOO": "bar" },
   "file_ids": ["file-uuid-1", "file-uuid-2"]
@@ -52,6 +53,7 @@ Creates a VM, runs a script, and returns. The VM boots in ~300ms from a pool.
 | `workspace_id` | string | no | Persistent workspace name. Filesystem changes (apt install, files, configs) are synced to S3 and restored on next run. Omit for truly ephemeral (no sync). |
 | `base_workspace_id` | string | no | Mount an existing workspace **read-only** as the starting filesystem. Changes are discarded unless `workspace_id` is also set (fork pattern). |
 | `persistent` | bool | no | If `true`, VM stays alive after script finishes. Use for long-running servers, SSH access, or URL-exposed services. |
+| `no_sleep` | bool | no | If `true` with `persistent`, VM never auto-sleeps. Stays running 24/7 and auto-recovers if the host goes down. |
 | `startup_command` | string | no | Command to run when a sleeping persistent VM wakes up (on URL access). |
 | `environment` | object | no | Key-value env vars injected into the VM. |
 | `file_ids` | string[] | no | File IDs from the upload endpoint. Files are downloaded into `/root/` before script runs. |

package/QUICKSTART.md

@@ -148,6 +148,7 @@ mags run -w webapp-prod "..."
 | `-p, --persistent` | Keep VM alive for URL/SSH access | false |
 | `--url` | Enable public URL access (requires -p) | false |
 | `--port` | Port to expose for URL access | 8080 |
+| `--no-sleep` | Keep VM always running, never auto-sleep (requires -p) | false |
 | `--startup-command` | Command when VM wakes from sleep | none |
 | `-e, --ephemeral` | No S3 sync (faster, truly ephemeral) | false |
 | `-t, --timeout` | Timeout in seconds | 300 |
@@ -205,6 +206,16 @@ mags run -w myapp -p --url --startup-command "npm start" "npm install && npm sta
 # The app wakes automatically when someone visits the URL!
 ```
 
+### Always-On Server (Never Sleeps)
+
+```bash
+# Deploy a server that stays running 24/7
+mags run -w my-api -p --no-sleep --url --port 3000 "npm start"
+
+# VM never auto-sleeps, even when idle
+# Auto-recovers if the host goes down
+```
+
 ## Timeouts
 
 | Command | Default | Max | Flag |

package/README.md

@@ -116,6 +116,7 @@ mags run -p --url 'python3 -m http.server 8080'
 | `-p, --persistent` | Keep VM alive after script completes | false |
 | `--url` | Enable public URL access (requires -p) | false |
 | `--port <port>` | Port to expose for URL access | 8080 |
+| `--no-sleep` | Keep VM always running, never auto-sleep (requires -p) | false |
 | `--startup-command <cmd>` | Command to run when VM wakes from sleep | none |
 
 ## SSH Access
@@ -219,6 +220,20 @@ mags run -w flask-app -p --url 'pip install flask && python app.py'
 mags run -w api -p --url --startup-command 'python server.py' 'pip install -r requirements.txt && python server.py'
 ```
 
+### Always-On VMs
+
+By default, persistent VMs auto-sleep after 10 minutes of inactivity and wake on the next request. Use `--no-sleep` to keep a VM running 24/7:
+
+```bash
+# Always-on API server (never auto-sleeps)
+mags run -w my-api -p --no-sleep --url --port 3000 'npm start'
+
+# Always-on background worker
+mags run -w worker -p --no-sleep 'python worker.py'
+```
+
+If an always-on VM's host becomes unhealthy, the orchestrator automatically re-provisions it on a healthy agent within ~60 seconds.
+
 ### Interactive Development
 
 ```bash
@@ -257,6 +272,13 @@ const { requestId } = await mags.run('python script.py', {
   startupCommand: 'python server.py'
 });
 
+// Always-on VM (never auto-sleeps)
+await mags.run('node server.js', {
+  workspaceId: 'my-api',
+  persistent: true,
+  noSleep: true
+});
+
 // Get status
 const status = await mags.status(requestId);
 console.log(status);
@@ -298,7 +320,8 @@ curl -X POST https://api.magpiecloud.com/api/v1/mags-jobs \
     "script": "echo Hello World",
     "type": "inline",
     "workspace_id": "myproject",
-    "persistent": true
+    "persistent": true,
+    "no_sleep": true
   }'
 ```
 

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)
+  browser [workspace]             Start a Chromium browser session (CDP access)
   exec <workspace> <command>      Run a command on an existing VM
   status <name|id>                Get job status
   logs <name|id>                  Get job logs
@@ -218,8 +219,7 @@ ${colors.bold}Commands:${colors.reset}
   setup-claude                    Install Mags skill for Claude Code
 
 ${colors.bold}Run Options:${colors.reset}
-  -w, --workspace <id>            Use persistent workspace (S3 sync)
-  -n, --name <name>               Set job name (for easier reference)
+  -n, --name <name>               Set job/workspace name (used as both)
   -p, --persistent                Keep VM alive after script completes
   --no-sleep                      Never auto-sleep this VM (requires -p)
   --base <workspace>              Mount workspace read-only as base image
@@ -240,7 +240,7 @@ ${colors.bold}Cron Commands:${colors.reset}
 ${colors.bold}Cron Options:${colors.reset}
   --name <name>                   Cron job name (required)
   --schedule <expr>               Cron expression (required, e.g. "0 * * * *")
-  -w, --workspace <id>            Workspace for cron jobs
+  -w, --workspace <id>            Workspace for cron jobs (alias for --name)
   -p, --persistent                Keep VM alive after cron script
 
 ${colors.bold}Examples:${colors.reset}
@@ -251,11 +251,12 @@ ${colors.bold}Examples:${colors.reset}
   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
-  mags run -w myproject 'python3 script.py'
+  mags run -n myproject 'python3 script.py'
   mags run --base golden 'npm test'           # Use golden as read-only base
-  mags run --base golden -w fork-1 'npm test' # Base + save changes to fork-1
+  mags run --base golden -n fork-1 'npm test' # Base + save changes to fork-1
   mags run -p --url 'python3 -m http.server 8080'
-  mags run -n webapp -w webapp -p --url --port 3000 'npm start'
+  mags run -n webapp -p --url --port 3000 'npm start'
+  mags browser myproject            # Start browser with workspace
   mags workspace list               # List workspaces
   mags workspace delete myproject   # Delete workspace
   mags cron add --name backup --schedule "0 0 * * *" 'tar czf backup.tar.gz data/'
@@ -467,7 +468,6 @@ async function newVM(args) {
 
 async function runJob(args) {
   let script = '';
-  let workspace = '';
   let baseWorkspace = '';
   let name = '';
   let persistent = false;
@@ -484,8 +484,6 @@ async function runJob(args) {
     switch (args[i]) {
       case '-w':
       case '--workspace':
-        workspace = args[++i];
-        break;
       case '-n':
       case '--name':
         name = args[++i];
@@ -532,8 +530,8 @@ async function runJob(args) {
   }
 
   // Validate flag combinations
-  if (ephemeral && workspace) {
-    log('red', 'Error: Cannot use --ephemeral with --workspace; ephemeral VMs have no persistent storage');
+  if (ephemeral && name) {
+    log('red', 'Error: Cannot use --ephemeral with --name; ephemeral VMs have no persistent storage');
     process.exit(1);
   }
   if (ephemeral && persistent) {
@@ -573,9 +571,11 @@ async function runJob(args) {
     persistent
   };
   if (noSleep) payload.no_sleep = true;
-  // Only set workspace_id if not ephemeral
-  if (!ephemeral && workspace) payload.workspace_id = workspace;
-  if (name) payload.name = name;
+  // name and workspace_id are always the same
+  if (name) {
+    payload.name = name;
+    if (!ephemeral) payload.workspace_id = name;
+  }
   if (baseWorkspace) payload.base_workspace_id = baseWorkspace;
   if (startupCommand) payload.startup_command = startupCommand;
   if (fileIds.length > 0) payload.file_ids = fileIds;
@@ -592,12 +592,11 @@ async function runJob(args) {
   const requestId = response.request_id;
   log('green', `Job submitted: ${requestId}`);
   if (name) log('blue', `Name: ${name}`);
-  if (workspace) log('blue', `Workspace: ${workspace}`);
   if (baseWorkspace) log('blue', `Base workspace: ${baseWorkspace} (read-only)`);
   if (persistent) log('yellow', 'Persistent: VM will stay alive');
 
-  // Poll for completion
-  const maxAttempts = 120;
+  // Poll for completion (200ms intervals, 600 attempts = 2 min timeout)
+  const maxAttempts = 600;
   let attempt = 0;
 
   while (attempt < maxAttempts) {
@@ -610,7 +609,7 @@ async function runJob(args) {
       // If --url requested, wait until VM is actually assigned (vm_id populated)
       if (enableUrl && !status.vm_id) {
         process.stdout.write('.');
-        await sleep(1000);
+        await sleep(200);
         attempt++;
         continue;
       }
@@ -634,7 +633,7 @@ async function runJob(args) {
     }
 
     process.stdout.write('.');
-    await sleep(1000);
+    await sleep(200);
     attempt++;
   }
 
@@ -1289,6 +1288,114 @@ async function workspaceDelete(workspaceId) {
   }
 }
 
+async function browserSession(args) {
+  let workspace = '';
+  let name = '';
+
+  // Parse args: mags browser [workspace] [--name <n>]
+  for (let i = 0; i < args.length; i++) {
+    if ((args[i] === '-n' || args[i] === '--name') && args[i + 1]) {
+      name = args[++i];
+    } else if (!workspace) {
+      workspace = args[i];
+    }
+  }
+
+  // Check for existing running/sleeping browser session with this workspace
+  if (workspace) {
+    const existingJob = await findWorkspaceJob(workspace);
+
+    if (existingJob && existingJob.status === 'running') {
+      // Check if it's already a browser session
+      const status = await request('GET', `/api/v1/mags-jobs/${existingJob.request_id}/status`);
+      if (status.browser_mode && status.debug_ws_url) {
+        log('green', 'Found existing browser session');
+        console.log('');
+        log('cyan', `CDP Endpoint: ${status.debug_ws_url}`);
+        console.log('');
+        log('gray', 'Connect with Playwright:');
+        console.log(`  const browser = await chromium.connectOverCDP('${status.debug_ws_url}');`);
+        console.log('');
+        log('gray', 'Connect with Puppeteer:');
+        console.log(`  const browser = await puppeteer.connect({ browserWSEndpoint: '${status.debug_ws_url}' });`);
+        return;
+      }
+    }
+  }
+
+  log('blue', 'Starting browser session...');
+
+  const payload = {
+    script: 'echo "Browser session ready"',
+    type: 'inline',
+    browser_mode: true,
+    persistent: true
+  };
+  if (workspace) payload.workspace_id = workspace;
+  if (name) payload.name = name;
+  if (!name && workspace) payload.name = `browser-${workspace}`;
+
+  const response = await request('POST', '/api/v1/mags-jobs', payload);
+
+  if (!response.request_id) {
+    log('red', 'Failed to start browser session:');
+    console.log(JSON.stringify(response, null, 2));
+    process.exit(1);
+  }
+
+  const requestId = response.request_id;
+  log('gray', `Job: ${requestId}`);
+
+  // Wait for VM + Chromium to be ready
+  log('blue', 'Waiting for Chromium to start...');
+  let status;
+  for (let i = 0; i < 90; i++) {
+    status = await request('GET', `/api/v1/mags-jobs/${requestId}/status`);
+    if (status.status === 'running' && status.debug_ws_url) {
+      break;
+    }
+    if (status.status === 'error') {
+      log('red', `Browser session failed: ${status.error_message || 'Unknown error'}`);
+      process.exit(1);
+    }
+    process.stdout.write('.');
+    await sleep(1000);
+  }
+  console.log('');
+
+  if (!status || !status.debug_ws_url) {
+    // VM is running but no CDP URL yet - it may still be initializing
+    if (status && status.status === 'running' && status.subdomain) {
+      const wsUrl = `wss://${status.subdomain}.apps.magpiecloud.com`;
+      log('green', 'Browser session ready!');
+      console.log('');
+      log('cyan', `CDP Endpoint: ${wsUrl}`);
+      console.log('');
+      log('gray', 'Connect with Playwright:');
+      console.log(`  const browser = await chromium.connectOverCDP('${wsUrl}');`);
+      console.log('');
+      log('gray', 'Connect with Puppeteer:');
+      console.log(`  const browser = await puppeteer.connect({ browserWSEndpoint: '${wsUrl}' });`);
+    } else {
+      log('yellow', 'Browser session started but CDP URL not yet available.');
+      log('yellow', `Check status with: mags status ${requestId}`);
+    }
+    return;
+  }
+
+  log('green', 'Browser session ready!');
+  console.log('');
+  log('cyan', `CDP Endpoint: ${status.debug_ws_url}`);
+  console.log('');
+  log('gray', 'Connect with Playwright:');
+  console.log(`  const browser = await chromium.connectOverCDP('${status.debug_ws_url}');`);
+  console.log('');
+  log('gray', 'Connect with Puppeteer:');
+  console.log(`  const browser = await puppeteer.connect({ browserWSEndpoint: '${status.debug_ws_url}' });`);
+  console.log('');
+  log('gray', `Stop with: mags stop ${workspace || requestId}`);
+}
+
 async function sshToJob(nameOrId) {
   if (!nameOrId) {
     log('red', 'Error: Workspace, job name, or job ID required');
@@ -1335,17 +1442,17 @@ async function sshToJob(nameOrId) {
     jobID = response.request_id;
     log('gray', `Job: ${jobID}`);
 
-    // Wait for VM to be ready
+    // Wait for VM to be ready (status=running AND vm_id assigned)
     log('blue', 'Waiting for VM...');
-    for (let i = 0; i < 30; i++) {
+    for (let i = 0; i < 60; i++) {
       const status = await request('GET', `/api/v1/mags-jobs/${jobID}/status`);
-      if (status.status === 'running') break;
+      if (status.status === 'running' && status.vm_id) break;
       if (status.status === 'error') {
         log('red', 'VM failed to start');
         process.exit(1);
       }
       process.stdout.write('.');
-      await sleep(1000);
+      await sleep(300);
     }
     console.log('');
   }
@@ -1521,7 +1628,7 @@ async function main() {
         break;
       case '--version':
       case '-v':
-        console.log('mags v1.8.3');
+        console.log('mags v1.8.5');
         process.exit(0);
         break;
       case 'new':
@@ -1536,6 +1643,10 @@ async function main() {
         await requireAuth();
         await sshToJob(args[1]);
         break;
+      case 'browser':
+        await requireAuth();
+        await browserSession(args.slice(1));
+        break;
       case 'exec':
         await requireAuth();
         await execOnJob(args[1], args.slice(2).join(' '));

package/package.json

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

package/python/README.md

@@ -66,6 +66,19 @@ m.run_and_wait(
 )
 ```
 
+### Always-On VMs
+
+```python
+# VM that never auto-sleeps — stays running 24/7
+job = m.run(
+    "python3 server.py",
+    workspace_id="my-api",
+    persistent=True,
+    no_sleep=True,
+)
+# Auto-recovers if the host goes down
+```
+
 ### Enable URL / SSH Access
 
 ```python
@@ -116,8 +129,13 @@ print(f"Jobs: {usage['total_jobs']}, VM seconds: {usage['vm_seconds']:.0f}")
 
 | Method | Description |
 |--------|-------------|
-| `run(script, **opts)` | Submit a job (returns immediately) |
+| `run(script, **opts)` | Submit a job (`persistent`, `no_sleep`, `workspace_id`, ...) |
 | `run_and_wait(script, **opts)` | Submit and block until done |
+| `new(name, **opts)` | Create a persistent VM workspace |
+| `find_job(name_or_id)` | Find a running/sleeping job by name or workspace |
+| `exec(name_or_id, command)` | Run a command on an existing VM via SSH |
+| `stop(name_or_id)` | Stop a running job |
+| `resize(workspace, disk_gb)` | Resize a workspace's disk |
 | `status(request_id)` | Get job status |
 | `logs(request_id)` | Get job logs |
 | `list_jobs(page, page_size)` | List recent jobs |

package/python/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "magpie-mags"
-version = "1.3.1"
+version = "1.3.3"
 description = "Mags SDK - Execute scripts on Magpie's instant VM infrastructure"
 readme = "README.md"
 license = {text = "MIT"}

package/python/src/magpie_mags.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: magpie-mags
-Version: 1.3.0
+Version: 1.3.3
 Summary: Mags SDK - Execute scripts on Magpie's instant VM infrastructure
 Author: Magpie Cloud
 License: MIT
@@ -91,6 +91,19 @@ m.run_and_wait(
 )
 ```
 
+### Always-On VMs
+
+```python
+# VM that never auto-sleeps — stays running 24/7
+job = m.run(
+    "python3 server.py",
+    workspace_id="my-api",
+    persistent=True,
+    no_sleep=True,
+)
+# Auto-recovers if the host goes down
+```
+
 ### Enable URL / SSH Access
 
 ```python
@@ -141,8 +154,13 @@ print(f"Jobs: {usage['total_jobs']}, VM seconds: {usage['vm_seconds']:.0f}")
 
 | Method | Description |
 |--------|-------------|
-| `run(script, **opts)` | Submit a job (returns immediately) |
+| `run(script, **opts)` | Submit a job (`persistent`, `no_sleep`, `workspace_id`, ...) |
 | `run_and_wait(script, **opts)` | Submit and block until done |
+| `new(name, **opts)` | Create a persistent VM workspace |
+| `find_job(name_or_id)` | Find a running/sleeping job by name or workspace |
+| `exec(name_or_id, command)` | Run a command on an existing VM via SSH |
+| `stop(name_or_id)` | Stop a running job |
+| `resize(workspace, disk_gb)` | Resize a workspace's disk |
 | `status(request_id)` | Get job status |
 | `logs(request_id)` | Get job logs |
 | `list_jobs(page, page_size)` | List recent jobs |

package/python/src/mags/client.py

@@ -109,6 +109,20 @@ class Mags:
     ) -> dict:
         """Submit a job for execution.
 
+        Args:
+            script: Shell script to execute inside the VM.
+            name: Optional job name.
+            workspace_id: Persistent workspace name (synced to S3).
+            base_workspace_id: Read-only base workspace to mount.
+            persistent: Keep VM alive after script finishes.
+            no_sleep: Never auto-sleep this VM (requires persistent=True).
+                The VM stays running 24/7 and auto-recovers if its host goes down.
+            ephemeral: No S3 sync (faster, truly ephemeral).
+            startup_command: Command to run when VM wakes from sleep.
+            environment: Key-value env vars injected into the VM.
+            file_ids: File IDs to download into VM before script runs.
+            disk_gb: Custom disk size in GB (default 2GB).
+
         Returns ``{"request_id": ..., "status": "accepted"}``.
         """
         if ephemeral and workspace_id:
@@ -332,15 +346,7 @@ class Mags:
 
         request_id = job.get("request_id") or job.get("id")
 
-        # Wait for VM to be assigned (status=running doesn't guarantee vm_id yet)
-        for _ in range(15):
-            st = self.status(request_id)
-            if st.get("vm_id"):
-                break
-            time.sleep(1)
-        else:
-            raise MagsError(f"VM for '{name_or_id}' has no vm_id after 15s")
-
+        # Call /access directly — for sleeping VMs this triggers the wake
         access = self.enable_access(request_id, port=22)
 
         if not access.get("success") or not access.get("ssh_host"):

package/website/api.html

@@ -109,11 +109,10 @@
         </div>
         <nav class="nav-links">
           <a href="index.html">Home</a>
-          <a href="index.html#quickstart">Quickstart</a>
-          <a href="index.html#sdk">SDKs</a>
+          <a href="index.html#quickstart">Docs</a>
           <a href="cookbook.html">Cookbook</a>
+          <a href="https://discord.gg/3avpC2nS" target="_blank" rel="noreferrer">Discord</a>
           <a href="login.html">Login</a>
-          <a href="tokens.html">Tokens</a>
         </nav>
         <div class="nav-cta">
           <a class="button ghost" href="tokens.html">Get API token</a>
@@ -924,11 +923,10 @@ mags cron remove &lt;id&gt;</code></pre>
         </div>
         <div class="footer-links">
           <a href="index.html">Home</a>
+          <a href="cookbook.html">Cookbook</a>
           <a href="https://pypi.org/project/magpie-mags/" rel="noreferrer">Python SDK</a>
           <a href="https://www.npmjs.com/package/@magpiecloud/mags" rel="noreferrer">Node.js SDK</a>
-          <a href="cookbook.html">Cookbook</a>
-          <a href="tokens.html">Tokens</a>
-          <a href="usage.html">Usage</a>
+          <a href="https://discord.gg/3avpC2nS" target="_blank" rel="noreferrer">Discord</a>
           <a href="login.html">Login</a>
         </div>
       </div>

package/website/claude-skill.html

@@ -24,9 +24,10 @@
         </div>
         <nav class="nav-links">
           <a href="index.html">Home</a>
-          <a href="index.html#sdk">SDKs</a>
-          <a href="api.html">API Docs</a>
+          <a href="index.html#quickstart">Docs</a>
+          <a href="api.html">API</a>
           <a href="cookbook.html">Cookbook</a>
+          <a href="https://discord.gg/3avpC2nS" target="_blank" rel="noreferrer">Discord</a>
           <a href="login.html">Login</a>
         </nav>
         <div class="nav-cta">
@@ -467,13 +468,10 @@ Use workspace "monitors" so the log persists</code></pre>
         </div>
         <div class="footer-links">
           <a href="index.html">Home</a>
-          <a href="login.html">Login</a>
-          <a href="usage.html">Usage</a>
-          <a href="tokens.html">Tokens</a>
+          <a href="api.html">API</a>
           <a href="cookbook.html">Cookbook</a>
-          <a href="https://magpiecloud.com/docs/mags" rel="noreferrer">Documentation</a>
-          <a href="https://magpiecloud.com/dashboard" rel="noreferrer">Dashboard</a>
-          <a href="https://github.com/magpiecloud/mags" rel="noreferrer">GitHub</a>
+          <a href="https://discord.gg/3avpC2nS" target="_blank" rel="noreferrer">Discord</a>
+          <a href="login.html">Login</a>
         </div>
       </div>
     </footer>

package/website/cookbook/hn-marketing.sh

@@ -1,50 +1,42 @@
 #!/bin/sh
-# hn-marketing.sh — Fetch top HN stories and filter for marketing-related content
+# hn-marketing.sh — Fetch top 10 HN stories and save to CSV
 # Dependencies: curl, jq (install with: apk add -q curl jq)
 
 set -e
 
-KEYWORDS='marketing|growth hack|SEO|advertising|branding|brand strategy|content strategy|content marketing|acquisition|retention|funnel|conversion|GTM|go-to-market|product.led|newsletter|copywriting|social media|influencer|public relations|DTC|B2B marketing|B2C|demand gen|lead gen|campaign'
+CSV="${HN_CSV:-./hn-top10.csv}"
+TIMESTAMP=$(date -u +"%Y-%m-%d %H:%M:%S UTC")
 
-echo "=== HN Marketing Digest ==="
-echo "Fetching top stories from Hacker News..."
-echo ""
-
-IDS=$(curl -sf "https://hacker-news.firebaseio.com/v0/topstories.json" | jq -r '.[0:100] | .[]')
-
-if [ -z "$IDS" ]; then
-  echo "Error: could not fetch story IDs"
-  exit 1
+# Write CSV header if file doesn't exist
+if [ ! -f "$CSV" ]; then
+  echo "timestamp,rank,score,title,url,hn_link" > "$CSV"
 fi
 
-COUNT=0
+echo "=== HN Top 10 ==="
+echo "Fetched at: $TIMESTAMP"
+echo ""
+
+# Get top 10 story IDs
+IDS=$(curl -sf "https://hacker-news.firebaseio.com/v0/topstories.json" | jq -r '.[0:10] | .[]')
 
+RANK=0
 for ID in $IDS; do
+  RANK=$((RANK + 1))
   ITEM=$(curl -sf "https://hacker-news.firebaseio.com/v0/item/${ID}.json")
-  TITLE=$(echo "$ITEM" | jq -r '.title // empty')
 
-  if [ -z "$TITLE" ]; then
-    continue
-  fi
+  TITLE=$(echo "$ITEM" | jq -r '.title // "untitled"' | tr -d '\n\r' | sed 's/,/;/g')
+  URL=$(echo "$ITEM" | jq -r '.url // ""' | tr -d '\n\r')
+  SCORE=$(echo "$ITEM" | jq -r '.score // 0')
+  HN_LINK="https://news.ycombinator.com/item?id=$ID"
 
-  MATCH=$(echo "$TITLE" | grep -iE "$KEYWORDS" || true)
+  [ -z "$URL" ] && URL="$HN_LINK"
 
-  if [ -n "$MATCH" ]; then
-    URL=$(echo "$ITEM" | jq -r '.url // "https://news.ycombinator.com/item?id='"$ID"'"')
-    SCORE=$(echo "$ITEM" | jq -r '.score // 0')
-    TIME=$(echo "$ITEM" | jq -r '.time // 0')
-    COUNT=$((COUNT + 1))
+  echo "[$RANK] $TITLE"
+  echo "    Score: $SCORE | $URL"
+  echo ""
 
-    echo "[$COUNT] $TITLE"
-    echo "    Score: $SCORE | Link: $URL"
-    echo "    HN: https://news.ycombinator.com/item?id=$ID"
-    echo ""
-  fi
+  echo "$TIMESTAMP,$RANK,$SCORE,$TITLE,$URL,$HN_LINK" >> "$CSV"
 done
 
-if [ "$COUNT" -eq 0 ]; then
-  echo "No marketing-related stories found in the current top 100."
-else
-  echo "---"
-  echo "Found $COUNT marketing-related stories."
-fi
+echo "---"
+echo "Saved to $CSV"

package/website/cookbook.html

@@ -10,7 +10,7 @@
     />
     <meta name="api-base" content="https://api.magpiecloud.com" />
     <meta name="auth-base" content="https://api.magpiecloud.com" />
-    <link rel="stylesheet" href="styles.css?v=2" />
+    <link rel="stylesheet" href="styles.css?v=6" />
     <script src="env.js"></script>
   </head>
   <body>
@@ -24,13 +24,10 @@
         </div>
         <nav class="nav-links">
           <a href="index.html">Home</a>
-          <a href="index.html#quickstart">Quickstart</a>
-          <a href="index.html#cli">CLI</a>
-          <a href="index.html#api">API</a>
+          <a href="index.html#quickstart">Docs</a>
+          <a href="api.html">API</a>
+          <a href="https://discord.gg/3avpC2nS" target="_blank" rel="noreferrer">Discord</a>
           <a href="login.html">Login</a>
-          <a href="usage.html">Usage</a>
-          <a href="tokens.html">Tokens</a>
-          <a href="claude-skill.html">Claude Skill</a>
         </nav>
         <div class="nav-cta">
           <a class="button ghost" href="index.html#quickstart">Get started</a>
@@ -171,18 +168,25 @@ mags logs &lt;job-id&gt;</code></pre>
             </article>
             <article class="recipe-item" data-reveal>
               <div class="recipe-header">
-                <h3>HN Marketing Digest</h3>
+                <h3>HN Top 10 Digest</h3>
                 <span class="pill">Cron</span>
               </div>
-              <pre><code># Upload script + install deps
-mags run -f cookbook/hn-marketing.sh -w hn-digest \
-  'cp hn-marketing.sh /root/ && chmod +x /root/hn-marketing.sh && apk add -q curl jq'
+              <pre><code># Upload script + install deps (file lands in /root/)
+mags run -f hn-marketing.sh -w hn-digest \
+  'chmod +x /root/hn-marketing.sh && apk add -q curl jq'
+
+# Run it once (saves to /root/hn-top10.csv)
+mags run -w hn-digest 'HN_CSV=/root/hn-top10.csv sh /root/hn-marketing.sh'
 
-# Activate cron (every 2 hours)
-mags cron add --name "hn-marketing" \
+# Schedule it (every 2 hours, results append to CSV)
+mags cron add --name "hn-top10" \
   --schedule "0 */2 * * *" -w hn-digest \
-  'sh /root/hn-marketing.sh'</code></pre>
-              <p class="label"><a href="cookbook/hn-marketing.html">Full recipe + live demo →</a></p>
+  'HN_CSV=/root/hn-top10.csv sh /root/hn-marketing.sh'</code></pre>
+              <p class="label">
+                <a href="cookbook/hn-marketing.sh" download>Download hn-marketing.sh</a>
+                &nbsp;&middot;&nbsp;
+                <a href="cookbook/hn-marketing.html">Full recipe + live demo &rarr;</a>
+              </p>
             </article>
           </div>
         </div>
@@ -264,11 +268,10 @@ curl -X POST https://api.magpiecloud.com/api/v1/mags-cron \
         </div>
         <div class="footer-links">
           <a href="index.html">Home</a>
-          <a href="login.html">Login</a>
-          <a href="usage.html">Usage</a>
-          <a href="tokens.html">Tokens</a>
+          <a href="api.html">API</a>
           <a href="claude-skill.html">Claude Skill</a>
-          <a href="https://magpiecloud.com/docs/mags" rel="noreferrer">Documentation</a>
+          <a href="https://discord.gg/3avpC2nS" target="_blank" rel="noreferrer">Discord</a>
+          <a href="login.html">Login</a>
         </div>
       </div>
     </footer>

package/website/index.html

@@ -10,7 +10,7 @@
     />
     <meta name="api-base" content="https://api.magpiecloud.com" />
     <meta name="auth-base" content="https://api.magpiecloud.com" />
-    <link rel="stylesheet" href="styles.css?v=5" />
+    <link rel="stylesheet" href="styles.css?v=6" />
     <script src="env.js"></script>
   </head>
   <body>
@@ -23,11 +23,10 @@
           <span class="tag">Secure cloud sandboxes for the AI age</span>
         </div>
         <nav class="nav-links">
-          <a href="#overview">Overview</a>
-          <a href="#quickstart">Quickstart</a>
-          <a href="#patterns">Usage</a>
-          <a href="#sdk">SDKs</a>
-          <a href="api.html">API Docs</a>
+          <a href="#quickstart">Docs</a>
+          <a href="api.html">API</a>
+          <a href="cookbook.html">Cookbook</a>
+          <a href="https://discord.gg/3avpC2nS" target="_blank" rel="noreferrer">Discord</a>
           <a href="login.html" id="nav-auth-link">Login</a>
         </nav>
         <div class="nav-cta">
@@ -41,22 +40,16 @@
       <section class="hero" id="overview">
         <div class="container hero-grid">
           <div class="hero-copy">
-            <span class="pill">New: Python SDK</span>
             <h1>Secure sandboxes that boot in milliseconds. Your data stays.</h1>
             <p class="lead">
-              Give your AI agents and scripts a safe place to run. Every sandbox is
-              completely isolated, boots instantly, and syncs your files to the cloud
-              automatically. Perfect for agents, scheduled jobs, and anything that
-              needs to run without risk.
+              Give your AI agents an instant home. Every sandbox is
+              completely isolated, boots in ~300ms, and syncs your files to the cloud
+              automatically. CLI, Python, and Node.js &mdash; pick your tool.
             </p>
             <div class="hero-actions">
               <a class="button" href="#quickstart">Quickstart</a>
               <a class="button ghost" href="api.html">API Reference</a>
             </div>
-            <div class="hero-meta">
-              <span>CLI, Python, and Node.js &mdash; pick your tool.</span>
-              <span>Sandboxes in ~300ms. Files persist to the cloud between runs.</span>
-            </div>
           </div>
           <div class="hero-card tab-group" aria-label="Mags example">
             <div class="tab-bar">
@@ -513,6 +506,45 @@ await mags.cronCreate({
         </div>
       </section>
 
+      <!-- ── Always-On Servers ──────────────────────────── -->
+      <section class="section" id="always-on">
+        <div class="container">
+          <div class="section-title">
+            <p>Always-On Servers</p>
+            <h2>Keep your sandboxes running forever.</h2>
+          </div>
+          <div class="grid split">
+            <article class="panel" data-reveal>
+              <h3>Never auto-sleep</h3>
+              <p>By default, persistent sandboxes auto-sleep after 10 minutes of inactivity to save resources. With the <code>--no-sleep</code> flag, your VM stays running 24/7 &mdash; perfect for web servers, workers, and background processes.</p>
+              <pre><code># CLI
+mags run -w my-api -p --no-sleep --url --port 3000 'node server.js'
+
+# Python
+m.run("node server.js",
+    workspace_id="my-api", persistent=True, no_sleep=True)
+
+# Node.js
+await mags.run('node server.js', {
+  workspaceId: 'my-api', persistent: true, noSleep: true,
+});</code></pre>
+            </article>
+            <article class="panel" data-reveal>
+              <h3>Auto-recovery</h3>
+              <p>Always-on sandboxes are automatically monitored. If the host goes down, your VM is re-provisioned on a healthy server within ~60 seconds &mdash; no manual intervention needed.</p>
+              <h3 style="margin-top:1.2rem">How it works</h3>
+              <ul class="list">
+                <li>Requires <code>-p</code> (persistent) flag</li>
+                <li>VM stays in <code>running</code> state indefinitely</li>
+                <li>Combine with <code>--url</code> to expose a public HTTPS endpoint</li>
+                <li>Use <code>--startup-command</code> to auto-restart your process if the VM recovers</li>
+                <li>Files persist to the cloud via workspace sync</li>
+              </ul>
+            </article>
+          </div>
+        </div>
+      </section>
+
       <!-- ── SDKs + API ──────────────────────────────────── -->
       <section class="section" id="sdk">
         <div class="container">
@@ -692,6 +724,7 @@ console.log(result.logs);</code></pre>
           <a href="api.html">API Reference</a>
           <a href="claude-skill.html">Claude Skill</a>
           <a href="cookbook.html">Cookbook</a>
+          <a href="https://discord.gg/3avpC2nS" rel="noreferrer" target="_blank">Discord</a>
           <a href="https://github.com/magpiecloud/mags/issues" rel="noreferrer">Issues</a>
         </div>
       </div>
@@ -704,8 +737,8 @@ console.log(result.logs);</code></pre>
       if (token) {
         var nav = document.getElementById('nav-auth-link');
         var cta = document.getElementById('cta-auth-link');
-        if (nav) { nav.textContent = 'Dashboard'; nav.href = '/dashboard'; }
-        if (cta) { cta.textContent = 'Dashboard'; cta.href = '/dashboard'; }
+        if (nav) { nav.textContent = 'Usage'; nav.href = 'usage.html'; }
+        if (cta) { cta.textContent = 'Dashboard'; cta.href = 'usage.html'; }
       }
     })();
     </script>

package/website/login.html

@@ -4,7 +4,7 @@
     <meta charset="utf-8" />
     <meta name="viewport" content="width=device-width, initial-scale=1" />
     <title>Mags Login</title>
-    <meta name="description" content="Sign in to Mags with Google or email." />
+    <meta name="description" content="Sign in to Mags with Google." />
     <meta name="api-base" content="https://api.magpiecloud.com" />
     <meta name="auth-base" content="https://api.magpiecloud.com" />
     <link rel="stylesheet" href="styles.css?v=2" />
@@ -21,9 +21,10 @@
         </div>
         <nav class="nav-links">
           <a href="index.html">Home</a>
-          <a href="index.html#quickstart">Quickstart</a>
-          <a href="index.html#cli">CLI</a>
-          <a href="index.html#api">API</a>
+          <a href="index.html#quickstart">Docs</a>
+          <a href="api.html">API</a>
+          <a href="cookbook.html">Cookbook</a>
+          <a href="https://discord.gg/3avpC2nS" target="_blank" rel="noreferrer">Discord</a>
         </nav>
         <div class="nav-cta">
           <a class="button ghost" href="index.html">Back to home</a>
@@ -37,30 +38,10 @@
           <div>
             <span class="pill">Login</span>
             <h1 class="auth-title">Sign in to Mags.</h1>
-            <p class="auth-subtitle">Use Google or your email and password.</p>
+            <p class="auth-subtitle">Sign in with your Google account to get started.</p>
           </div>
 
           <button class="button full" type="button" data-google-login>Continue with Google</button>
-
-          <div class="auth-divider"><span>or</span></div>
-
-          <form class="login-form" data-login-form>
-            <div class="form-group">
-              <label class="form-label" for="login-email">Email</label>
-              <input class="input" type="email" id="login-email" name="email" required />
-            </div>
-            <div class="form-group">
-              <label class="form-label" for="login-password">Password</label>
-              <input class="input" type="password" id="login-password" name="password" required />
-            </div>
-            <button class="button full" type="submit">Sign in</button>
-            <p class="form-message" data-login-message></p>
-          </form>
-
-          <div class="form-links">
-            <a data-auth-link="/auth/forgot-password" href="#">Forgot password?</a>
-            <a data-auth-link="/auth/register" href="#">Create an account</a>
-          </div>
         </div>
       </div>
     </main>
@@ -76,9 +57,9 @@
         </div>
         <div class="footer-links">
           <a href="index.html">Home</a>
-          <a href="usage.html">Usage</a>
-          <a href="tokens.html">Tokens</a>
-          <a href="claude-skill.html">Claude Skill</a>
+          <a href="api.html">API</a>
+          <a href="cookbook.html">Cookbook</a>
+          <a href="https://discord.gg/3avpC2nS" target="_blank" rel="noreferrer">Discord</a>
         </div>
       </div>
     </footer>

package/website/tokens.html

@@ -24,13 +24,10 @@
         </div>
         <nav class="nav-links">
           <a href="index.html">Home</a>
-          <a href="index.html#quickstart">Quickstart</a>
-          <a href="index.html#cli">CLI</a>
-          <a href="index.html#api">API</a>
-          <a href="login.html">Login</a>
           <a href="usage.html">Usage</a>
-          <a href="claude-skill.html">Claude Skill</a>
+          <a href="api.html">API</a>
           <a href="cookbook.html">Cookbook</a>
+          <a href="https://discord.gg/3avpC2nS" target="_blank" rel="noreferrer">Discord</a>
         </nav>
         <div class="nav-cta">
           <a class="button ghost" href="/api-keys">Manage tokens</a>
@@ -158,10 +155,10 @@ mags whoami</code></pre>
         </div>
         <div class="footer-links">
           <a href="index.html">Home</a>
-          <a href="login.html">Login</a>
           <a href="usage.html">Usage</a>
-          <a href="claude-skill.html">Claude Skill</a>
+          <a href="api.html">API</a>
           <a href="cookbook.html">Cookbook</a>
+          <a href="https://discord.gg/3avpC2nS" target="_blank" rel="noreferrer">Discord</a>
         </div>
       </div>
     </footer>

package/website/usage.html

@@ -24,13 +24,10 @@
         </div>
         <nav class="nav-links">
           <a href="index.html">Home</a>
-          <a href="index.html#quickstart">Quickstart</a>
-          <a href="index.html#cli">CLI</a>
-          <a href="index.html#api">API</a>
-          <a href="login.html">Login</a>
           <a href="tokens.html">Tokens</a>
-          <a href="claude-skill.html">Claude Skill</a>
+          <a href="api.html">API</a>
           <a href="cookbook.html">Cookbook</a>
+          <a href="https://discord.gg/3avpC2nS" target="_blank" rel="noreferrer">Discord</a>
         </nav>
         <div class="nav-cta">
           <a class="button ghost" href="/mags">Open console</a>
@@ -174,10 +171,10 @@ mags cron add --name "backup" \
         </div>
         <div class="footer-links">
           <a href="index.html">Home</a>
-          <a href="login.html">Login</a>
           <a href="tokens.html">Tokens</a>
-          <a href="claude-skill.html">Claude Skill</a>
+          <a href="api.html">API</a>
           <a href="cookbook.html">Cookbook</a>
+          <a href="https://discord.gg/3avpC2nS" target="_blank" rel="noreferrer">Discord</a>
         </div>
       </div>
     </footer>