@magpiecloud/mags 1.8.5 → 1.8.7

package/API.md

@@ -212,12 +212,17 @@ HTTP services are also available via subdomain: `https://<subdomain>.apps.magpie
 PATCH /api/v1/mags-jobs/:id
 ```
 
-Update a job's startup command (used when waking from sleep).
+Update a job's settings. All fields are optional — only include the ones you want to change.
 
 **Request:**
 
+| Field | Type | Description |
+|-------|------|-------------|
+| `startup_command` | string | Command to run when VM wakes from sleep |
+| `no_sleep` | bool | If `true`, VM never auto-sleeps. If `false`, re-enables auto-sleep. Requires persistent VM. |
+
 ```json
-{ "startup_command": "python3 -m http.server 8080" }
+{ "no_sleep": true }
 ```
 
 **Response (200):**

package/QUICKSTART.md

@@ -139,6 +139,7 @@ mags run -w webapp-prod "..."
 | `mags list` | List jobs | `mags list -n 20` |
 | `mags logs ID` | View job logs | `mags logs abc123` |
 | `mags status ID` | Job status | `mags status abc123` |
+| `mags set ID` | Update VM settings | `mags set myvm --no-sleep` |
 
 ## CLI Flags
 

package/README.md

@@ -107,6 +107,7 @@ mags run -p --url 'python3 -m http.server 8080'
 | `mags list` | List recent jobs |
 | `mags url <job-id> [port]` | Enable URL access for a job |
 | `mags stop <job-id>` | Stop a running job |
+| `mags set <name\|id> [options]` | Update VM settings (`--no-sleep`, `--sleep`) |
 
 ### Run Options
 

package/bin/mags.js

@@ -211,6 +211,7 @@ ${colors.bold}Commands:${colors.reset}
   url alias <sub> <workspace>    Create a stable URL alias for a workspace
   url alias list                 List your URL aliases
   url alias remove <subdomain>   Delete a URL alias
+  set <name|id> [options]          Update VM settings
   stop <name|id>                  Stop a running job
   resize <workspace> --disk <GB>  Resize a workspace's disk (restarts VM)
   sync <workspace|id>             Sync workspace to S3 (without stopping)
@@ -595,8 +596,8 @@ async function runJob(args) {
   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) {
@@ -609,7 +610,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;
       }
@@ -633,7 +634,7 @@ async function runJob(args) {
     }
 
     process.stdout.write('.');
-    await sleep(1000);
+    await sleep(200);
     attempt++;
   }
 
@@ -829,6 +830,48 @@ async function stopJob(nameOrId) {
   }
 }
 
+async function setJobSettings(args) {
+  let nameOrId = null;
+  let noSleep = null;
+
+  for (let i = 0; i < args.length; i++) {
+    if (args[i] === '--no-sleep') {
+      noSleep = true;
+    } else if (args[i] === '--sleep') {
+      noSleep = false;
+    } else if (!nameOrId) {
+      nameOrId = args[i];
+    }
+  }
+
+  if (!nameOrId) {
+    log('red', 'Error: Job name or ID required');
+    console.log(`\nUsage: mags set <name|id> [options]\n`);
+    console.log('Options:');
+    console.log('  --no-sleep   Never auto-sleep this VM');
+    console.log('  --sleep      Re-enable auto-sleep');
+    process.exit(1);
+  }
+
+  const payload = {};
+  if (noSleep !== null) payload.no_sleep = noSleep;
+
+  if (Object.keys(payload).length === 0) {
+    log('red', 'Error: No settings to update. Use --no-sleep or --sleep');
+    process.exit(1);
+  }
+
+  const requestId = await resolveJobId(nameOrId);
+  log('blue', `Updating settings for ${requestId}...`);
+  const resp = await request('PATCH', `/api/v1/mags-jobs/${requestId}`, payload);
+  if (resp.success) {
+    if (noSleep === true) log('green', 'VM set to never auto-sleep');
+    if (noSleep === false) log('green', 'VM set to auto-sleep when idle');
+  } else {
+    log('red', `Failed: ${resp.error || 'unknown error'}`);
+  }
+}
+
 async function resizeVM(args) {
   let name = null;
   let diskGB = 0;
@@ -1452,7 +1495,7 @@ async function sshToJob(nameOrId) {
         process.exit(1);
       }
       process.stdout.write('.');
-      await sleep(1000);
+      await sleep(300);
     }
     console.log('');
   }
@@ -1628,7 +1671,7 @@ async function main() {
         break;
       case '--version':
       case '-v':
-        console.log('mags v1.8.5');
+        console.log('mags v1.8.7');
         process.exit(0);
         break;
       case 'new':
@@ -1671,6 +1714,10 @@ async function main() {
         await requireAuth();
         await listJobs();
         break;
+      case 'set':
+        await requireAuth();
+        await setJobSettings(args.slice(1));
+        break;
       case 'stop':
         await requireAuth();
         await stopJob(args[1]);

package/package.json

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

package/python/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "magpie-mags"
-version = "1.3.3"
+version = "1.3.4"
 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.2
+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

@@ -202,11 +202,26 @@ class Mags:
             "GET", "/mags-jobs", params={"page": page, "page_size": page_size}
         )
 
-    def update_job(self, request_id: str, *, startup_command: str) -> dict:
-        """Update a job (e.g. set startup command for wake-from-sleep)."""
-        return self._request(
-            "PATCH", f"/mags-jobs/{request_id}", json={"startup_command": startup_command}
-        )
+    def update_job(
+        self,
+        request_id: str,
+        *,
+        startup_command: str | None = None,
+        no_sleep: bool | None = None,
+    ) -> dict:
+        """Update a job's settings.
+
+        Args:
+            request_id: The job/workspace ID to update.
+            startup_command: Command to run when VM wakes from sleep.
+            no_sleep: If True, VM never auto-sleeps. If False, re-enables auto-sleep.
+        """
+        payload: dict = {}
+        if startup_command is not None:
+            payload["startup_command"] = startup_command
+        if no_sleep is not None:
+            payload["no_sleep"] = no_sleep
+        return self._request("PATCH", f"/mags-jobs/{request_id}", json=payload)
 
     def enable_access(self, request_id: str, *, port: int = 8080) -> dict:
         """Enable external access (URL or SSH) for a persistent job's VM.

package/website/api.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>
     <style>
       .endpoint { margin-bottom: 2.5rem; }
@@ -109,11 +109,11 @@
         </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="claude-skill.html">Claude Skill</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>
@@ -617,29 +617,57 @@ const access = await mags.enableAccess(requestId, { port: 8080 });</code></pre>
               <span class="method patch">PATCH</span>
               <span class="url-path">/api/v1/mags-jobs/:id</span>
             </div>
-            <p>Update a job's startup command (used when waking from sleep).</p>
+            <p>Update a job's settings. All fields are optional &mdash; only include the ones you want to change.</p>
 
             <p class="response-label">Request body</p>
-            <pre><code>{ "startup_command": "python3 -m http.server 8080" }</code></pre>
+            <div class="ref-table-wrap">
+              <table class="ref-table">
+                <thead><tr><th>Field</th><th>Type</th><th>Description</th></tr></thead>
+                <tbody>
+                  <tr><td><code>startup_command</code></td><td>string</td><td>Command to run when VM wakes from sleep</td></tr>
+                  <tr><td><code>no_sleep</code></td><td>bool</td><td>If <code>true</code>, VM never auto-sleeps. If <code>false</code>, re-enables auto-sleep. Requires persistent VM.</td></tr>
+                </tbody>
+              </table>
+            </div>
+            <pre><code>{ "no_sleep": true }</code></pre>
 
             <div class="code-tabs tab-group">
               <p class="response-label">SDK examples</p>
               <div class="tab-bar">
                 <button class="tab active" data-tab="uj-curl">curl</button>
+                <button class="tab" data-tab="uj-cli">CLI</button>
                 <button class="tab" data-tab="uj-py">Python</button>
                 <button class="tab" data-tab="uj-js">Node.js</button>
               </div>
               <div class="tab-content active" data-tab="uj-curl">
-                <pre><code>curl -X PATCH https://api.magpiecloud.com/api/v1/mags-jobs/$ID \
+                <pre><code># Enable no-sleep
+curl -X PATCH https://api.magpiecloud.com/api/v1/mags-jobs/$ID \
+  -H "Authorization: Bearer $TOKEN" \
+  -H "Content-Type: application/json" \
+  -d '{ "no_sleep": true }'
+
+# Set startup command
+curl -X PATCH https://api.magpiecloud.com/api/v1/mags-jobs/$ID \
   -H "Authorization: Bearer $TOKEN" \
   -H "Content-Type: application/json" \
   -d '{ "startup_command": "python3 -m http.server 8080" }'</code></pre>
+              </div>
+              <div class="tab-content" data-tab="uj-cli">
+                <pre><code># Enable no-sleep on an existing VM
+mags set myvm --no-sleep
+
+# Re-enable auto-sleep
+mags set myvm --sleep</code></pre>
               </div>
               <div class="tab-content" data-tab="uj-py">
-                <pre><code>m.update_job(request_id, startup_command="python3 -m http.server 8080")</code></pre>
+                <pre><code># Enable no-sleep
+m.update_job(request_id, no_sleep=True)
+
+# Set startup command
+m.update_job(request_id, startup_command="python3 -m http.server 8080")</code></pre>
               </div>
               <div class="tab-content" data-tab="uj-js">
-                <pre><code>await mags.updateJob(requestId, { startupCommand: 'python3 -m http.server 8080' });</code></pre>
+                <pre><code>await mags.updateJob(requestId, { noSleep: true });</code></pre>
               </div>
             </div>
           </div>
@@ -924,16 +952,15 @@ 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>
     </footer>
 
-    <script src="script.js?v=2"></script>
+    <script src="script.js?v=7"></script>
   </body>
 </html>

package/website/claude-skill.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,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,17 +468,14 @@ 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>
 
-    <script src="script.js"></script>
+    <script src="script.js?v=7"></script>
   </body>
 </html>

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,11 @@
         </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="tokens.html">Tokens</a>
+          <a href="index.html#quickstart">Docs</a>
+          <a href="api.html">API</a>
           <a href="claude-skill.html">Claude Skill</a>
+          <a href="https://discord.gg/3avpC2nS" target="_blank" rel="noreferrer">Discord</a>
+          <a href="login.html">Login</a>
         </nav>
         <div class="nav-cta">
           <a class="button ghost" href="index.html#quickstart">Get started</a>
@@ -171,18 +169,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,15 +269,14 @@ 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>
 
-    <script src="script.js"></script>
+    <script src="script.js?v=7"></script>
   </body>
 </html>

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">
@@ -205,6 +198,7 @@ mags login</code></pre>
                       <tr><td><code>mags status &lt;id&gt;</code></td><td>Get job status</td></tr>
                       <tr><td><code>mags logs &lt;id&gt;</code></td><td>Get job output</td></tr>
                       <tr><td><code>mags stop &lt;id&gt;</code></td><td>Stop a running job</td></tr>
+                      <tr><td><code>mags set &lt;id&gt; [options]</code></td><td>Update VM settings (e.g. <code>--no-sleep</code>, <code>--sleep</code>)</td></tr>
                       <tr><td><code>mags sync &lt;workspace&gt;</code></td><td>Sync workspace to the cloud now</td></tr>
                       <tr><td><code>mags url &lt;id&gt; [port]</code></td><td>Enable public URL access</td></tr>
                       <tr><td><code>mags workspace list</code></td><td>List persistent workspaces</td></tr>
@@ -513,6 +507,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,20 +725,21 @@ 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>
     </footer>
 
-    <script src="script.js?v=5"></script>
+    <script src="script.js?v=7"></script>
     <script>
     (function() {
       var token = localStorage.getItem('microvm-access-token');
       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/llms.txt

@@ -35,6 +35,8 @@ mags run 'echo Hello World'
 - `mags logs <job-id>` — View job logs
 - `mags status <job-id>` — Check job status
 - `mags stop <job-id>` — Stop a running job
+- `mags set <name|id> --no-sleep` — Never auto-sleep this VM
+- `mags set <name|id> --sleep` — Re-enable auto-sleep
 
 ## Run Options
 

package/website/login.html

@@ -4,10 +4,10 @@
     <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" />
+    <link rel="stylesheet" href="styles.css?v=6" />
     <script src="env.js"></script>
   </head>
   <body>
@@ -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,13 +57,52 @@
         </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>
 
-    <script src="script.js"></script>
+    <script src="script.js?v=7"></script>
+    <script>
+    (function() {
+      // Handle logout: clear tokens when ?logout=1 is present
+      var params = new URLSearchParams(window.location.search);
+      if (params.get('logout') === '1') {
+        localStorage.removeItem('microvm-access-token');
+        localStorage.removeItem('microvm-refresh-token');
+        // Clean up the URL
+        window.history.replaceState({}, '', 'login.html');
+        return;
+      }
+
+      // If already logged in, redirect to next or show dashboard link
+      var token = localStorage.getItem('microvm-access-token');
+      if (token) {
+        var next = params.get('next');
+        if (next && next.startsWith('/')) {
+          window.location.replace(next);
+          return;
+        }
+        var shell = document.querySelector('.auth-shell');
+        if (shell) {
+          shell.innerHTML =
+            '<div>' +
+              '<span class="pill">Logged in</span>' +
+              '<h1 class="auth-title">You\'re signed in.</h1>' +
+              '<p class="auth-subtitle">You\'re already logged in to Mags.</p>' +
+            '</div>' +
+            '<a class="button full" href="usage.html">Go to Dashboard</a>' +
+            '<button class="button ghost full" type="button" id="logout-btn" style="margin-top:0.75rem">Sign out</button>';
+          document.getElementById('logout-btn').addEventListener('click', function() {
+            localStorage.removeItem('microvm-access-token');
+            localStorage.removeItem('microvm-refresh-token');
+            window.location.reload();
+          });
+        }
+      }
+    })();
+    </script>
   </body>
 </html>

package/website/mags.md

@@ -71,6 +71,12 @@ mags url <name-or-id> [port]
 mags stop <name-or-id>
 ```
 
+### Update VM settings
+```bash
+mags set <name-or-id> --no-sleep    # Never auto-sleep
+mags set <name-or-id> --sleep       # Re-enable auto-sleep
+```
+
 ### Run without workspace (ephemeral, fastest)
 ```bash
 mags run -e '<script>'

package/website/script.js

@@ -87,6 +87,30 @@ const tokenStore = {
   },
 };
 
+/* ── Extract tokens from URL after OAuth callback redirect ── */
+(function () {
+  var params = new URLSearchParams(window.location.search);
+  var token = params.get('token');
+  var refresh = params.get('refresh');
+  if (token && refresh) {
+    tokenStore.setTokens({ accessToken: token, refreshToken: refresh });
+    params.delete('token');
+    params.delete('refresh');
+    var clean = window.location.pathname;
+    var remaining = params.toString();
+    if (remaining) clean += '?' + remaining;
+    window.history.replaceState({}, '', clean);
+  }
+})();
+
+/* ── Redirect to login for protected pages when not authed ── */
+(function () {
+  if (!document.querySelector('[data-auth-required]')) return;
+  if (tokenStore.getAccessToken()) return;
+  var next = window.location.pathname + window.location.search;
+  window.location.replace('login.html?next=' + encodeURIComponent(next));
+})();
+
 const refreshTokens = async () => {
   const refreshToken = tokenStore.getRefreshToken();
   if (!refreshToken) return null;
@@ -183,7 +207,10 @@ copyButtons.forEach((button) => {
 const googleLogin = document.querySelector('[data-google-login]');
 if (googleLogin) {
   googleLogin.addEventListener('click', () => {
-    window.location.href = withBase('/auth/google', AUTH_BASE);
+    var url = withBase('/auth/google', AUTH_BASE);
+    var next = new URLSearchParams(window.location.search).get('next');
+    if (next) url += (url.includes('?') ? '&' : '?') + 'next=' + encodeURIComponent(next);
+    window.location.href = url;
   });
 }
 
@@ -223,11 +250,12 @@ if (loginForm) {
         refreshToken: data.refresh_token,
       });
       if (message) {
-        message.textContent = 'Signed in. Redirecting to usage...';
+        message.textContent = 'Signed in. Redirecting...';
       }
       loginForm.reset();
+      var dest = new URLSearchParams(window.location.search).get('next') || 'usage.html';
       setTimeout(() => {
-        window.location.href = 'usage.html';
+        window.location.href = dest;
       }, 600);
     } catch (error) {
       if (message) {

package/website/tokens.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,16 +24,14 @@
         </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="claude-skill.html">Claude Skill</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>
+          <a class="button ghost" href="usage.html">Usage</a>
         </div>
       </div>
     </header>
@@ -49,7 +47,7 @@
               the dashboard and store them securely.
             </p>
             <div class="hero-actions">
-              <a class="button" href="/api-keys">Open token manager</a>
+              <a class="button" href="#tokens">Create a token</a>
               <a class="button ghost" href="#usage">Usage in CLI</a>
             </div>
           </div>
@@ -93,7 +91,7 @@ mags whoami</code></pre>
             <h2>Manage active tokens.</h2>
           </div>
           <div class="callout" data-auth-required>
-            <p>Sign in to view and create tokens. Use <a data-auth-link="/auth/login" href="#">email login</a> or <a data-auth-link="/auth/google" href="#">Google sign-in</a>.</p>
+            <p>Sign in to view and create tokens. <a href="login.html?next=/tokens.html">Sign in with Google</a>.</p>
           </div>
           <div class="grid split" style="margin-bottom: 1.6rem;">
             <article class="panel" data-reveal>
@@ -158,14 +156,14 @@ 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>
 
-    <script src="script.js"></script>
+    <script src="script.js?v=7"></script>
   </body>
 </html>

package/website/usage.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,16 +24,14 @@
         </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="claude-skill.html">Claude Skill</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>
+          <a class="button ghost" href="tokens.html">Tokens</a>
         </div>
       </div>
     </header>
@@ -74,7 +72,7 @@ mags logs &lt;job-id&gt;</code></pre>
             <h2>Your most recent activity.</h2>
           </div>
           <div class="callout" data-auth-required>
-            <p>Sign in to see usage data. Use <a data-auth-link="/auth/login" href="#">email login</a> or <a data-auth-link="/auth/google" href="#">Google sign-in</a>.</p>
+            <p>Sign in to see usage data. <a href="login.html?next=/usage.html">Sign in with Google</a>.</p>
           </div>
           <div class="stats-grid" data-reveal>
             <div class="stat-card">
@@ -174,14 +172,14 @@ 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>
 
-    <script src="script.js"></script>
+    <script src="script.js?v=7"></script>
   </body>
 </html>