npm - @magpiecloud/mags - Versions diffs - 1.8.13 → 1.8.15 - Mend

@magpiecloud/mags 1.8.13 → 1.8.15

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (43) hide show

package/README.md +95 -378
package/bin/mags.js +196 -104
package/index.js +6 -52
package/package.json +22 -4
package/API.md +0 -388
package/Mags-API.postman_collection.json +0 -374
package/QUICKSTART.md +0 -295
package/deploy-page.sh +0 -171
package/mags +0 -0
package/mags.sh +0 -270
package/nodejs/README.md +0 -197
package/nodejs/bin/mags.js +0 -1146
package/nodejs/index.js +0 -642
package/nodejs/package.json +0 -42
package/python/INTEGRATION.md +0 -800
package/python/README.md +0 -161
package/python/dist/magpie_mags-1.3.5-py3-none-any.whl +0 -0
package/python/dist/magpie_mags-1.3.5.tar.gz +0 -0
package/python/examples/demo.py +0 -181
package/python/pyproject.toml +0 -39
package/python/src/magpie_mags.egg-info/PKG-INFO +0 -182
package/python/src/magpie_mags.egg-info/SOURCES.txt +0 -9
package/python/src/magpie_mags.egg-info/dependency_links.txt +0 -1
package/python/src/magpie_mags.egg-info/requires.txt +0 -1
package/python/src/magpie_mags.egg-info/top_level.txt +0 -1
package/python/src/mags/__init__.py +0 -6
package/python/src/mags/client.py +0 -573
package/python/test_sdk.py +0 -78
package/skill.md +0 -153
package/website/api.html +0 -1095
package/website/claude-skill.html +0 -481
package/website/cookbook/hn-marketing.html +0 -410
package/website/cookbook/hn-marketing.sh +0 -42
package/website/cookbook.html +0 -282
package/website/env.js +0 -4
package/website/index.html +0 -801
package/website/llms.txt +0 -334
package/website/login.html +0 -108
package/website/mags.md +0 -210
package/website/script.js +0 -453
package/website/styles.css +0 -908
package/website/tokens.html +0 -169
package/website/usage.html +0 -185

package/website/claude-skill.html DELETED Viewed

@@ -1,481 +0,0 @@
-<!doctype html>
-<html lang="en">
-  <head>
-    <meta charset="utf-8" />
-    <meta name="viewport" content="width=device-width, initial-scale=1" />
-    <title>Mags for Claude Code - Skill Integration</title>
-    <meta
-      name="description"
-      content="Integrate the Mags skill into Claude Code for on-demand microVM script execution with persistent workspaces, SSH access, and public URLs."
-    />
-    <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" />
-    <script src="env.js"></script>
-  </head>
-  <body>
-    <div class="backdrop"></div>
-    <header class="site-header">
-      <div class="container nav">
-        <div class="brand">
-          <span class="logo">Mags</span>
-          <span class="tag">Claude Code skill</span>
-        </div>
-        <nav class="nav-links">
-          <a href="index.html">Home</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">
-          <a class="button ghost" href="#install">Install skill</a>
-        </div>
-      </div>
-    </header>
-    <main>
-      <section class="hero">
-        <div class="container hero-grid">
-          <div class="hero-copy">
-            <span class="pill">Claude Code</span>
-            <h1>Run code in clean microVMs directly from Claude.</h1>
-            <p class="lead">
-              Install the Mags skill to give Claude Code the ability to execute scripts
-              in isolated microVMs. Keep workspaces between runs and use SSH or public
-              URLs when you need them.
-            </p>
-            <div class="hero-actions">
-              <a class="button" href="#install">Install skill</a>
-              <a class="button ghost" href="#examples">See examples</a>
-            </div>
-            <div class="hero-meta">
-              <span>Isolated environments for repeatable runs.</span>
-              <span>Workspaces persist files and packages between sessions.</span>
-            </div>
-          </div>
-          <div class="hero-card">
-            <div class="card-header">
-              <span>Example prompt</span>
-              <span class="chip">Claude</span>
-            </div>
-            <pre><code>/mags create a python environment
-with numpy and pandas, then run
-a script that generates sample data</code></pre>
-            <p class="card-note">Claude handles the API calls and shows you the results.</p>
-          </div>
-        </div>
-      </section>
-      <section class="section" id="install">
-        <div class="container">
-          <div class="section-title">
-            <p>Installation</p>
-            <h2>Add the Mags skill to Claude Code.</h2>
-          </div>
-          <div class="grid cards">
-            <article class="card" data-reveal>
-              <h3>1. Install the CLI</h3>
-              <pre><code>npm install -g @magpiecloud/mags</code></pre>
-            </article>
-            <article class="card" data-reveal>
-              <h3>2. Install the Claude skill</h3>
-              <pre><code>mags setup-claude</code></pre>
-              <p>Installs the skill to <code>~/.claude/commands/</code></p>
-            </article>
-            <article class="card" data-reveal>
-              <h3>3. Login to Magpie</h3>
-              <pre><code>mags login</code></pre>
-              <p>Opens your browser to create an API token.</p>
-            </article>
-          </div>
-          <div class="callout" style="margin-top: 1.6rem;">
-            <p>That's it! You can now use <code>/mags</code> in Claude Code.</p>
-          </div>
-        </div>
-      </section>
-      <section class="section">
-        <div class="container">
-          <div class="section-title">
-            <p>Features</p>
-            <h2>What the Mags skill can do.</h2>
-          </div>
-          <div class="grid cards">
-            <article class="card" data-reveal>
-              <h3>Fast execution</h3>
-              <p>Runs start in clean microVMs backed by a warm pool.</p>
-            </article>
-            <article class="card" data-reveal>
-              <h3>Persistent workspaces</h3>
-              <p>Files in <code>/root</code> persist across sessions so you can reuse packages and configs.</p>
-            </article>
-            <article class="card" data-reveal>
-              <h3>SSH access</h3>
-              <p>Get a full shell via SSH proxy. Debug interactively, explore the filesystem, run commands manually.</p>
-            </article>
-            <article class="card" data-reveal>
-              <h3>Public URLs</h3>
-              <p>Expose any port with a public URL. Perfect for testing webhooks, APIs, and web apps.</p>
-            </article>
-            <article class="card" data-reveal>
-              <h3>Full isolation</h3>
-              <p>Each run is isolated in its own microVM environment.</p>
-            </article>
-            <article class="card" data-reveal>
-              <h3>Auto sleep/wake</h3>
-              <p>Persistent VMs can sleep when idle and wake on request.</p>
-            </article>
-            <article class="card" data-reveal>
-              <h3>File upload</h3>
-              <p>Upload local files into the VM with <code>-f</code>. They appear in <code>/root/</code> before your script runs.</p>
-            </article>
-            <article class="card" data-reveal>
-              <h3>Ephemeral mode</h3>
-              <p>Use <code>-e</code> for the fastest runs — no workspace mount or S3 sync overhead.</p>
-            </article>
-            <article class="card" data-reveal>
-              <h3>Cron scheduling</h3>
-              <p>Schedule recurring jobs with standard cron expressions. Managed via <code>mags cron</code>.</p>
-            </article>
-          </div>
-        </div>
-      </section>
-      <section class="section" id="examples">
-        <div class="container">
-          <div class="section-title">
-            <p>Examples</p>
-            <h2>What you can ask Claude to do.</h2>
-          </div>
-          <div class="grid split">
-            <article class="panel" data-reveal>
-              <h3>Run a simple script</h3>
-              <pre><code>/mags echo Hello World</code></pre>
-              <p>Claude submits the job, polls for completion, and shows the output.</p>
-            </article>
-            <article class="panel" data-reveal>
-              <h3>Install packages and run code</h3>
-              <pre><code>/mags install python with requests
-and fetch https://api.github.com</code></pre>
-              <p>Claude installs the package and runs the script in one job.</p>
-            </article>
-          </div>
-          <div class="grid split">
-            <article class="panel" data-reveal>
-              <h3>Create a dev environment</h3>
-              <pre><code>/mags create a node.js environment
-with express and jest installed</code></pre>
-              <p>Claude uses a workspace so packages persist between runs.</p>
-            </article>
-            <article class="panel" data-reveal>
-              <h3>Deploy a web server</h3>
-              <pre><code>/mags run a flask server that
-returns JSON on port 5000 and
-give me the public URL</code></pre>
-              <p>Claude creates a persistent VM, runs the server, and enables URL access.</p>
-            </article>
-          </div>
-          <div class="grid split">
-            <article class="panel" data-reveal>
-              <h3>Get SSH access</h3>
-              <pre><code>/mags create a VM I can SSH into
-with python and vim installed</code></pre>
-              <p>Claude creates the VM, enables SSH, and gives you the connection command.</p>
-            </article>
-            <article class="panel" data-reveal>
-              <h3>Run tests in isolation</h3>
-              <pre><code>/mags run the pytest tests from
-this project in a clean environment</code></pre>
-              <p>Claude copies the relevant files and runs tests in an isolated VM.</p>
-            </article>
-          </div>
-          <div class="grid split">
-            <article class="panel" data-reveal>
-              <h3>Build and compile code</h3>
-              <pre><code>/mags compile this Go program
-and show me the output</code></pre>
-              <p>Claude installs Go, compiles the code, and runs the binary.</p>
-            </article>
-            <article class="panel" data-reveal>
-              <h3>Process data files</h3>
-              <pre><code>/mags use pandas to analyze
-this CSV and show summary stats</code></pre>
-              <p>Claude creates a Python environment, loads the data, and runs the analysis.</p>
-            </article>
-          </div>
-          <div class="grid split">
-            <article class="panel" data-reveal>
-              <h3>Upload files and run</h3>
-              <pre><code>/mags upload my script.py and data.csv
-and run the analysis</code></pre>
-              <p>Claude uploads files with <code>-f</code>, they land in <code>/root/</code> before the script runs.</p>
-            </article>
-            <article class="panel" data-reveal>
-              <h3>Schedule a cron job</h3>
-              <pre><code>/mags schedule a daily backup at midnight
-that archives /root/data to S3</code></pre>
-              <p>Claude creates a cron job with <code>mags cron add</code> and the right schedule.</p>
-            </article>
-          </div>
-        </div>
-      </section>
-      <section class="section">
-        <div class="container">
-          <div class="section-title">
-            <p>Advanced examples</p>
-            <h2>More complex workflows.</h2>
-          </div>
-          <article class="card wide" data-reveal>
-            <h3>Multi-step development workflow</h3>
-            <pre><code># Step 1: Create a workspace with dependencies
-/mags create workspace "my-api" with python, flask, and sqlalchemy
-# Step 2: Add your application code
-/mags in workspace "my-api" create a REST API with user CRUD endpoints
-# Step 3: Run with a public URL
-/mags run the API in "my-api" on port 5000 and give me the URL
-# Step 4: SSH in to debug
-/mags give me SSH access to "my-api" so I can check the logs</code></pre>
-            <p class="card-note">Each step builds on the previous one. Files persist in the workspace.</p>
-          </article>
-          <article class="card wide" data-reveal>
-            <h3>Test a webhook endpoint</h3>
-            <pre><code>/mags create a server that:
-- Listens on port 8080
-- Logs all incoming POST requests to /webhook
-- Returns {"status": "received"}
-- Give me the public URL so I can test with Stripe</code></pre>
-            <p class="card-note">Great for testing webhooks from Stripe, GitHub, Slack, etc.</p>
-          </article>
-          <article class="card wide" data-reveal>
-            <h3>Prototype with multiple languages</h3>
-            <pre><code>/mags create a workspace called "polyglot" with:
-- Python 3 with numpy
-- Node.js with axios
-- Go compiler
-Then show me how to call a Python function from Node</code></pre>
-            <p class="card-note">Install multiple runtimes in one workspace for polyglot development.</p>
-          </article>
-          <article class="card wide" data-reveal>
-            <h3>Complex project: create files, upload, run</h3>
-            <pre><code># Step 1: Create your project files locally
-/mags create an Express API server with two routes:
-  GET /health and POST /data
-Save it as server.js
-# Step 2: Upload files and install dependencies in a workspace
-/mags upload server.js to workspace "my-api" and run npm init + npm install express
-# Step 3: Start the server with a public URL
-/mags in workspace "my-api" run node server.js on port 3000 with a URL</code></pre>
-            <p class="card-note">For complex projects, create the files first, then upload with <code>-f</code> and run in a workspace. Files land in <code>/root/</code>.</p>
-          </article>
-          <article class="card wide" data-reveal>
-            <h3>Cron-based monitoring</h3>
-            <pre><code>/mags create a cron job called "uptime-check" that runs every 5 minutes
-and curls https://myapp.com/health — if it fails, write to a log file
-Use workspace "monitors" so the log persists</code></pre>
-            <p class="card-note">Cron jobs run on a schedule in persistent workspaces. Manage with <code>mags cron list</code>.</p>
-          </article>
-        </div>
-      </section>
-      <section class="section">
-        <div class="container">
-          <div class="section-title">
-            <p>How it works</p>
-            <h2>What happens behind the scenes.</h2>
-          </div>
-          <div class="grid cards">
-            <article class="card" data-reveal>
-              <h3>1. Claude parses your request</h3>
-              <p>The skill instructs Claude how to translate your natural language into Mags API calls.</p>
-            </article>
-            <article class="card" data-reveal>
-              <h3>2. Job is submitted</h3>
-              <p>Claude POSTs to the Mags API with your script, workspace ID, and options.</p>
-            </article>
-            <article class="card" data-reveal>
-              <h3>3. VM boots</h3>
-              <p>A microVM is allocated from the warm pool to run your script.</p>
-            </article>
-            <article class="card" data-reveal>
-              <h3>4. Script executes</h3>
-              <p>Your code runs in Alpine Linux. The <code>/root</code> directory syncs to S3.</p>
-            </article>
-            <article class="card" data-reveal>
-              <h3>5. Claude polls for results</h3>
-              <p>The skill checks job status until completion, then fetches logs.</p>
-            </article>
-            <article class="card" data-reveal>
-              <h3>6. Output is displayed</h3>
-              <p>Claude shows you the script output, any errors, and access URLs if enabled.</p>
-            </article>
-          </div>
-        </div>
-      </section>
-      <section class="section">
-        <div class="container">
-          <div class="section-title">
-            <p>VM Environment</p>
-            <h2>What's available inside the VM.</h2>
-          </div>
-          <div class="grid split">
-            <article class="panel" data-reveal>
-              <h3>System details</h3>
-              <ul class="list">
-                <li><code>Alpine Linux</code><span class="desc">Lightweight base image</span></li>
-                <li><code>mags-vm</code><span class="desc">Hostname</span></li>
-                <li><code>/root</code><span class="desc">Persistent home directory</span></li>
-                <li><code>/jfs</code><span class="desc">Direct JuiceFS mount</span></li>
-                <li><code>apk</code><span class="desc">Package manager</span></li>
-              </ul>
-            </article>
-            <article class="panel" data-reveal>
-              <h3>Pre-installed tools</h3>
-              <ul class="list">
-                <li><code>curl, wget</code><span class="desc">HTTP clients</span></li>
-                <li><code>git</code><span class="desc">Version control</span></li>
-                <li><code>python3</code><span class="desc">Python interpreter</span></li>
-                <li><code>node</code><span class="desc">JavaScript runtime</span></li>
-                <li><code>vim, nano</code><span class="desc">Text editors</span></li>
-              </ul>
-            </article>
-          </div>
-          <div class="callout" style="margin-top: 1.6rem;">
-            <p><strong>Tip:</strong> Install additional packages with <code>apk add &lt;package&gt;</code>. In a workspace, packages persist between runs.</p>
-          </div>
-        </div>
-      </section>
-      <section class="section">
-        <div class="container">
-          <div class="section-title">
-            <p>Complex projects</p>
-            <h2>Create files first, upload, then run.</h2>
-          </div>
-          <p style="color: var(--text-muted); margin-bottom: 1.6rem; max-width: 640px;">
-            For multi-file projects, the best workflow is: create the files locally, upload them with <code>-f</code> into a workspace, then run. This keeps your project organized and lets you iterate.
-          </p>
-          <div class="grid cards">
-            <article class="card" data-reveal>
-              <h3>1. Create files locally</h3>
-              <p>Write your scripts, configs, and data files on your machine first. Claude can help generate them.</p>
-              <pre><code># Claude writes server.js, package.json, etc.
-# to your local project directory</code></pre>
-            </article>
-            <article class="card" data-reveal>
-              <h3>2. Upload and install deps</h3>
-              <p>Upload files with <code>-f</code> and install dependencies in a persistent workspace.</p>
-              <pre><code>mags run -w my-project \
-  -f server.js -f package.json \
-  'cp *.js *.json /root/ && \
-   cd /root && npm install'</code></pre>
-            </article>
-            <article class="card" data-reveal>
-              <h3>3. Run the project</h3>
-              <p>Execute in the same workspace. All your files and packages are still there.</p>
-              <pre><code>mags run -w my-project -p --url \
-  --port 3000 'cd /root && node server.js'</code></pre>
-            </article>
-          </div>
-          <div class="callout" style="margin-top: 1.6rem;">
-            <p><strong>Pattern:</strong> Create locally → upload with <code>-f</code> → install in workspace → run. Use <code>mags cron add</code> to schedule recurring runs.</p>
-          </div>
-        </div>
-      </section>
-      <section class="section">
-        <div class="container">
-          <div class="section-title">
-            <p>Tips</p>
-            <h2>Get the most out of the skill.</h2>
-          </div>
-          <div class="grid cards">
-            <article class="card" data-reveal>
-              <h3>Use workspaces for projects</h3>
-              <p>Ask Claude to use a workspace name so your files and packages persist. "Create workspace my-app with..."</p>
-            </article>
-            <article class="card" data-reveal>
-              <h3>Be specific about ports</h3>
-              <p>When running servers, tell Claude which port to use and whether you need a public URL.</p>
-            </article>
-            <article class="card" data-reveal>
-              <h3>Request SSH for debugging</h3>
-              <p>If something isn't working, ask for SSH access to investigate interactively.</p>
-            </article>
-            <article class="card" data-reveal>
-              <h3>Check logs on errors</h3>
-              <p>If a job fails, ask Claude to show you the full logs to understand what went wrong.</p>
-            </article>
-          </div>
-        </div>
-      </section>
-      <section class="section">
-        <div class="container">
-          <div class="section-title">
-            <p>Reference</p>
-            <h2>Skill configuration options.</h2>
-          </div>
-          <div class="grid split">
-            <article class="panel" data-reveal>
-              <h3>Environment variables</h3>
-              <ul class="list">
-                <li><code>MAGS_API_TOKEN</code><span class="desc">Your API token (required)</span></li>
-                <li><code>MAGS_API_URL</code><span class="desc">API endpoint (optional)</span></li>
-              </ul>
-              <p style="margin-top: 1rem; color: var(--text-muted);">Default API URL: <code>https://api.magpiecloud.com</code></p>
-            </article>
-            <article class="panel" data-reveal>
-              <h3>Token storage</h3>
-              <ul class="list">
-                <li><code>~/.mags/config.json</code><span class="desc">CLI config file</span></li>
-                <li><code>.env.sh</code><span class="desc">Project env file</span></li>
-                <li><code>Environment variable</code><span class="desc">Shell export</span></li>
-              </ul>
-            </article>
-          </div>
-        </div>
-      </section>
-    </main>
-    <footer class="site-footer">
-      <div class="container footer-grid">
-        <div>
-          <div class="brand">
-            <span class="logo">Mags</span>
-            <span class="tag">Instant sandboxes and runtime environments</span>
-          </div>
-          <p>Build, test, and run code in isolated microVMs from Claude Code.</p>
-        </div>
-        <div class="footer-links">
-          <a href="index.html">Home</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>
-        </div>
-      </div>
-    </footer>
-    <script src="script.js?v=7"></script>
-  </body>
-</html>