@magpiecloud/mags 1.8.6 → 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)
@@ -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;
@@ -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.6",
+  "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/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; }
@@ -111,6 +111,7 @@
           <a href="index.html">Home</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>
         </nav>
@@ -616,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>
@@ -932,6 +961,6 @@ mags cron remove &lt;id&gt;</code></pre>
       </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>
@@ -476,6 +476,6 @@ Use workspace "monitors" so the log persists</code></pre>
       </div>
     </footer>
 
-    <script src="script.js"></script>
+    <script src="script.js?v=7"></script>
   </body>
 </html>

package/website/cookbook.html

@@ -26,6 +26,7 @@
           <a href="index.html">Home</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>
@@ -276,6 +277,6 @@ curl -X POST https://api.magpiecloud.com/api/v1/mags-cron \
       </div>
     </footer>
 
-    <script src="script.js"></script>
+    <script src="script.js?v=7"></script>
   </body>
 </html>

package/website/index.html

@@ -198,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>
@@ -730,7 +731,7 @@ console.log(result.logs);</code></pre>
       </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');

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

@@ -7,7 +7,7 @@
     <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>
@@ -64,6 +64,45 @@
       </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>
@@ -27,10 +27,11 @@
           <a href="usage.html">Usage</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>
@@ -46,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>
@@ -90,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>
@@ -163,6 +164,6 @@ mags whoami</code></pre>
       </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>
@@ -27,10 +27,11 @@
           <a href="tokens.html">Tokens</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>
@@ -71,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">
@@ -179,6 +180,6 @@ mags cron add --name "backup" \
       </div>
     </footer>
 
-    <script src="script.js"></script>
+    <script src="script.js?v=7"></script>
   </body>
 </html>