cursor-kit-cli 1.0.3 → 1.1.0-beta.2

package/README.md

@@ -25,6 +25,15 @@ npm install -g cursor-kit-cli
 npx cursor-kit-cli init
 ```
 
+**CLI Aliases:** `cursor-kit`, `cursorkit`, or `ck`
+
+```bash
+# All of these work
+cursor-kit init
+cursorkit init
+ck init
+```
+
 ## ✨ Features
 
 - **📜 Commands** - Reusable prompt templates for common tasks
@@ -95,43 +104,53 @@ After running `cursor-kit init`, your project will have:
 ```
 your-project/
 └── .cursor/
-    ├── commands/           # Prompt templates
+    ├── commands/              # Prompt templates (.md)
+    │   ├── debug.md
+    │   ├── docs.md
+    │   ├── explain.md
+    │   ├── fix.md
     │   ├── implementation.md
     │   ├── refactor.md
     │   ├── review.md
-    │   ├── debug.md
-    │   ├── explain.md
     │   └── test.md
-    └── rules/              # AI behavior rules
-        ├── typescript.mdc
-        ├── react.mdc
-        ├── testing.mdc
+    └── rules/                 # AI behavior rules (.mdc)
+        ├── coding-style.mdc
+        ├── frontend-design-skills.mdc
         ├── git.mdc
+        ├── performance.mdc
+        ├── react.mdc
         ├── security.mdc
-        └── performance.mdc
+        ├── testing.mdc
+        └── typescript.mdc
 ```
 
 ## 🎯 Included Templates
 
 ### Commands
+
 | Command | Description |
 |---------|-------------|
+| `debug` | Systematic bug investigation |
+| `docs` | Create or update documentation |
+| `explain` | Clear technical explanations |
+| `fix` | Diagnose and fix bugs with root cause analysis |
 | `implementation` | Convert feature ideas into actionable plans |
 | `refactor` | Improve code quality without changing behavior |
 | `review` | Comprehensive code review checklist |
-| `debug` | Systematic bug investigation |
-| `explain` | Clear technical explanations |
 | `test` | Generate comprehensive test suites |
 
 ### Rules
+
 | Rule | Description |
 |------|-------------|
-| `typescript` | TypeScript best practices |
-| `react` | React component patterns |
-| `testing` | Testing standards |
+| `coding-style` | Core coding conventions and best practices |
+| `frontend-design-skills` | Typography, aesthetics, and UI guidelines |
 | `git` | Commit and branching conventions |
+| `performance` | Performance optimization patterns |
+| `react` | React component patterns |
 | `security` | Security guidelines |
-| `performance` | Performance optimization |
+| `testing` | Testing standards |
+| `typescript` | TypeScript best practices |
 
 ## 🛠️ Development
 
@@ -141,15 +160,22 @@ git clone https://github.com/duongductrong/cursor-kit.git
 cd cursor-kit
 
 # Install dependencies
-npm install
+pnpm install
 
 # Build
-npm run build
+pnpm build
 
 # Run locally
-node dist/cli.mjs
+node dist/cli.js
+
+# Development mode (watch)
+pnpm dev
 ```
 
+### Requirements
+
+- Node.js >= 18.0.0
+
 ## 📄 License
 
 MIT © [duongductrong](https://github.com/duongductrong)
@@ -159,4 +185,3 @@ MIT © [duongductrong](https://github.com/duongductrong)
 <p align="center">
   Made with ♥ for the Cursor community
 </p>
-

package/dist/cli.cjs

@@ -23,8 +23,13 @@ var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__ge
   mod
 ));
 
+// node_modules/.pnpm/tsup@8.5.1_typescript@5.9.3/node_modules/tsup/assets/cjs_shims.js
+var getImportMetaUrl = () => typeof document === "undefined" ? new URL(`file:${__filename}`).href : document.currentScript && document.currentScript.tagName.toUpperCase() === "SCRIPT" ? document.currentScript.src : new URL("main.js", document.baseURI).href;
+var importMetaUrl = /* @__PURE__ */ getImportMetaUrl();
+
 // src/cli.ts
 var import_citty6 = require("citty");
+var import_node_module = require("module");
 
 // src/utils/branding.ts
 var import_figlet = __toESM(require("figlet"), 1);
@@ -54,7 +59,7 @@ function printDivider() {
 }
 function printVersion(version) {
   console.log(
-    import_picocolors.default.dim("  v") + cursorGradient(version) + import_picocolors.default.dim(" \u2022 Made with \u2665")
+    import_picocolors.default.dim("  ") + cursorGradient(`v${version}`) + import_picocolors.default.dim(" \u2022 Made with \u2665")
   );
   console.log();
 }
@@ -66,7 +71,7 @@ function highlight(text2) {
 var import_citty = require("citty");
 var p = __toESM(require("@clack/prompts"), 1);
 var import_picocolors2 = __toESM(require("picocolors"), 1);
-var import_giget = require("giget");
+var import_node_path3 = require("path");
 
 // src/utils/fs.ts
 var import_node_fs = require("fs");
@@ -111,12 +116,190 @@ function getCommandsDir(cwd = process.cwd()) {
 function getRulesDir(cwd = process.cwd()) {
   return (0, import_node_path.join)(getCursorDir(cwd), "rules");
 }
+function getConflictingFiles(dir, files) {
+  if (!dirExists(dir)) return [];
+  return files.filter((file) => fileExists((0, import_node_path.join)(dir, file)));
+}
+
+// src/utils/templates.ts
+var import_node_path2 = require("path");
+var import_node_url = require("url");
 
 // src/utils/constants.ts
 var REPO_URL = "github:duongductrong/cursor-kit";
 var REPO_REF = "master";
+var REPO_RAW_URL = "https://raw.githubusercontent.com/duongductrong/cursor-kit/master";
+var TEMPLATE_PATHS = {
+  commands: "templates/commands",
+  rules: "templates/rules"
+};
+
+// src/utils/templates.ts
+function getLocalTemplatesDir() {
+  const currentDir = (0, import_node_path2.dirname)((0, import_node_url.fileURLToPath)(importMetaUrl));
+  return (0, import_node_path2.join)(currentDir, "..", "templates");
+}
+function getLocalManifest() {
+  const templatesDir = getLocalTemplatesDir();
+  const manifestPath = (0, import_node_path2.join)(templatesDir, "manifest.json");
+  if (fileExists(manifestPath)) {
+    try {
+      return JSON.parse(readFile(manifestPath));
+    } catch {
+      return null;
+    }
+  }
+  const commandsDir = (0, import_node_path2.join)(templatesDir, "commands");
+  const rulesDir = (0, import_node_path2.join)(templatesDir, "rules");
+  if (!dirExists(commandsDir) && !dirExists(rulesDir)) {
+    return null;
+  }
+  return {
+    commands: dirExists(commandsDir) ? listFiles(commandsDir, ".md") : [],
+    rules: dirExists(rulesDir) ? listFiles(rulesDir, ".mdc") : []
+  };
+}
+function getLocalTemplateContent(type, filename) {
+  const templatesDir = getLocalTemplatesDir();
+  const filePath = (0, import_node_path2.join)(templatesDir, type, filename);
+  if (fileExists(filePath)) {
+    return readFile(filePath);
+  }
+  return null;
+}
+async function fetchTemplateManifest() {
+  const localManifest = getLocalManifest();
+  if (localManifest) {
+    return localManifest;
+  }
+  const url = `${REPO_RAW_URL}/templates/manifest.json`;
+  const response = await fetch(url);
+  if (!response.ok) {
+    throw new Error(`Failed to fetch template manifest: ${response.statusText}`);
+  }
+  return response.json();
+}
+async function fetchTemplateContent(type, filename) {
+  const localContent = getLocalTemplateContent(type, filename);
+  if (localContent !== null) {
+    return localContent;
+  }
+  const templatePath = TEMPLATE_PATHS[type];
+  const url = `${REPO_RAW_URL}/${templatePath}/${filename}`;
+  const response = await fetch(url);
+  if (!response.ok) {
+    throw new Error(`Failed to fetch template ${filename}: ${response.statusText}`);
+  }
+  return response.text();
+}
+async function fetchMultipleTemplates(type, filenames) {
+  const results = /* @__PURE__ */ new Map();
+  const fetchPromises = filenames.map(async (filename) => {
+    const content = await fetchTemplateContent(type, filename);
+    return { filename, content };
+  });
+  const settled = await Promise.allSettled(fetchPromises);
+  for (const result of settled) {
+    if (result.status === "fulfilled") {
+      results.set(result.value.filename, result.value.content);
+    }
+  }
+  return results;
+}
+function getTemplateLabel(filename) {
+  const nameWithoutExt = filename.replace(/\.(md|mdc)$/, "");
+  return nameWithoutExt.split("-").map((word) => word.charAt(0).toUpperCase() + word.slice(1)).join(" ");
+}
 
 // src/commands/init.ts
+async function selectTemplates(type, availableTemplates) {
+  const selectionMode = await p.select({
+    message: `How would you like to add ${type}?`,
+    options: [
+      {
+        value: "all",
+        label: `Add all ${availableTemplates.length} ${type}`,
+        hint: "Install everything"
+      },
+      {
+        value: "select",
+        label: "Select specific items",
+        hint: "Choose which ones to install"
+      }
+    ]
+  });
+  if (p.isCancel(selectionMode)) return selectionMode;
+  if (selectionMode === "all") {
+    return availableTemplates;
+  }
+  const selectedTemplates = await p.multiselect({
+    message: `Select ${type} to add:`,
+    options: availableTemplates.map((template) => ({
+      value: template,
+      label: getTemplateLabel(template),
+      hint: template
+    })),
+    required: true
+  });
+  return selectedTemplates;
+}
+async function handleConflicts(type, conflictingFiles) {
+  console.log();
+  console.log(
+    import_picocolors2.default.yellow(`\u26A0 ${conflictingFiles.length} existing ${type} found:`)
+  );
+  for (const file of conflictingFiles) {
+    console.log(import_picocolors2.default.dim(`   \u2514\u2500 ${file}`));
+  }
+  console.log();
+  const strategy = await p.select({
+    message: "How would you like to handle conflicts?",
+    options: [
+      {
+        value: "overwrite",
+        label: "Overwrite existing files",
+        hint: "Replace all conflicting files"
+      },
+      {
+        value: "merge",
+        label: "Merge (keep existing, add new only)",
+        hint: "Skip files that already exist"
+      },
+      {
+        value: "cancel",
+        label: "Cancel",
+        hint: "Abort the operation"
+      }
+    ]
+  });
+  return strategy;
+}
+async function installTemplates(type, targetDir, selectedTemplates, conflictStrategy) {
+  const result = { added: [], skipped: [] };
+  const conflictingFiles = getConflictingFiles(targetDir, selectedTemplates);
+  let templatesToInstall;
+  if (conflictStrategy === "merge") {
+    templatesToInstall = selectedTemplates.filter(
+      (t) => !conflictingFiles.includes(t)
+    );
+    result.skipped = conflictingFiles.filter(
+      (f) => selectedTemplates.includes(f)
+    );
+  } else {
+    templatesToInstall = selectedTemplates;
+  }
+  if (templatesToInstall.length === 0) {
+    return result;
+  }
+  const templates = await fetchMultipleTemplates(type, templatesToInstall);
+  ensureDir(targetDir);
+  for (const [filename, content] of templates) {
+    const filePath = (0, import_node_path3.join)(targetDir, filename);
+    writeFile(filePath, content);
+    result.added.push(filename);
+  }
+  return result;
+}
 var initCommand = (0, import_citty.defineCommand)({
   meta: {
     name: "init",
@@ -126,7 +309,7 @@ var initCommand = (0, import_citty.defineCommand)({
     force: {
       type: "boolean",
       alias: "f",
-      description: "Overwrite existing files",
+      description: "Overwrite existing files without prompting",
       default: false
     },
     commands: {
@@ -140,6 +323,12 @@ var initCommand = (0, import_citty.defineCommand)({
       alias: "r",
       description: "Only initialize rules",
       default: false
+    },
+    all: {
+      type: "boolean",
+      alias: "a",
+      description: "Install all templates without selection prompts",
+      default: false
     }
   },
   async run({ args }) {
@@ -151,62 +340,126 @@ var initCommand = (0, import_citty.defineCommand)({
     const shouldInitCommands = initBoth || args.commands;
     const shouldInitRules = initBoth || args.rules;
     p.intro(import_picocolors2.default.bgCyan(import_picocolors2.default.black(" cursor-kit init ")));
-    const commandsExist = dirExists(commandsDir) && listFiles(commandsDir).length > 0;
-    const rulesExist = dirExists(rulesDir) && listFiles(rulesDir).length > 0;
-    if ((commandsExist || rulesExist) && !args.force) {
-      const existingItems = [];
-      if (commandsExist) existingItems.push("commands");
-      if (rulesExist) existingItems.push("rules");
-      const shouldContinue = await p.confirm({
-        message: `Existing ${existingItems.join(" and ")} found. Overwrite?`,
-        initialValue: false
-      });
-      if (p.isCancel(shouldContinue) || !shouldContinue) {
-        p.cancel("Operation cancelled");
-        process.exit(0);
-      }
-    }
     const s = p.spinner();
+    let manifest;
+    try {
+      s.start("Fetching template manifest...");
+      manifest = await fetchTemplateManifest();
+      s.stop("Template manifest loaded");
+    } catch (error) {
+      s.stop("Failed to fetch manifest");
+      p.cancel(
+        `Error: ${error instanceof Error ? error.message : "Unknown error"}`
+      );
+      process.exit(1);
+    }
+    const results = {};
     try {
       ensureDir(cursorDir);
       if (shouldInitCommands) {
-        s.start("Fetching commands templates...");
-        await (0, import_giget.downloadTemplate)(`${REPO_URL}/templates/commands#${REPO_REF}`, {
-          dir: commandsDir,
-          force: true
-        });
-        s.stop("Commands initialized");
+        let selectedCommands;
+        if (args.all) {
+          selectedCommands = manifest.commands;
+        } else {
+          const selection = await selectTemplates("commands", manifest.commands);
+          if (p.isCancel(selection)) {
+            p.cancel("Operation cancelled");
+            process.exit(0);
+          }
+          selectedCommands = selection;
+        }
+        const conflictingCommands = getConflictingFiles(
+          commandsDir,
+          selectedCommands
+        );
+        let commandStrategy = "overwrite";
+        if (conflictingCommands.length > 0 && !args.force) {
+          const strategy = await handleConflicts("commands", conflictingCommands);
+          if (p.isCancel(strategy) || strategy === "cancel") {
+            p.cancel("Operation cancelled");
+            process.exit(0);
+          }
+          commandStrategy = strategy;
+        }
+        s.start("Installing commands...");
+        results.commands = await installTemplates(
+          "commands",
+          commandsDir,
+          selectedCommands,
+          commandStrategy
+        );
+        s.stop("Commands installed");
       }
       if (shouldInitRules) {
-        s.start("Fetching rules templates...");
-        await (0, import_giget.downloadTemplate)(`${REPO_URL}/templates/rules#${REPO_REF}`, {
-          dir: rulesDir,
-          force: true
-        });
-        s.stop("Rules initialized");
+        let selectedRules;
+        if (args.all) {
+          selectedRules = manifest.rules;
+        } else {
+          const selection = await selectTemplates("rules", manifest.rules);
+          if (p.isCancel(selection)) {
+            p.cancel("Operation cancelled");
+            process.exit(0);
+          }
+          selectedRules = selection;
+        }
+        const conflictingRules = getConflictingFiles(rulesDir, selectedRules);
+        let ruleStrategy = "overwrite";
+        if (conflictingRules.length > 0 && !args.force) {
+          const strategy = await handleConflicts("rules", conflictingRules);
+          if (p.isCancel(strategy) || strategy === "cancel") {
+            p.cancel("Operation cancelled");
+            process.exit(0);
+          }
+          ruleStrategy = strategy;
+        }
+        s.start("Installing rules...");
+        results.rules = await installTemplates(
+          "rules",
+          rulesDir,
+          selectedRules,
+          ruleStrategy
+        );
+        s.stop("Rules installed");
       }
       printDivider();
       console.log();
-      const commandFiles = listFiles(commandsDir, ".md");
-      const ruleFiles = listFiles(rulesDir, ".mdc");
-      if (shouldInitCommands && commandFiles.length > 0) {
-        printSuccess(
-          `Commands: ${highlight(commandFiles.length.toString())} templates`
-        );
-        commandFiles.forEach((f) => {
-          console.log(import_picocolors2.default.dim(`   \u2514\u2500 ${f}`));
-        });
+      if (results.commands) {
+        const { added, skipped } = results.commands;
+        if (added.length > 0 || skipped.length > 0) {
+          printSuccess(
+            `Commands: ${highlight(added.length.toString())} added${skipped.length > 0 ? `, ${import_picocolors2.default.yellow(skipped.length.toString())} skipped` : ""}`
+          );
+          for (const f of added) {
+            console.log(import_picocolors2.default.dim(`   \u2514\u2500 ${import_picocolors2.default.green("+")} ${f}`));
+          }
+          for (const f of skipped) {
+            console.log(import_picocolors2.default.dim(`   \u2514\u2500 ${import_picocolors2.default.yellow("\u25CB")} ${f} (kept existing)`));
+          }
+        }
       }
-      if (shouldInitRules && ruleFiles.length > 0) {
-        printSuccess(
-          `Rules: ${highlight(ruleFiles.length.toString())} templates`
-        );
-        ruleFiles.forEach((f) => {
-          console.log(import_picocolors2.default.dim(`   \u2514\u2500 ${f}`));
-        });
+      if (results.rules) {
+        const { added, skipped } = results.rules;
+        if (added.length > 0 || skipped.length > 0) {
+          printSuccess(
+            `Rules: ${highlight(added.length.toString())} added${skipped.length > 0 ? `, ${import_picocolors2.default.yellow(skipped.length.toString())} skipped` : ""}`
+          );
+          for (const f of added) {
+            console.log(import_picocolors2.default.dim(`   \u2514\u2500 ${import_picocolors2.default.green("+")} ${f}`));
+          }
+          for (const f of skipped) {
+            console.log(import_picocolors2.default.dim(`   \u2514\u2500 ${import_picocolors2.default.yellow("\u25CB")} ${f} (kept existing)`));
+          }
+        }
+      }
+      const totalAdded = (results.commands?.added.length ?? 0) + (results.rules?.added.length ?? 0);
+      const totalSkipped = (results.commands?.skipped.length ?? 0) + (results.rules?.skipped.length ?? 0);
+      if (totalAdded === 0 && totalSkipped > 0) {
+        console.log();
+        p.outro(import_picocolors2.default.yellow("No new templates added (all selected files already exist)"));
+      } else {
+        console.log();
+        p.outro(import_picocolors2.default.green("\u2728 Cursor Kit initialized successfully!"));
       }
-      console.log();
-      p.outro(import_picocolors2.default.green("\u2728 Cursor Kit initialized successfully!"));
     } catch (error) {
       s.stop("Failed");
       p.cancel(
@@ -221,7 +474,7 @@ var initCommand = (0, import_citty.defineCommand)({
 var import_citty2 = require("citty");
 var p2 = __toESM(require("@clack/prompts"), 1);
 var import_picocolors3 = __toESM(require("picocolors"), 1);
-var import_node_path2 = require("path");
+var import_node_path4 = require("path");
 var COMMAND_TEMPLATE = `You are a helpful assistant. Describe what this command does.
 
 ## Instructions
@@ -318,7 +571,7 @@ var addCommand = (0, import_citty2.defineCommand)({
     const isCommand = itemType === "command";
     const targetDir = isCommand ? getCommandsDir() : getRulesDir();
     const extension = isCommand ? ".md" : ".mdc";
-    const filePath = (0, import_node_path2.join)(targetDir, `${slug}${extension}`);
+    const filePath = (0, import_node_path4.join)(targetDir, `${slug}${extension}`);
     if (fileExists(filePath)) {
       const shouldOverwrite = await p2.confirm({
         message: `${highlight(slug + extension)} already exists. Overwrite?`,
@@ -354,7 +607,7 @@ var addCommand = (0, import_citty2.defineCommand)({
 var import_citty3 = require("citty");
 var p3 = __toESM(require("@clack/prompts"), 1);
 var import_picocolors4 = __toESM(require("picocolors"), 1);
-var import_giget2 = require("giget");
+var import_giget = require("giget");
 var pullCommand = (0, import_citty3.defineCommand)({
   meta: {
     name: "pull",
@@ -413,7 +666,7 @@ var pullCommand = (0, import_citty3.defineCommand)({
       ensureDir(getCursorDir());
       if (shouldPullCommands) {
         s.start("Pulling commands...");
-        await (0, import_giget2.downloadTemplate)(`${REPO_URL}/templates/commands#${REPO_REF}`, {
+        await (0, import_giget.downloadTemplate)(`${REPO_URL}/templates/commands#${REPO_REF}`, {
           dir: commandsDir,
           force: true
         });
@@ -421,7 +674,7 @@ var pullCommand = (0, import_citty3.defineCommand)({
       }
       if (shouldPullRules) {
         s.start("Pulling rules...");
-        await (0, import_giget2.downloadTemplate)(`${REPO_URL}/templates/rules#${REPO_REF}`, {
+        await (0, import_giget.downloadTemplate)(`${REPO_URL}/templates/rules#${REPO_REF}`, {
           dir: rulesDir,
           force: true
         });
@@ -457,7 +710,7 @@ var pullCommand = (0, import_citty3.defineCommand)({
 var import_citty4 = require("citty");
 var p4 = __toESM(require("@clack/prompts"), 1);
 var import_picocolors5 = __toESM(require("picocolors"), 1);
-var import_node_path3 = require("path");
+var import_node_path5 = require("path");
 function extractDescription(content, isCommand) {
   if (isCommand) {
     const firstLine = content.trim().split("\n")[0];
@@ -475,7 +728,7 @@ function extractDescription(content, isCommand) {
 function getItems(dir, extension, isCommand) {
   const files = listFiles(dir, extension);
   return files.map((file) => {
-    const filePath = (0, import_node_path3.join)(dir, file);
+    const filePath = (0, import_node_path5.join)(dir, file);
     const content = fileExists(filePath) ? readFile(filePath) : "";
     return {
       name: file.replace(extension, ""),
@@ -566,7 +819,7 @@ var listCommand = (0, import_citty4.defineCommand)({
 var import_citty5 = require("citty");
 var p5 = __toESM(require("@clack/prompts"), 1);
 var import_picocolors6 = __toESM(require("picocolors"), 1);
-var import_node_path4 = require("path");
+var import_node_path6 = require("path");
 var removeCommand = (0, import_citty5.defineCommand)({
   meta: {
     name: "remove",
@@ -658,7 +911,7 @@ var removeCommand = (0, import_citty5.defineCommand)({
       }
       itemName = nameResult;
     }
-    const filePath = (0, import_node_path4.join)(dir, `${itemName}${extension}`);
+    const filePath = (0, import_node_path6.join)(dir, `${itemName}${extension}`);
     if (!fileExists(filePath)) {
       p5.cancel(`${itemType} '${itemName}' not found`);
       process.exit(1);
@@ -687,15 +940,17 @@ var removeCommand = (0, import_citty5.defineCommand)({
 });
 
 // src/cli.ts
+var require2 = (0, import_node_module.createRequire)(importMetaUrl);
+var pkg = require2("../package.json");
 var main = (0, import_citty6.defineCommand)({
   meta: {
     name: "cursor-kit",
-    version: "0.1.0",
+    version: pkg.version,
     description: "CLI toolkit to manage Cursor IDE rules and commands"
   },
   setup() {
     printBanner();
-    printVersion("0.1.0");
+    printVersion(pkg.version);
   },
   subCommands: {
     init: initCommand,