pinokiod 3.311.0 → 3.313.0

package/kernel/api/index.js

@@ -795,6 +795,9 @@ class Api {
     let port = await this.kernel.port()
 
     let { cwd, script } = await this.resolveScript(request.path)
+    const actionKey = request.action || 'run'
+    const steps = (script && Array.isArray(script[actionKey])) ? script[actionKey] : []
+    const totalSteps = steps.length
 
     let name = path.relative(this.kernel.path("api"), cwd)
 
@@ -827,7 +830,7 @@ class Api {
       ...this.kernel.vars,
     }
 
-    if (i < script.run.length-1) {
+    if (i < totalSteps - 1) {
       memory.next = i+1
     } else {
       memory.next = null
@@ -911,7 +914,7 @@ class Api {
 
         rpc.current = i
 
-        rpc.total = script.run.length
+        rpc.total = totalSteps
 
         rpc.input = input
 
@@ -926,7 +929,7 @@ class Api {
         if (rpc.hasOwnProperty("next")) {
           console.log("next already exists, don't touch", rpc.next)
           if (typeof rpc.next === "string") {
-            let run = script.run
+            let run = steps
             console.log("run", run)
             for(let i=0; i<run.length; i++) {
               let step = run[i]
@@ -937,7 +940,7 @@ class Api {
             }
           }
         } else {
-          if (i < script.run.length-1) {
+          if (i < totalSteps-1) {
             rpc.next = i+1
           } else {
             rpc.next = null
@@ -961,7 +964,7 @@ class Api {
 
           if (!should_run) {
             // the current step is skipped, therefore the next value should be ignored as well
-            if (i < script.run.length-1) {
+            if (i < totalSteps-1) {
               rpc.next = i+1
             } else {
               rpc.next = null
@@ -1007,12 +1010,12 @@ class Api {
                   })
                 }
               }
-              return { request, input: null, step: rpc.next, total: script.run.length, args }
+              return { request, input: null, step: rpc.next, total: totalSteps, args }
             } else {
               // still ongoing
-              let next_rpc = script.run[rpc.next]
+              let next_rpc = steps[rpc.next]
               if (next_rpc) {
-                return { request, rawrpc: next_rpc, input: null, step: rpc.next, total: script.run.length, args }
+                return { request, rawrpc: next_rpc, input: null, step: rpc.next, total: totalSteps, args }
               }
             }
           }
@@ -1213,7 +1216,7 @@ class Api {
                   description: "All scripts finished running. Running in daemon mode..."
                 }
               })
-              return { request, input: result, step: rpc.next, total: script.run.length, args }
+              return { request, input: result, step: rpc.next, total: totalSteps, args }
             } else {
               // no next rpc to execute. Finish
               this.kernel.memory.local[id] = {}
@@ -1237,13 +1240,13 @@ class Api {
                   }
                 })
               }
-              return { request, input: result, step: rpc.next, total: script.run.length, args }
+              return { request, input: result, step: rpc.next, total: totalSteps, args }
             }
 
           } else {
             // still going
-            let next_rpc = script.run[rpc.next]
-            return { request, rawrpc: next_rpc, input: result, step: rpc.next, total: script.run.length, args }
+            let next_rpc = steps[rpc.next]
+            return { request, rawrpc: next_rpc, input: result, step: rpc.next, total: totalSteps, args }
           }
 
         } catch (e) {
@@ -1491,9 +1494,12 @@ class Api {
             data: "the endpoint does not exist: " + request.uri,
           })
         } else {
-          // 3. Check if the resolved endpoint has the "run" attribute and it's an array
-          //if (script.run && Array.isArray(script.run)) {
-          if (script.run) {
+          const actionKey = request.action || 'run'
+          request.action = actionKey
+          const steps = script ? script[actionKey] : null
+
+          // 3. Check if the resolved endpoint has the requested action attribute and it's an array
+          if (Array.isArray(steps) && steps.length > 0) {
 
             if (request.id) {
               this.running[request.id] = true
@@ -1514,14 +1520,13 @@ class Api {
             }
 
 
-
-            this.queue(request, script.run[0], request.input, 0, script.run.length, cwd, request.input)
+            this.queue(request, steps[0], request.input, 0, steps.length, cwd, request.input)
 
           } else {
             this.ondata({
               id: request.id || request.path,
               type: "error",
-              data: "missing attribute: run"
+              data: `missing or invalid attribute: ${actionKey}`
             })
           }
         }

package/kernel/index.js

@@ -56,7 +56,7 @@ const VARS = {
 
 //const memwatch = require('@airbnb/node-memwatch');
 class Kernel {
-  schema = "<=4.0.0"
+  schema = "<=5.0.0"
   constructor(store) {
     this.fetch = fetch
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "pinokiod",
-  "version": "3.311.0",
+  "version": "3.313.0",
   "description": "",
   "main": "index.js",
   "scripts": {

package/server/index.js

@@ -1650,10 +1650,6 @@ class Server {
       }
       let configArray = [{
         key: "home",
-        description: [
-          "* NO white spaces (' ')",
-          "* NO exFAT drives",
-        ],
         val: this.kernel.homedir,
         placeholder: "Enter the absolute path to use as your Pinokio home folder (D:\\pinokio, /Users/alice/pinokiofs, etc.)"
 //      }, {
@@ -1834,6 +1830,7 @@ class Server {
           schemaPath = ""
         }
 
+        const actionKey = req.action || 'run'
         let runnable
         let resolved
         if (typeof runner === "function") {
@@ -1842,9 +1839,9 @@ class Server {
           } else {
             resolved = runner(this.kernel, this.kernel.info)
           }
-          runnable = resolved && resolved.run ? true : false
+          runnable = resolved && Array.isArray(resolved[actionKey]) && resolved[actionKey].length > 0
         } else {
-          runnable = runner && runner.run ? true : false
+          runnable = runner && Array.isArray(runner[actionKey]) && runner[actionKey].length > 0
           resolved = runner
         }
 
@@ -1965,6 +1962,7 @@ class Server {
             run: (req.query && req.query.mode === "source" ? false : true),
             stop: (req.query && req.query.stop ? true : false),
             pinokioPath,
+            action: actionKey,
             runnable,
             agent: req.agent,
             rawpath,
@@ -3579,65 +3577,7 @@ class Server {
         }
         logHomeCheck({ step: 'resolved', resolvedHome, ancestor })
 
-        const mounts = await system.fsSize().catch(() => [])
-        const blockDeviceMounts = []
-        const mountTypeLookup = new Map()
-        try {
-          // fsSize() on some platforms can obscure the actual fs type; pull blockDevices for more accurate mount FS info (e.g. exFAT on macOS/Windows)
-          const blockDevices = await system.blockDevices()
-          for (const device of blockDevices || []) {
-            const mountPath = normalizeMountPath(device.mount)
-            if (!mountPath) continue
-            const fsType = (device.fsType || device.type || '').toLowerCase()
-            blockDeviceMounts.push({ mount: mountPath, type: fsType })
-            if (fsType) {
-              mountTypeLookup.set(mountPath.toLowerCase(), fsType)
-            }
-          }
-        } catch (_) {
-          // ignore - fallback to fsSize data only
-        }
-        logHomeCheck({ step: 'mountSources', fsSizeCount: mounts.length, blockDevicesCount: blockDeviceMounts.length })
-
-        const normalizedAncestor = normalizeMountPath(ancestor)
-        const isParentMount = (mountPath) => {
-          if (!mountPath || !normalizedAncestor) return false
-          if (mountPath === "/") return normalizedAncestor.startsWith("/")
-          return normalizedAncestor === mountPath || normalizedAncestor.startsWith(mountPath + "/")
-        }
-        const isExfat = (fsType) => {
-          const normalized = (fsType || '').toLowerCase().replace(/[^a-z0-9]/g, '')
-          return normalized.includes('exfat')
-        }
-        let bestMount = null
-        for (const volume of mounts) {
-          const mountPath = normalizeMountPath(volume.mount)
-          if (!isParentMount(mountPath)) continue
-          const blockType = mountTypeLookup.get((mountPath || '').toLowerCase())
-          const detectedType = (blockType || volume.type || '').toLowerCase()
-          if (!bestMount || mountPath.length > bestMount.mount.length) {
-            bestMount = { mount: mountPath, type: detectedType }
-            logHomeCheck({ step: 'candidate', source: 'fsSize', mount: mountPath, type: detectedType })
-          }
-        }
-
-        if (!bestMount) {
-          for (const deviceMount of blockDeviceMounts) {
-            if (!isParentMount(deviceMount.mount)) continue
-            if (!bestMount || deviceMount.mount.length > bestMount.mount.length) {
-              bestMount = { ...deviceMount }
-              logHomeCheck({ step: 'candidate', source: 'blockDevices', mount: deviceMount.mount, type: deviceMount.type })
-            }
-          }
-        }
-
-        logHomeCheck({ step: 'bestMount', bestMount })
-
-        if (bestMount && bestMount.type && isExfat(bestMount.type)) {
-          logHomeCheck({ step: 'reject', reason: 'exfat', bestMount })
-          throw new Error("Pinokio home cannot be located on an exFAT drive. Please choose a different location.")
-        }
-        logHomeCheck({ step: 'accept', bestMount })
+        logHomeCheck({ step: 'accept' })
 
 //        // check if the destination already exists => throw error
 //        let exists = await fse.pathExists(config.home)
@@ -4559,16 +4499,20 @@ class Server {
       })
     }))
     this.app.get("/agents", ex(async (req, res) => {
-      if (!this.kernel.plugin.config) {
-        try {
+      let pluginMenu = []
+      try {
+        if (!this.kernel.plugin.config) {
           await this.kernel.plugin.init()
-        } catch (err) {
-          console.warn('Failed to initialize plugins', err)
+        } else {
+          // Refresh the plugin list so newly downloaded plugins show up immediately
+          await this.kernel.plugin.setConfig()
         }
+        if (this.kernel.plugin && this.kernel.plugin.config && Array.isArray(this.kernel.plugin.config.menu)) {
+          pluginMenu = this.kernel.plugin.config.menu
+        }
+      } catch (err) {
+        console.warn('Failed to initialize plugins', err)
       }
-      const pluginMenu = this.kernel.plugin && this.kernel.plugin.config && Array.isArray(this.kernel.plugin.config.menu)
-        ? this.kernel.plugin.config.menu
-        : []
 
       const apps = []
       try {
@@ -5170,12 +5114,9 @@ class Server {
         if (this.kernel.homedir) {
           system_env = await Environment.get(this.kernel.homedir, this.kernel)
         }
+        const hasHome = !!this.kernel.homedir
         let configArray = [{
           key: "home",
-          description: [
-            "* NO white spaces (' ')",
-            "* NO exFAT drives",
-          ],
           val: this.kernel.homedir ? this.kernel.homedir : _home,
           placeholder: "Enter the absolute path to use as your Pinokio home folder (D\\pinokio, /Users/alice/pinokiofs, etc.)"
 //        }, {
@@ -7676,6 +7617,17 @@ class Server {
         res.status(404).send(e.message)
       }
     }))
+    this.app.get("/action/:action/*", ex(async (req, res) => {
+      const action = typeof req.params.action === 'string' ? req.params.action : ''
+      const pathComponents = req.params[0] ? req.params[0].split("/") : []
+      req.base = this.kernel.homedir
+      req.action = action
+      try {
+        await this.render(req, res, pathComponents)
+      } catch (e) {
+        res.status(404).send(e.message)
+      }
+    }))
     this.app.get("/run/*", ex(async (req, res) => {
       let pathComponents = req.params[0].split("/")
       req.base = this.kernel.homedir

package/server/public/create-launcher.js

@@ -59,26 +59,30 @@
         const href = typeof plugin.href === 'string' ? plugin.href.trim() : '';
         const label = plugin.title || plugin.text || plugin.name || href || '';
 
-        let slug = '';
+        let value = '';
         if (href) {
-          const segments = href.split('/').filter(Boolean);
-          if (segments.length >= 2) {
-            slug = segments[segments.length - 2] || '';
+          // Normalize href to a plugin-relative path for the backend (e.g., code/codex)
+          const normalized = href.replace(/^\/run/, '').replace(/^\/+/, '');
+          const parts = normalized.split('/').filter(Boolean);
+          // Expect /plugin/<path...>/pinokio.js -> want <path...>
+          if (parts[0] === 'plugin' && parts.length >= 3) {
+            value = parts.slice(1, -1).join('/');
+          } else {
+            value = normalized;
           }
-          if (!slug && segments.length) {
-            slug = segments[segments.length - 1] || '';
-          }
-          if (slug.endsWith('.js')) {
-            slug = slug.replace(/\.js$/i, '');
+          if (value.endsWith('/pinokio.js')) {
+            value = value.replace(/\/pinokio\.js$/i, '');
           }
         }
-        if (!slug && label) {
-          slug = label
+        if (!value && label) {
+          value = label
             .toLowerCase()
-            .replace(/[^a-z0-9]+/g, '-')
+            .replace(/[^a-z0-9/]+/g, '-')
             .replace(/^-+|-+$/g, '');
         }
-        const value = slug || href || (typeof plugin.link === 'string' ? plugin.link.trim() : '');
+        if (!value && typeof plugin.link === 'string') {
+          value = plugin.link.trim();
+        }
         if (!value) {
           return null;
         }
@@ -620,17 +624,6 @@
     return ui && ui.templateManager ? ui.templateManager.getTemplateValues() : new Map();
   }
 
-  function getSelectedTool(ui) {
-    if (!ui || !Array.isArray(ui.toolEntries)) {
-      return '';
-    }
-    const checked = ui.toolEntries.find((entry) => entry.input.checked);
-    if (checked && checked.input && checked.input.value) {
-      return checked.input.value;
-    }
-    return ui.toolEntries.length > 0 ? (ui.toolEntries[0].input.value || '') : '';
-  }
-
   async function submitFromUi(ui) {
     if (!ui) return;
     ui.error.textContent = '';
@@ -641,9 +634,13 @@
     const targetProject = isAskVariant ? (ui.projectName || folderName) : folderName;
     const rawPrompt = ui.promptTextarea.value;
     const templateValues = readTemplateValues(ui);
-    const selectedTool = getSelectedTool(ui);
+    const selectedEntry = ui && Array.isArray(ui.toolEntries)
+      ? (ui.toolEntries.find((entry) => entry.input.checked) || ui.toolEntries[0])
+      : null
+    const selectedTool = selectedEntry && selectedEntry.input ? selectedEntry.input.value : ''
+    const selectedHref = selectedEntry && selectedEntry.input ? selectedEntry.input.dataset.agentHref : ''
 
-    if (!selectedTool) {
+    if (!selectedEntry || !selectedHref) {
       ui.error.textContent = 'Please select an agent.';
       return;
     }
@@ -689,7 +686,8 @@
 
     if (isAskVariant) {
       const params = new URLSearchParams();
-      params.set('plugin', `/plugin/code/${selectedTool}/pinokio.js`);
+      const pluginPath = selectedHref.replace(/^\/run/, '')
+      params.set('plugin', pluginPath);
       if (prompt) {
         params.set('prompt', prompt);
       }

package/server/public/install.js

@@ -146,7 +146,8 @@ const install = async (name, url, term, socket, options) => {
         text: `Downloaded to ~/${normalizedPath}/${name}`,
         timeout: 4000
       })
-      location.href = "/agents"
+      const relativePluginPath = `${normalizedPath}/${name}`
+      location.href = `/agents?path=${encodeURIComponent(relativePluginPath)}`
     }
   }
 }

package/server/views/agents.ejs

@@ -102,31 +102,28 @@ body.plugin-page .btn-tab .btn {
 }
 .plugin-card {
   display: flex;
-  align-items: center;
+  flex-direction: column;
+  align-items: stretch;
   gap: 12px;
   padding: 12px;
   border-radius: 10px;
   background: rgba(0, 0, 0, 0.03);
-  cursor: pointer;
-  transition: background 0.15s ease, transform 0.15s ease;
+  cursor: default;
+  transition: background 0.15s ease;
   text-decoration: none;
   color: inherit;
   min-height: 68px;
 }
 .plugin-card:hover,
-.plugin-card:focus-visible {
+.plugin-card:focus-within {
   background: rgba(0, 0, 0, 0.08);
 }
-.plugin-card:focus-visible {
-  outline: 2px solid rgba(127, 91, 243, 0.6);
-  outline-offset: 2px;
-}
 body.dark .plugin-card {
   background: rgba(255, 255, 255, 0.05);
   color: white;
 }
 body.dark .plugin-card:hover,
-body.dark .plugin-card:focus-visible {
+body.dark .plugin-card:focus-within {
   background: rgba(255, 255, 255, 0.12);
 }
 .plugin-card img,
@@ -156,6 +153,16 @@ body.dark .plugin-card .plugin-icon {
   display: flex;
   flex-direction: column;
   gap: 4px;
+  flex: 1;
+}
+.plugin-card .plugin-top {
+  display: flex;
+  align-items: center;
+  gap: 12px;
+}
+.plugin-card .plugin-footer {
+  display: flex;
+  justify-content: flex-end;
 }
 .plugin-card h2 {
   margin: 0;
@@ -191,6 +198,171 @@ body.dark .plugin-card .plugin-info:focus-visible {
   background: rgba(255, 255, 255, 0.18);
   color: rgba(255, 255, 255, 0.95);
 }
+.plugin-card .plugin-actions {
+  margin-left: auto;
+  display: flex;
+  flex-wrap: wrap;
+  gap: 8px;
+  justify-content: flex-end;
+}
+.plugin-card .plugin-action-button {
+  padding: 8px 12px;
+  border-radius: 8px;
+  border: 1px solid rgba(0, 0, 0, 0.08);
+  background: white;
+  color: rgba(0, 0, 0, 0.8);
+  cursor: pointer;
+  font-weight: 600;
+  transition: background 0.15s ease, color 0.15s ease, border-color 0.15s ease, transform 0.1s ease;
+}
+body.dark .plugin-card .plugin-action-button {
+  background: rgba(255, 255, 255, 0.08);
+  border-color: rgba(255, 255, 255, 0.16);
+  color: white;
+}
+.plugin-card .plugin-action-button:hover,
+.plugin-card .plugin-action-button:focus-visible {
+  background: rgba(127, 91, 243, 0.12);
+  border-color: rgba(127, 91, 243, 0.45);
+  color: rgba(0, 0, 0, 0.9);
+  outline: none;
+}
+body.dark .plugin-card .plugin-action-button:hover,
+body.dark .plugin-card .plugin-action-button:focus-visible {
+  color: white;
+  background: rgba(127, 91, 243, 0.25);
+  border-color: rgba(127, 91, 243, 0.65);
+}
+.plugin-card .plugin-action-button:active {
+  transform: translateY(1px);
+}
+:root {
+  --pinokio-modal-bg: #ffffff;
+  --pinokio-modal-text: #0f172a;
+  --pinokio-modal-icon-bg: linear-gradient(135deg, rgba(59, 130, 246, 0.18), rgba(59, 130, 246, 0.03));
+  --pinokio-modal-icon-color: #2563eb;
+  --pinokio-modal-subtitle: rgba(71, 85, 105, 0.75);
+  --pinokio-modal-body-bg: rgba(241, 245, 249, 0.9);
+}
+body.dark {
+  --pinokio-modal-bg: #0f172a;
+  --pinokio-modal-text: #e2e8f0;
+  --pinokio-modal-icon-bg: linear-gradient(135deg, rgba(59, 130, 246, 0.25), rgba(59, 130, 246, 0.05));
+  --pinokio-modal-icon-color: #60a5fa;
+  --pinokio-modal-subtitle: rgba(148, 163, 184, 0.85);
+  --pinokio-modal-body-bg: rgba(15, 23, 42, 0.6);
+}
+.pinokio-modern-modal.swal2-popup {
+  padding: 0 !important;
+  border-radius: 20px !important;
+  background: var(--pinokio-modal-bg) !important;
+  box-shadow: 0 32px 80px rgba(15, 23, 42, 0.25);
+}
+body.dark .pinokio-modern-modal.swal2-popup {
+  box-shadow: 0 40px 120px rgba(2, 8, 23, 0.7);
+}
+.pinokio-modern-html {
+  padding: 0 !important;
+}
+.pinokio-modern-close {
+  color: rgba(71, 85, 105, 0.65) !important;
+  top: 12px !important;
+  right: 12px !important;
+}
+body.dark .pinokio-modern-close {
+  color: rgba(226, 232, 240, 0.6) !important;
+}
+.pinokio-modern-close:hover {
+  background: rgba(148, 163, 184, 0.18) !important;
+  color: #0f172a !important;
+}
+body.dark .pinokio-modern-close:hover {
+  background: rgba(148, 163, 184, 0.12) !important;
+  color: #f8fafc !important;
+}
+.pinokio-modal-surface {
+  background: var(--pinokio-modal-bg);
+  color: var(--pinokio-modal-text);
+  border-radius: 20px;
+  overflow: hidden;
+}
+.pinokio-modal-header {
+  display: flex;
+  align-items: center;
+  gap: 12px;
+  padding: 22px 24px 10px;
+}
+.pinokio-modal-icon {
+  width: 48px;
+  height: 48px;
+  border-radius: 14px;
+  background: var(--pinokio-modal-icon-bg);
+  color: var(--pinokio-modal-icon-color);
+  display: grid;
+  place-items: center;
+  font-size: 22px;
+}
+.pinokio-modal-heading {
+  display: flex;
+  flex-direction: column;
+  gap: 4px;
+}
+.pinokio-modal-title {
+  font-size: 20px;
+  font-weight: 700;
+  color: var(--pinokio-modal-text);
+}
+.pinokio-modal-subtitle {
+  font-size: 13px;
+  color: var(--pinokio-modal-subtitle);
+}
+.pinokio-modal-body {
+  padding: 14px 24px 12px;
+  background: var(--pinokio-modal-body-bg);
+}
+.pinokio-modal-body--iframe {
+  padding: 14px 24px 12px;
+}
+.pinokio-modal-body--iframe iframe {
+  width: 100%;
+  height: 440px;
+  border: none;
+  border-radius: 12px;
+  background: inherit;
+}
+.pinokio-modal-footer {
+  display: flex;
+  justify-content: flex-end;
+  gap: 10px;
+  padding: 0 24px 18px;
+  background: var(--pinokio-modal-bg);
+}
+.pinokio-modal-footer--publish {
+  align-items: center;
+}
+.pinokio-publish-close-btn,
+.pinokio-modal-secondary-btn {
+  border: none;
+  border-radius: 10px;
+  padding: 9px 14px;
+  font-weight: 600;
+  cursor: pointer;
+  background: rgba(0, 0, 0, 0.08);
+  color: var(--pinokio-modal-text);
+}
+body.dark .pinokio-publish-close-btn,
+body.dark .pinokio-modal-secondary-btn {
+  background: rgba(255, 255, 255, 0.12);
+  color: var(--pinokio-modal-text);
+}
+.pinokio-publish-close-btn:hover,
+.pinokio-modal-secondary-btn:hover {
+  background: rgba(127, 91, 243, 0.18);
+}
+body.dark .pinokio-publish-close-btn:hover,
+body.dark .pinokio-modal-secondary-btn:hover {
+  background: rgba(127, 91, 243, 0.25);
+}
 .plugin-card .disclosure-indicator {
   display: flex;
   align-items: center;
@@ -201,7 +373,7 @@ body.dark .plugin-card .plugin-info:focus-visible {
   transition: transform 0.15s ease, color 0.15s ease;
 }
 .plugin-card:hover .disclosure-indicator,
-.plugin-card:focus-visible .disclosure-indicator {
+.plugin-card:focus-within .disclosure-indicator {
   transform: translateX(2px);
   color: rgba(0, 0, 0, 0.65);
 }
@@ -209,7 +381,7 @@ body.dark .plugin-card .disclosure-indicator {
   color: rgba(255, 255, 255, 0.4);
 }
 body.dark .plugin-card:hover .disclosure-indicator,
-body.dark .plugin-card:focus-visible .disclosure-indicator {
+body.dark .plugin-card:focus-within .disclosure-indicator {
   color: rgba(255, 255, 255, 0.85);
 }
 .plugin-empty {
@@ -403,7 +575,8 @@ body.dark .plugin-option:hover {
        image: plugin.image || null,
        icon: plugin.icon || null,
        pluginPath,
-       extraParams
+       extraParams,
+       hasInstall: Array.isArray(plugin.install)
      }
    }) %>
 </head>
@@ -471,19 +644,35 @@ body.dark .plugin-option:hover {
             <% if (items.length) { %>
               <div class='plugin-grid'>
                 <% items.forEach(({ pluginItem, index }) => { %>
-                  <div class='plugin-card' role="button" tabindex="0" data-plugin-index="<%=index%>">
-                    <% if (pluginItem.image) { %>
-                      <img src="<%=pluginItem.image%>" alt="<%=pluginItem.title || pluginItem.text || 'Plugin'%> icon">
-                    <% } else if (pluginItem.icon) { %>
-                      <div class='plugin-icon'><i class="<%=pluginItem.icon%>"></i></div>
-                    <% } else { %>
-                      <div class='plugin-icon'><i class="fa-solid fa-robot"></i></div>
-                    <% } %>
-                    <div class='plugin-details'>
-                      <h2><%=pluginItem.title || pluginItem.text || pluginItem.name || 'Plugin'%></h2>
-                      <% if (pluginItem.description) { %>
-                        <div class='subtitle'><%=pluginItem.description%></div>
+                  <div class='plugin-card' data-plugin-index="<%=index%>">
+                    <div class="plugin-top">
+                      <% if (pluginItem.image) { %>
+                        <img src="<%=pluginItem.image%>" alt="<%=pluginItem.title || pluginItem.text || 'Plugin'%> icon">
+                      <% } else if (pluginItem.icon) { %>
+                        <div class='plugin-icon'><i class="<%=pluginItem.icon%>"></i></div>
+                      <% } else { %>
+                        <div class='plugin-icon'><i class="fa-solid fa-robot"></i></div>
                       <% } %>
+                      <div class='plugin-details'>
+                        <h2><%=pluginItem.title || pluginItem.text || pluginItem.name || 'Plugin'%></h2>
+                        <% if (pluginItem.description) { %>
+                          <div class='subtitle'><%=pluginItem.description%></div>
+                        <% } %>
+                      </div>
+                    </div>
+                    <div class="plugin-footer">
+                      <div class="plugin-actions">
+                        <button type="button" class="plugin-action-button" data-action="open">Open in</button>
+                        <% if (Array.isArray(pluginItem.install)) { %>
+                          <button type="button" class="plugin-action-button" data-plugin-action="install">Install</button>
+                        <% } %>
+                        <% if (Array.isArray(pluginItem.uninstall)) { %>
+                          <button type="button" class="plugin-action-button" data-plugin-action="uninstall">Uninstall</button>
+                        <% } %>
+                        <% if (Array.isArray(pluginItem.update)) { %>
+                          <button type="button" class="plugin-action-button" data-plugin-action="update">Update</button>
+                        <% } %>
+                      </div>
                     </div>
                   </div>
                 <% }) %>
@@ -828,6 +1017,119 @@ body.dark .plugin-option:hover {
 
   const modal = createPluginModal(apps)
 
+  const ACTION_LABELS = {
+    install: 'Install',
+    uninstall: 'Uninstall',
+    update: 'Update'
+  }
+  const ACTION_ICONS = {
+    install: 'fa-solid fa-download',
+    uninstall: 'fa-solid fa-trash-can',
+    update: 'fa-solid fa-rotate-right'
+  }
+
+  function buildActionUrl(plugin, actionType) {
+    if (!plugin || !plugin.pluginPath) return null
+    const normalizedPath = plugin.pluginPath.startsWith('/') ? plugin.pluginPath.slice(1) : plugin.pluginPath
+    if (!normalizedPath) return null
+    const encodedPath = normalizedPath.split('/').map((segment) => encodeURIComponent(segment)).join('/')
+    const ts = Date.now()
+    return `/action/${encodeURIComponent(actionType)}/${encodedPath}?ts=${ts}`
+  }
+
+  function showActionModal(actionType, plugin) {
+    const targetUrl = buildActionUrl(plugin, actionType)
+    if (!targetUrl) {
+      alert('This action is missing a target script.')
+      return
+    }
+    const pluginTitle = plugin && (plugin.title || plugin.text || plugin.name) ? (plugin.title || plugin.text || plugin.name) : 'Plugin'
+    const title = `${ACTION_LABELS[actionType] || 'Run'} ${escapeHtml(pluginTitle)}`
+    const subtitle = plugin && plugin.description ? escapeHtml(plugin.description) : ''
+    const iconClass = ACTION_ICONS[actionType] || 'fa-solid fa-terminal'
+    const modalHtml = `
+      <div class="pinokio-modal-surface">
+        <div class="pinokio-modal-header">
+          <div class="pinokio-modal-icon"><i class="${iconClass}"></i></div>
+          <div class="pinokio-modal-heading">
+            <div class="pinokio-modal-title">${title}</div>
+            <div class="pinokio-modal-subtitle">${subtitle}</div>
+          </div>
+        </div>
+        <div class="pinokio-modal-body pinokio-modal-body--iframe">
+          <iframe src="${targetUrl}"></iframe>
+        </div>
+        <div class="pinokio-modal-footer pinokio-modal-footer--publish" data-publish-footer>
+          <button type="button" class="pinokio-publish-close-btn" data-publish-close>Close</button>
+        </div>
+      </div>
+    `
+
+    Swal.fire({
+      html: modalHtml,
+      customClass: {
+        popup: 'pinokio-modern-modal',
+        htmlContainer: 'pinokio-modern-html',
+        closeButton: 'pinokio-modern-close'
+      },
+      backdrop: 'rgba(9,11,15,0.65)',
+      width: 'min(760px, 90vw)',
+      showConfirmButton: false,
+      showCloseButton: true,
+      buttonsStyling: false,
+      focusConfirm: false,
+      didOpen: (popup) => {
+        const iframe = popup.querySelector('iframe')
+        const closeBtn = popup.querySelector('[data-publish-close]')
+        if (iframe) {
+          iframe.dataset.forceVisible = 'true'
+          iframe.classList.remove('hidden')
+          iframe.removeAttribute('hidden')
+        }
+        if (closeBtn) {
+          closeBtn.addEventListener('click', () => {
+            Swal.close()
+          })
+        }
+      }
+    })
+  }
+
+  function normalizePluginPath(value) {
+    if (typeof value !== 'string') return ''
+    return value.replace(/\\/g, '/').replace(/^\/+/, '').replace(/\/+$/, '')
+  }
+
+  function findPluginByPath(targetPath) {
+    if (!targetPath) return null
+    const normalizedTarget = normalizePluginPath(targetPath)
+    const targetWithFile = normalizedTarget.endsWith('pinokio.js')
+      ? normalizedTarget
+      : `${normalizedTarget}/pinokio.js`
+    return plugins.find((plugin) => {
+      const pluginPath = normalizePluginPath(plugin.pluginPath || '')
+      if (!pluginPath) return false
+      return pluginPath === targetWithFile || pluginPath === `/${targetWithFile}`
+    }) || null
+  }
+
+  function autoActivateFromQuery() {
+    const params = new URLSearchParams(window.location.search)
+    const targetPath = params.get('path')
+    if (!targetPath) {
+      return
+    }
+    const plugin = findPluginByPath(targetPath)
+    if (!plugin) {
+      return
+    }
+    if (plugin.hasInstall) {
+      showActionModal('install', plugin)
+    } else {
+      modal.open(plugin)
+    }
+  }
+
   function attachHandlers() {
     const cards = document.querySelectorAll('.plugin-card')
     if (!cards.length) return
@@ -849,6 +1151,7 @@ body.dark .plugin-option:hover {
           }
         })
       }
+      const openButton = card.querySelector('[data-action="open"]')
       const open = (event) => {
         if (event) {
           event.preventDefault()
@@ -859,11 +1162,17 @@ body.dark .plugin-option:hover {
         }
         modal.open(plugin)
       }
-      card.addEventListener('click', open)
-      card.addEventListener('keydown', (event) => {
-        if (event.key === 'Enter' || event.key === ' ') {
-          open(event)
-        }
+      if (openButton) {
+        openButton.addEventListener('click', open)
+      }
+      const actionButtons = card.querySelectorAll('[data-plugin-action]')
+      actionButtons.forEach((button) => {
+        const actionType = button.getAttribute('data-plugin-action')
+        if (!actionType) return
+        button.addEventListener('click', (event) => {
+          event.preventDefault()
+          showActionModal(actionType, plugin)
+        })
       })
     })
   }
@@ -871,6 +1180,7 @@ body.dark .plugin-option:hover {
   document.addEventListener('DOMContentLoaded', () => {
     initUrlFeatures()
     attachHandlers()
+    autoActivateFromQuery()
   })
 })()
 </script>

package/server/views/settings.ejs

@@ -163,6 +163,78 @@ body.dark .item select {
 .timestamp {
   color: rgba(0,0,0,0.5);
 }
+.home-warning {
+  margin-top: 8px;
+  padding: 10px 12px;
+  border: 1px solid rgba(0,0,0,0.08);
+  border-radius: 6px;
+  font-size: 12px;
+  line-height: 1.4;
+  background: rgba(0,0,0,0.03);
+}
+body.dark .home-warning {
+  border-color: rgba(255,255,255,0.12);
+  background: rgba(255,255,255,0.04);
+  color: rgba(255,255,255,0.8);
+}
+.home-warning ul {
+  margin: 0;
+  padding-left: 18px;
+}
+.swal2-popup.custom-home-modal {
+  border-radius: 10px;
+  padding: 18px 18px 14px 18px;
+  background: #fdfdfd;
+  box-shadow: 0 8px 28px rgba(0,0,0,0.12);
+  text-align: left;
+}
+body.dark .swal2-popup.custom-home-modal {
+  background: #1f1f25;
+  box-shadow: 0 10px 36px rgba(0,0,0,0.45);
+}
+.swal2-popup.custom-home-modal .swal2-title {
+  text-align: left !important;
+  font-size: 16px;
+  font-weight: 700;
+  color: #111;
+  margin: 0 0 6px 0;
+  text-align: left;
+}
+body.dark .swal2-popup.custom-home-modal .swal2-title {
+  color: #f5f5f5;
+}
+.swal2-popup.custom-home-modal .swal2-html-container {
+  font-size: 14px;
+  color: #333;
+  margin: 0 0 10px 0;
+  text-align: left;
+}
+body.dark .swal2-popup.custom-home-modal .swal2-html-container {
+  color: rgba(255,255,255,0.8);
+}
+.swal2-popup.custom-home-modal .swal2-actions {
+  margin-top: 4px;
+  gap: 8px;
+  justify-content: flex-end !important;
+}
+.swal2-popup.custom-home-modal .swal2-styled.swal2-confirm {
+  background: #4a4ae0;
+  color: #fff;
+  border-radius: 6px;
+  padding: 8px 16px;
+  font-weight: 600;
+}
+.swal2-popup.custom-home-modal .swal2-styled.swal2-cancel {
+  background: transparent;
+  color: #555;
+  border: 1px solid rgba(0,0,0,0.15);
+  border-radius: 6px;
+  padding: 8px 16px;
+}
+body.dark .swal2-popup.custom-home-modal .swal2-styled.swal2-cancel {
+  color: rgba(255,255,255,0.8);
+  border-color: rgba(255,255,255,0.2);
+}
 body.dark .loading {
   background: rgba(255,255,255,0.06);
 }
@@ -440,9 +512,9 @@ document.addEventListener('DOMContentLoaded', function() {
           </select>
         <% } else { %>
           <% if (c.val) { %>
-            <input class='homepath' name="<%=c.key%>" type='text' value="<%=c.val%>" placeholder="<%=c.placeholder ? c.placeholder : ''%>">
+            <input class='homepath' name="<%=c.key%>" type='text' value="<%=c.val%>" placeholder="<%=c.placeholder ? c.placeholder : ''%>" <%= c.key === 'home' && !hasHome ? `data-first-home=\"true\"` : "" %>>
           <% } else { %>
-            <input class='homepath' name="<%=c.key%>" type='text' placeholder="<%=c.placeholder ? c.placeholder : ''%>">
+            <input class='homepath' name="<%=c.key%>" type='text' placeholder="<%=c.placeholder ? c.placeholder : ''%>" <%= c.key === 'home' && !hasHome ? `data-first-home=\"true\"` : "" %>>
           <% } %>
         <% } %>
         <% if (c.description) { %>
@@ -578,6 +650,29 @@ document.addEventListener('DOMContentLoaded', function() {
 document.addEventListener("DOMContentLoaded", async () => {
   //Reporter()
   const n = new N()
+  const homeInput = document.querySelector('input.homepath[name="home"]')
+  let showHomeWarning = () => {}
+  const originalHome = homeInput ? (homeInput.defaultValue || '') : ''
+  const isFirstHome = homeInput ? homeInput.dataset.firstHome === 'true' : false
+  if (homeInput) {
+    const warning = document.createElement('div')
+    warning.className = 'home-warning hidden'
+    warning.innerHTML = `
+      <ul>
+        <li>Avoid exFAT; it can cause permission/metadata issues.</li>
+        <li>Avoid spaces in the path; they can break tooling.</li>
+      </ul>
+    `
+    const parent = homeInput.parentElement
+    if (parent) {
+      parent.appendChild(warning)
+    }
+    const revealWarning = () => warning.classList.remove('hidden')
+    showHomeWarning = revealWarning
+    homeInput.addEventListener('focus', revealWarning)
+    homeInput.addEventListener('input', revealWarning)
+    homeInput.addEventListener('click', revealWarning)
+  }
   const updateThemeClassAcrossShells = (nextTheme) => {
     if (!nextTheme) {
       return
@@ -722,6 +817,7 @@ document.addEventListener("DOMContentLoaded", async () => {
   document.querySelector("main form").addEventListener("submit", async (e) => {
     e.preventDefault()
     e.stopPropagation()
+    showHomeWarning()
     let val = document.querySelector(`[name=home]`).value
     if (/.*\s+.*/.test(val)) {
       alert("Please use a home path that does NOT include a space")
@@ -733,6 +829,25 @@ document.addEventListener("DOMContentLoaded", async () => {
       document.querySelector("[name=home]").focus()
       return
     }
+    const isChanged = val !== originalHome
+    if (homeInput && (isFirstHome || isChanged)) {
+      const confirmResult = await Swal.fire({
+        title: 'Reminder',
+        html: 'exFAT drives often break permissions/metadata.<br>Please double-check the path isn\u2019t on exFAT. If it looks good, click \u201cSelect\u201d to continue.',
+        showCancelButton: true,
+        confirmButtonText: 'Select',
+        cancelButtonText: 'Cancel',
+        reverseButtons: true,
+        allowOutsideClick: false,
+        allowEscapeKey: false,
+        customClass: {
+          popup: 'custom-home-modal'
+        }
+      })
+      if (!confirmResult.isConfirmed) {
+        return
+      }
+    }
 
 //    let drive = document.querySelector(`[name=drive]`).value
 //    if (/.*\s+.*/.test(drive)) {

package/server/views/terminal.ejs

@@ -304,6 +304,7 @@ document.addEventListener("DOMContentLoaded", async () => {
   const baseScriptId = <% if (script_id) { %><%- JSON.stringify(script_id) %><% } else { %>null<% } %>
   const scriptUri = <% if (script_path) { %><%- JSON.stringify(script_path) %><% } else { %>null<% } %>
   const scriptCwd = <% if (cwd) { %><%- JSON.stringify(cwd) %><% } else { %>null<% } %>
+  const scriptAction = <% if (typeof action !== 'undefined') { %><%- JSON.stringify(action) %><% } else { %>null<% } %>
   class RPC {
     constructor() {
       this.socket = new Socket()
@@ -458,6 +459,9 @@ document.addEventListener("DOMContentLoaded", async () => {
             rows: this.term.rows,
           }
         }
+        if (scriptAction) {
+          payload.action = scriptAction
+        }
         if (scriptCwd) {
           payload.cwd = scriptCwd
         }