@magpiecloud/mags 1.8.11 → 1.8.13

package/README.md

@@ -6,9 +6,9 @@ Execute scripts instantly on Magpie's microVM infrastructure. VMs boot in <100ms
 
 Mags is a CLI and SDK for running scripts on ephemeral microVMs. Each execution gets its own isolated VM that:
 
-- Boots in <100ms (from warm pool)
-- Has persistent workspaces synced to S3
-- Syncs /root directory automatically every 30 seconds
+- Boots in ~300ms (from warm pool)
+- Supports optional S3-backed persistent workspaces (with `-p` flag)
+- Syncs /root directory automatically when persistence is enabled
 - Can expose public URLs for web services
 - Provides SSH access through secure proxy
 - Auto-sleeps when idle and wakes on request
@@ -51,16 +51,17 @@ export MAGS_API_TOKEN="your-token-here"
 mags run 'echo Hello World'
 ```
 
-### Create a persistent VM
+### Create a sandbox
 
 ```bash
-# Create a new VM with workspace "myproject"
+# Create a new VM (local disk only)
 mags new myproject
 
+# Create with S3 data persistence
+mags new myproject -p
+
 # SSH into it
 mags ssh myproject
-
-# Your /root directory persists to S3 automatically
 ```
 
 ### Run with a persistent workspace
@@ -91,7 +92,7 @@ mags run -p --url 'python3 -m http.server 8080'
 | `mags login` | Authenticate with Magpie (saves token locally) |
 | `mags logout` | Remove saved credentials |
 | `mags whoami` | Show current authentication status |
-| `mags new <workspace>` | Create a persistent VM with workspace |
+| `mags new <workspace> [-p]` | Create a VM sandbox (add `-p` for S3 persistence) |
 | `mags run [options] <script>` | Execute a script on a microVM |
 | `mags ssh <workspace>` | Open interactive SSH session to a VM |
 | `mags status <job-id>` | Get job status |
@@ -230,7 +231,7 @@ If an always-on VM's host becomes unhealthy, the orchestrator automatically re-p
 ### Interactive Development
 
 ```bash
-# Create a persistent dev environment
+# Create a dev environment (local disk)
 mags new dev-env
 
 # SSH in and work
@@ -263,7 +264,7 @@ const mags = new Mags({
 |--------|-------------|
 | `run(script, options)` | Submit a job. Options: `name`, `workspaceId`, `baseWorkspaceId`, `persistent`, `noSleep`, `ephemeral`, `startupCommand`, `environment`, `fileIds`, `diskGb` |
 | `runAndWait(script, options)` | Submit and block until done. Extra options: `timeout`, `pollInterval` |
-| `new(name, options)` | Create a persistent VM and wait until running. Options: `baseWorkspaceId`, `diskGb`, `timeout` |
+| `new(name, options)` | Create a VM sandbox and wait until running. Options: `persistent`, `baseWorkspaceId`, `diskGb`, `timeout` |
 | `status(requestId)` | Get job status |
 | `logs(requestId)` | Get job logs |
 | `list({page, pageSize})` | List recent jobs (paginated) |
@@ -315,9 +316,12 @@ const mags = new Mags({
 const result = await mags.runAndWait('echo Hello World');
 console.log(result.logs);
 
-// Create a persistent VM
+// Create a sandbox (local disk)
 await mags.new('myproject');
 
+// Create a sandbox with S3 persistence
+await mags.new('myproject', { persistent: true });
+
 // Execute command on existing VM
 const { output } = await mags.exec('myproject', 'ls -la /root');
 console.log(output);
@@ -415,7 +419,7 @@ mags run 'apk add ffmpeg imagemagick'
 
 | Metric | Value |
 |--------|-------|
-| Warm start | <100ms |
+| Warm start | ~300ms |
 | Cold start | ~4 seconds |
 | Script overhead | ~50ms |
 | Workspace sync | Every 30 seconds |

package/bin/mags.js

@@ -246,7 +246,8 @@ ${colors.bold}Cron Options:${colors.reset}
 
 ${colors.bold}Examples:${colors.reset}
   mags login
-  mags new myvm                     # Create VM, get ID
+  mags new myvm                     # Create VM (local disk only)
+  mags new myvm -p                   # Create VM with S3 persistence
   mags ssh myvm                     # SSH (auto-starts if needed)
   mags exec myvm 'ls -la'           # Run command on existing VM
   mags run 'echo Hello World'
@@ -407,9 +408,12 @@ async function newVM(args) {
   let name = null;
   let baseWorkspace = null;
   let diskGB = 0;
+  let persistent = false;
 
   for (let i = 0; i < args.length; i++) {
-    if (args[i] === '--base' && args[i + 1]) {
+    if (args[i] === '-p' || args[i] === '--persistent') {
+      persistent = true;
+    } else if (args[i] === '--base' && args[i + 1]) {
       baseWorkspace = args[++i];
     } else if (args[i] === '--disk' && args[i + 1]) {
       diskGB = parseInt(args[++i]) || 0;
@@ -420,17 +424,36 @@ async function newVM(args) {
 
   if (!name) {
     log('red', 'Error: Name required');
-    console.log(`\nUsage: mags new <name> [--base <workspace>] [--disk <GB>]\n`);
+    console.log(`\nUsage: mags new <name> [-p] [--base <workspace>] [--disk <GB>]`);
+    console.log(`  -p, --persistent  Enable S3 data persistence\n`);
     process.exit(1);
   }
 
+  // Check if a VM with this name already exists (running or sleeping)
+  try {
+    const jobs = await request('GET', '/api/v1/mags-jobs');
+    const existing = (jobs.jobs || []).find(j =>
+      j.name === name && (j.status === 'running' || j.status === 'sleeping')
+    );
+    if (existing) {
+      log('yellow', `Sandbox '${name}' already exists (status: ${existing.status})`);
+      console.log(`  SSH:  mags ssh ${name}`);
+      console.log(`  Exec: mags exec ${name} <command>`);
+      console.log(`  Stop: mags stop ${name}`);
+      process.exit(0);
+    }
+  } catch (e) {
+    // Non-fatal — proceed with creation if list fails
+  }
+
   const payload = {
     script: 'sleep infinity',
     type: 'inline',
     persistent: true,
     name: name,
     workspace_id: name,
-    startup_command: 'sleep infinity'
+    startup_command: 'sleep infinity',
+    no_sync: !persistent
   };
   if (baseWorkspace) payload.base_workspace_id = baseWorkspace;
   if (diskGB) payload.disk_gb = diskGB;
@@ -451,9 +474,12 @@ async function newVM(args) {
     const status = await request('GET', `/api/v1/mags-jobs/${response.request_id}/status`);
 
     if (status.status === 'running') {
-      log('green', `VM '${name}' created successfully`);
+      log('green', `VM '${name}' created successfully${persistent ? ' (persistent)' : ' (local disk)'}`);
       console.log(`  ID:  ${response.request_id}`);
       console.log(`  SSH: mags ssh ${name}`);
+      if (!persistent) {
+        log('gray', `  Data is on local disk only. Use -p flag for S3 persistence.`);
+      }
       return;
     } else if (status.status === 'error') {
       log('red', `VM creation failed: ${status.error_message || 'Unknown error'}`);

package/index.js

@@ -123,6 +123,7 @@ class Mags {
     };
 
     if (options.noSleep) payload.no_sleep = true;
+    if (options.noSync) payload.no_sync = true;
     if (options.name) payload.name = options.name;
     if (!options.ephemeral && options.workspaceId) payload.workspace_id = options.workspaceId;
     if (options.baseWorkspaceId) payload.base_workspace_id = options.baseWorkspaceId;
@@ -262,9 +263,12 @@ class Mags {
   }
 
   /**
-   * Create a new persistent VM workspace and wait until it's running
+   * Create a new VM sandbox and wait until it's running.
+   * By default, data lives on local disk only (no S3 sync).
+   * Pass persistent: true to enable S3 data persistence.
    * @param {string} name - Workspace name
    * @param {object} options - Options
+   * @param {boolean} options.persistent - Enable S3 data persistence (default: false)
    * @param {string} options.baseWorkspaceId - Read-only base workspace to mount
    * @param {number} options.diskGb - Custom disk size in GB
    * @param {number} options.timeout - Timeout in ms (default: 30000)
@@ -278,6 +282,7 @@ class Mags {
     const result = await this.run('sleep infinity', {
       workspaceId: name,
       persistent: true,
+      noSync: !options.persistent,
       baseWorkspaceId: options.baseWorkspaceId,
       diskGb: options.diskGb,
     });
@@ -419,7 +424,7 @@ class Mags {
       await new Promise(resolve => setTimeout(resolve, 1000));
     }
 
-    return this.new(workspace, { diskGb, timeout: options.timeout, pollInterval: options.pollInterval });
+    return this.new(workspace, { persistent: true, diskGb, timeout: options.timeout, pollInterval: options.pollInterval });
   }
 
   /**

package/nodejs/README.md

@@ -18,10 +18,11 @@ mags login
 
 This will open your browser to create an API token. Paste the token when prompted, and it will be saved for future use.
 
-### 2. Create a persistent VM
+### 2. Create a sandbox
 
 ```bash
-mags new myproject
+mags new myproject              # Local disk only
+mags new myproject -p           # With S3 persistence
 mags ssh myproject
 ```
 
@@ -59,9 +60,12 @@ export MAGS_API_TOKEN="your-token-here"
 ## CLI Commands
 
 ```bash
-# Create a persistent VM
+# Create a sandbox (local disk)
 mags new myproject
 
+# Create with S3 persistence
+mags new myproject -p
+
 # SSH into it
 mags ssh myproject
 
@@ -135,11 +139,13 @@ Features:
 
 ## Workspaces & Persistence
 
-Your `/root` directory automatically syncs to S3:
+When using persistent mode (`-p`), your `/root` directory syncs to S3:
 - **Auto-sync**: Every 30 seconds while running
 - **On stop**: Full sync before VM terminates
 - **On wake**: Previous state restored
 
+Without `-p`, data lives on local disk only and is cleaned up when the VM is destroyed.
+
 ## Node.js SDK
 
 ```javascript

package/package.json

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

package/python/README.md

@@ -131,19 +131,23 @@ print(f"Jobs: {usage['total_jobs']}, VM seconds: {usage['vm_seconds']:.0f}")
 |--------|-------------|
 | `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 |
+| `new(name, **opts)` | Create a VM sandbox (`persistent=True` for S3) |
 | `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 |
+| `url(name_or_id, port)` | Enable public URL and return full URL |
 | `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 |
-| `update_job(request_id, startup_command)` | Update job config |
+| `update_job(request_id, **opts)` | Update job config (`startup_command`, `no_sleep`) |
 | `enable_access(request_id, port)` | Enable URL or SSH access |
 | `usage(window_days)` | Get usage summary |
 | `upload_file(path)` | Upload a file, returns file ID |
 | `upload_files(paths)` | Upload multiple files |
+| `url_alias_create(sub, ws_id)` | Create a stable URL alias |
+| `url_alias_list()` | List URL aliases |
+| `url_alias_delete(sub)` | Delete a URL alias |
 | `cron_create(**opts)` | Create a cron job |
 | `cron_list()` | List cron jobs |
 | `cron_get(id)` | Get a cron job |
@@ -154,4 +158,4 @@ print(f"Jobs: {usage['total_jobs']}, VM seconds: {usage['vm_seconds']:.0f}")
 
 - Website: [mags.run](https://mags.run)
 - Node.js SDK: `npm install @magpiecloud/mags`
-- CLI: `go install` or download from releases
+- CLI: `npm install -g @magpiecloud/mags`

package/python/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "magpie-mags"
-version = "1.3.4"
+version = "1.3.6"
 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.4
+Version: 1.3.5
 Summary: Mags SDK - Execute scripts on Magpie's instant VM infrastructure
 Author: Magpie Cloud
 License: MIT
@@ -156,7 +156,7 @@ print(f"Jobs: {usage['total_jobs']}, VM seconds: {usage['vm_seconds']:.0f}")
 |--------|-------------|
 | `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 |
+| `new(name, **opts)` | Create a VM sandbox (`persistent=True` for S3) |
 | `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 |

package/python/src/mags/client.py

@@ -106,6 +106,7 @@ class Mags:
         environment: Dict[str, str] | None = None,
         file_ids: List[str] | None = None,
         disk_gb: int | None = None,
+        no_sync: bool = False,
     ) -> dict:
         """Submit a job for execution.
 
@@ -122,6 +123,7 @@ class Mags:
             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).
+            no_sync: Skip S3 sync, use local disk only.
 
         Returns ``{"request_id": ..., "status": "accepted"}``.
         """
@@ -139,6 +141,8 @@ class Mags:
         }
         if no_sleep:
             payload["no_sleep"] = True
+        if no_sync:
+            payload["no_sync"] = True
         if name:
             payload["name"] = name
         if not ephemeral and workspace_id:
@@ -262,20 +266,25 @@ class Mags:
             self._request("POST", f"/mags-jobs/{existing['request_id']}/stop")
             time.sleep(1)
 
-        return self.new(workspace, disk_gb=disk_gb, timeout=timeout, poll_interval=poll_interval)
+        return self.new(workspace, persistent=True, disk_gb=disk_gb,
+                        timeout=timeout, poll_interval=poll_interval)
 
     def new(
         self,
         name: str,
         *,
+        persistent: bool = False,
         base_workspace_id: str | None = None,
         disk_gb: int | None = None,
         timeout: float = 30.0,
         poll_interval: float = 1.0,
     ) -> dict:
-        """Create a new persistent VM workspace and wait until it's running.
+        """Create a new VM sandbox and wait until it's running.
+
+        By default, data lives on local disk only (no S3 sync).
+        Pass ``persistent=True`` to enable S3 data persistence.
 
-        Equivalent to ``mags new <name>``.
+        Equivalent to ``mags new <name>`` or ``mags new <name> -p``.
 
         Returns ``{"request_id": ..., "status": "running"}``.
         """
@@ -283,6 +292,7 @@ class Mags:
             "sleep infinity",
             workspace_id=name,
             persistent=True,
+            no_sync=not persistent,
             base_workspace_id=base_workspace_id,
             disk_gb=disk_gb,
         )

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=6" />
+    <link rel="stylesheet" href="styles.css?v=7" />
     <script src="env.js"></script>
     <style>
       .endpoint { margin-bottom: 2.5rem; }
@@ -252,7 +252,7 @@ m = Mags(api_token="your-token")
                 <tr>
                   <td><code>"my-ws"</code></td>
                   <td><em>omit</em></td>
-                  <td>Read+write workspace. Changes persist across runs.</td>
+                  <td>Local workspace. Data stays on the VM only (not synced to S3). Add <code>persistent: true</code> to sync to S3.</td>
                 </tr>
                 <tr>
                   <td><em>omit</em></td>
@@ -283,11 +283,14 @@ m = Mags(api_token="your-token")
             <a href="#get-status">Get Status</a>
             <a href="#get-logs">Get Logs</a>
             <a href="#list-jobs">List Jobs</a>
+            <a href="#stop-job">Stop Job</a>
             <a href="#enable-access">Enable Access</a>
             <a href="#update-job">Update Job</a>
+            <a href="#sync-workspace">Sync Workspace</a>
             <a href="#upload-file">Upload File</a>
             <a href="#list-workspaces">List Workspaces</a>
             <a href="#delete-workspace">Delete Workspace</a>
+            <a href="#url-aliases">URL Aliases</a>
             <a href="#cron-endpoints">Cron Jobs</a>
           </div>
 
@@ -322,7 +325,7 @@ m = Mags(api_token="your-token")
                   <td><code>workspace_id</code></td>
                   <td>string</td>
                   <td>no</td>
-                  <td>Persistent workspace name. Filesystem changes are synced to S3 and restored on next run. Omit for ephemeral.</td>
+                  <td>Workspace name. With <code>persistent: false</code>, data stays local to the VM only. With <code>persistent: true</code>, filesystem changes are synced to S3 and restored on next run. Omit for ephemeral.</td>
                 </tr>
                 <tr>
                   <td><code>base_workspace_id</code></td>
@@ -334,7 +337,7 @@ m = Mags(api_token="your-token")
                   <td><code>persistent</code></td>
                   <td>bool</td>
                   <td>no</td>
-                  <td>If <code>true</code>, VM stays alive after script finishes.</td>
+                  <td>If <code>true</code>, VM stays alive after script finishes and workspace is synced to S3. Required for cloud persistence.</td>
                 </tr>
                 <tr>
                   <td><code>no_sleep</code></td>
@@ -542,12 +545,48 @@ for job in resp["jobs"]:
     print(job["request_id"], job["status"])</code></pre>
               </div>
               <div class="tab-content" data-tab="lj-js">
-                <pre><code>const resp = await mags.listJobs({ page: 1, pageSize: 10 });
+                <pre><code>const resp = await mags.list({ page: 1, pageSize: 10 });
 resp.jobs.forEach(j => console.log(j.requestId, j.status));</code></pre>
               </div>
             </div>
           </div>
 
+          <!-- Stop Job -->
+          <div class="endpoint card wide" id="stop-job" data-reveal>
+            <h3>Stop Job</h3>
+            <div class="method-url">
+              <span class="method post">POST</span>
+              <span class="url-path">/api/v1/mags-jobs/:id/stop</span>
+            </div>
+            <p>Stop a running or sleeping job. The VM is terminated and the workspace is synced to S3 if persistent.</p>
+
+            <p class="response-label">Response (200)</p>
+            <pre><code>{ "success": true, "message": "Job stopped" }</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="sj2-curl">curl</button>
+                <button class="tab" data-tab="sj2-py">Python</button>
+                <button class="tab" data-tab="sj2-js">Node.js</button>
+                <button class="tab" data-tab="sj2-cli">CLI</button>
+              </div>
+              <div class="tab-content active" data-tab="sj2-curl">
+                <pre><code>curl -X POST https://api.magpiecloud.com/api/v1/mags-jobs/$ID/stop \
+  -H "Authorization: Bearer $TOKEN"</code></pre>
+              </div>
+              <div class="tab-content" data-tab="sj2-py">
+                <pre><code>m.stop("myproject")  # accepts name, workspace ID, or request ID</code></pre>
+              </div>
+              <div class="tab-content" data-tab="sj2-js">
+                <pre><code>await mags.stop('myproject'); // accepts name, workspace ID, or request ID</code></pre>
+              </div>
+              <div class="tab-content" data-tab="sj2-cli">
+                <pre><code>mags stop myproject</code></pre>
+              </div>
+            </div>
+          </div>
+
           <!-- Enable Access -->
           <div class="endpoint card wide" id="enable-access" data-reveal>
             <h3>Enable Access (SSH or HTTP)</h3>
@@ -601,11 +640,11 @@ print(access.get("url"))</code></pre>
               </div>
               <div class="tab-content" data-tab="ea-js">
                 <pre><code>// SSH access
-const ssh = await mags.enableAccess(requestId, { port: 22 });
+const ssh = await mags.enableAccess(requestId, 22);
 console.log(`ssh root@${ssh.sshHost} -p ${ssh.sshPort}`);
 
 // HTTP access
-const access = await mags.enableAccess(requestId, { port: 8080 });</code></pre>
+const access = await mags.enableAccess(requestId, 8080);</code></pre>
               </div>
             </div>
           </div>
@@ -714,6 +753,37 @@ file_ids = m.upload_files(["script.py", "data.csv"])</code></pre>
             </div>
           </div>
 
+          <!-- Sync Workspace -->
+          <div class="endpoint card wide" id="sync-workspace" data-reveal>
+            <h3>Sync Workspace</h3>
+            <div class="method-url">
+              <span class="method post">POST</span>
+              <span class="url-path">/api/v1/mags-jobs/:id/sync</span>
+            </div>
+            <p>Trigger an immediate workspace sync to S3 without stopping the VM.</p>
+
+            <p class="response-label">Response (200)</p>
+            <pre><code>{ "success": true, "message": "Sync initiated" }</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="sw-py">Python</button>
+                <button class="tab" data-tab="sw-js">Node.js</button>
+                <button class="tab" data-tab="sw-cli">CLI</button>
+              </div>
+              <div class="tab-content active" data-tab="sw-py">
+                <pre><code>m.sync(request_id)</code></pre>
+              </div>
+              <div class="tab-content" data-tab="sw-js">
+                <pre><code>await mags.sync(requestId);</code></pre>
+              </div>
+              <div class="tab-content" data-tab="sw-cli">
+                <pre><code>mags sync myproject</code></pre>
+              </div>
+            </div>
+          </div>
+
           <!-- List Workspaces -->
           <div class="endpoint card wide" id="list-workspaces" data-reveal>
             <h3>List Workspaces</h3>
@@ -794,6 +864,65 @@ mags workspace delete myproject --force  # skip confirmation</code></pre>
             </div>
           </div>
 
+          <!-- URL Aliases -->
+          <div class="endpoint card wide" id="url-aliases" data-reveal>
+            <h3>URL Aliases</h3>
+            <div class="method-url">
+              <span class="method post">POST</span>
+              <span class="url-path">/api/v1/mags-url-aliases</span>
+            </div>
+            <div class="method-url" style="margin-left:0.5rem">
+              <span class="method get">GET</span>
+              <span class="url-path">/api/v1/mags-url-aliases</span>
+            </div>
+            <div class="method-url" style="margin-left:0.5rem">
+              <span class="method delete">DELETE</span>
+              <span class="url-path">/api/v1/mags-url-aliases/:subdomain</span>
+            </div>
+            <p>Create stable, human-readable URL aliases for your sandboxes. Aliases point to a workspace and automatically follow the active VM.</p>
+
+            <p class="response-label">Create request body</p>
+            <table class="field-table">
+              <thead>
+                <tr><th>Field</th><th>Type</th><th>Required</th><th>Description</th></tr>
+              </thead>
+              <tbody>
+                <tr><td><code>subdomain</code></td><td>string</td><td><span class="required">YES</span></td><td>Subdomain for the alias (e.g. <code>my-api</code>).</td></tr>
+                <tr><td><code>workspace_id</code></td><td>string</td><td><span class="required">YES</span></td><td>Workspace to point the alias at.</td></tr>
+                <tr><td><code>domain</code></td><td>string</td><td>no</td><td>Custom domain (default: <code>apps.magpiecloud.com</code>).</td></tr>
+              </tbody>
+            </table>
+
+            <div class="code-tabs tab-group">
+              <p class="response-label">SDK examples</p>
+              <div class="tab-bar">
+                <button class="tab active" data-tab="ua-cli">CLI</button>
+                <button class="tab" data-tab="ua-py">Python</button>
+                <button class="tab" data-tab="ua-js">Node.js</button>
+              </div>
+              <div class="tab-content active" data-tab="ua-cli">
+                <pre><code># Create alias
+mags url alias my-api myproject
+
+# List aliases
+mags url alias list
+
+# Delete alias
+mags url alias remove my-api</code></pre>
+              </div>
+              <div class="tab-content" data-tab="ua-py">
+                <pre><code>m.url_alias_create("my-api", "myproject")
+aliases = m.url_alias_list()
+m.url_alias_delete("my-api")</code></pre>
+              </div>
+              <div class="tab-content" data-tab="ua-js">
+                <pre><code>await mags.urlAliasCreate('my-api', 'myproject');
+const aliases = await mags.urlAliasList();
+await mags.urlAliasDelete('my-api');</code></pre>
+              </div>
+            </div>
+          </div>
+
           <!-- Cron Endpoints -->
           <div class="endpoint card wide" id="cron-endpoints" data-reveal>
             <h3>Cron Jobs</h3>
@@ -961,6 +1090,6 @@ mags cron remove &lt;id&gt;</code></pre>
       </div>
     </footer>
 
-    <script src="script.js?v=7"></script>
+    <script src="script.js?v=8"></script>
   </body>
 </html>

package/website/cookbook.html

@@ -61,7 +61,7 @@ mags ssh dev-env
 
 # inside the VM
 apk add git nodejs npm</code></pre>
-            <p class="card-note">Create a persistent dev environment with one command.</p>
+            <p class="card-note">Create a dev sandbox with one command. Add <code>-p</code> for S3 persistence.</p>
           </div>
         </div>
       </section>