@muggleai/works 4.0.0 → 4.0.1

package/README.md

@@ -36,6 +36,14 @@ In Claude Code, run:
 /plugin install muggleai@muggle-works
 ```
 
+If you install via npm instead:
+
+```bash
+npm install -g @muggleai/works
+```
+
+`npm install` updates the CLI and syncs `muggle-*` skills to `~/.cursor/skills/` for Cursor discovery. Claude slash commands are plugin-managed, so update those with `/plugin update muggleai@muggle-works`.
+
 This installs the Muggle AI plugin with:
 
 - `/muggle:muggle` — command router and menu

package/dist/plugin/.claude-plugin/plugin.json

@@ -1,7 +1,7 @@
 {
   "name": "muggle",
   "description": "Run real-browser QA tests on your web app from any AI coding agent. Generate test scripts from plain English, replay them on localhost, capture screenshots, and validate user flows like signup, checkout, and dashboards. Works across Claude Code, Cursor, Codex, and Windsurf.",
-  "version": "4.0.0",
+  "version": "4.0.1",
   "author": {
     "name": "Muggle AI",
     "email": "support@muggle-ai.com"

package/dist/plugin/.cursor-plugin/plugin.json

@@ -2,7 +2,7 @@
   "name": "muggle",
   "displayName": "Muggle AI",
   "description": "Ship quality products with AI-powered QA that validates your app's user experience — from Claude Code and Cursor to PR.",
-  "version": "4.0.0",
+  "version": "4.0.1",
   "author": {
     "name": "Muggle AI",
     "email": "support@muggle-ai.com"

package/dist/plugin/README.md

@@ -9,6 +9,14 @@ Ship quality products with AI-powered QA that validates your app's user experien
 /plugin install muggleai@muggle-works
 ```
 
+For npm installs:
+
+```bash
+npm install -g @muggleai/works
+```
+
+This updates the CLI and syncs `muggle-*` skills into `~/.cursor/skills/` for Cursor. Claude slash commands remain plugin-managed, so use `/plugin update muggleai@muggle-works` to refresh them.
+
 ## Skills
 
 Type `muggle` to discover the full command family.

package/package.json

@@ -1,7 +1,7 @@
 {
     "name": "@muggleai/works",
     "mcpName": "io.github.multiplex-ai/muggle",
-    "version": "4.0.0",
+    "version": "4.0.1",
     "description": "Ship quality products with AI-powered QA that validates your app's user experience — from Claude Code and Cursor to PR.",
     "type": "module",
     "main": "dist/index.js",

package/plugin/.claude-plugin/plugin.json

@@ -1,7 +1,7 @@
 {
   "name": "muggle",
   "description": "Run real-browser QA tests on your web app from any AI coding agent. Generate test scripts from plain English, replay them on localhost, capture screenshots, and validate user flows like signup, checkout, and dashboards. Works across Claude Code, Cursor, Codex, and Windsurf.",
-  "version": "4.0.0",
+  "version": "4.0.1",
   "author": {
     "name": "Muggle AI",
     "email": "support@muggle-ai.com"

package/plugin/.cursor-plugin/plugin.json

@@ -2,7 +2,7 @@
   "name": "muggle",
   "displayName": "Muggle AI",
   "description": "Ship quality products with AI-powered QA that validates your app's user experience — from Claude Code and Cursor to PR.",
-  "version": "4.0.0",
+  "version": "4.0.1",
   "author": {
     "name": "Muggle AI",
     "email": "support@muggle-ai.com"

package/plugin/README.md

@@ -9,6 +9,14 @@ Ship quality products with AI-powered QA that validates your app's user experien
 /plugin install muggleai@muggle-works
 ```
 
+For npm installs:
+
+```bash
+npm install -g @muggleai/works
+```
+
+This updates the CLI and syncs `muggle-*` skills into `~/.cursor/skills/` for Cursor. Claude slash commands remain plugin-managed, so use `/plugin update muggleai@muggle-works` to refresh them.
+
 ## Skills
 
 Type `muggle` to discover the full command family.

package/scripts/postinstall.mjs

@@ -8,6 +8,7 @@
 import { createHash } from "crypto";
 import { exec } from "child_process";
 import {
+    cpSync,
     readFileSync,
     appendFileSync,
     createReadStream,
@@ -19,15 +20,19 @@ import {
     writeFileSync,
 } from "fs";
 import { homedir, platform } from "os";
-import { join } from "path";
+import { dirname, join } from "path";
 import { pipeline } from "stream/promises";
 import { createRequire } from "module";
+import { fileURLToPath } from "url";
 
 const require = createRequire(import.meta.url);
 const VERSION_DIRECTORY_NAME_PATTERN = /^\d+\.\d+\.\d+(?:[-+][A-Za-z0-9.-]+)?$/;
 const INSTALL_METADATA_FILE_NAME = ".install-metadata.json";
 const LOG_FILE_NAME = "postinstall.log";
 const VERSION_OVERRIDE_FILE_NAME = "electron-app-version-override.json";
+const CURSOR_SKILLS_DIRECTORY_NAME = ".cursor";
+const CURSOR_SKILLS_SUBDIRECTORY_NAME = "skills";
+const MUGGLE_SKILL_PREFIX = "muggle";
 
 /**
  * Get the path to the postinstall log file.
@@ -111,6 +116,59 @@ function getDataDir() {
     return join(homedir(), ".muggle-ai");
 }
 
+/**
+ * Get the package root directory.
+ * @returns {string} Path to package root
+ */
+function getPackageRootDir() {
+    return join(dirname(fileURLToPath(import.meta.url)), "..");
+}
+
+/**
+ * Sync packaged muggle skills into Cursor user skills.
+ * This enables npm installs to refresh locally available `muggle-*` skills.
+ */
+function syncCursorSkills() {
+    const sourceSkillsDirectoryPath = join(getPackageRootDir(), "plugin", "skills");
+    if (!existsSync(sourceSkillsDirectoryPath)) {
+        log("Cursor skill sync skipped: packaged plugin skills directory not found.");
+        return;
+    }
+
+    const cursorSkillsDirectoryPath = join(
+        homedir(),
+        CURSOR_SKILLS_DIRECTORY_NAME,
+        CURSOR_SKILLS_SUBDIRECTORY_NAME,
+    );
+    mkdirSync(cursorSkillsDirectoryPath, { recursive: true });
+
+    const skillEntries = readdirSync(sourceSkillsDirectoryPath, { withFileTypes: true });
+    let syncedSkillCount = 0;
+
+    for (const skillEntry of skillEntries) {
+        if (!skillEntry.isDirectory()) {
+            continue;
+        }
+
+        if (!skillEntry.name.startsWith(MUGGLE_SKILL_PREFIX)) {
+            continue;
+        }
+
+        const sourceSkillDirectoryPath = join(sourceSkillsDirectoryPath, skillEntry.name);
+        const sourceSkillFilePath = join(sourceSkillDirectoryPath, "SKILL.md");
+        if (!existsSync(sourceSkillFilePath)) {
+            continue;
+        }
+
+        const targetSkillDirectoryPath = join(cursorSkillsDirectoryPath, skillEntry.name);
+        rmSync(targetSkillDirectoryPath, { recursive: true, force: true });
+        cpSync(sourceSkillDirectoryPath, targetSkillDirectoryPath, { recursive: true });
+        syncedSkillCount += 1;
+    }
+
+    log(`Synced ${syncedSkillCount} muggle skill(s) to ${cursorSkillsDirectoryPath}`);
+}
+
 /**
  * Get the Electron app directory.
  * @returns {string} Path to ~/.muggle-ai/electron-app
@@ -592,4 +650,5 @@ async function extractTarGz(tarPath, destDir) {
 // Run postinstall
 initLogFile();
 removeVersionOverrideFile();
+syncCursorSkills();
 downloadElectronApp().catch(logError);