aicoding-rules 0.2.0 → 0.3.1

package/README.md

@@ -1,6 +1,6 @@
 # aicoding-rules
 
-A CLI tool to download and install AI coding rules for various AI assistants.
+A CLI tool to download and install AI coding rules and skills for various AI assistants.
 
 ## Supported Tools
 
@@ -58,6 +58,20 @@ Install all rules at once:
 npx aicoding-rules all
 ```
 
+### Skills
+
+Install AI coding skills with interactive selection:
+
+```bash
+npx aicoding-rules skills
+```
+
+Use `--replace` flag to remove and reinstall existing skill folders:
+
+```bash
+npx aicoding-rules skills --replace
+```
+
 ## Authentication
 
 The tool uses Plus4U OIDC authentication. On first run, a browser window will open for you to log in. The authentication token is cached for the session.
@@ -93,3 +107,25 @@ Rules are extracted to the current working directory. Run the command from the r
 
 - Node.js >= 18.0.0
 - Plus4U account with access to the rules repository
+
+## Changelog
+
+### 0.3.0 (2026-01-29)
+
+- Added `--replace` option for skills command to completely remove and reinstall existing skill folders before extracting
+- Improved extraction logic to detect top-level folders in zip archives
+
+### 0.2.0 (2026-01-27)
+
+- Added skills support with interactive selection
+- New `skills` command for downloading AI coding skills
+- Skills can be installed to custom target directories
+
+### 0.1.0 (2026-01-09)
+
+- Initial release
+- Support for Cursor, Claude, Antigravity, and Copilot rules
+- Interactive mode with checkbox selection
+- Direct commands for individual rule installation
+- Plus4U OIDC authentication
+- Custom configuration via `~/.aicoding-rules.json`

package/bin/cli.js

@@ -8,6 +8,17 @@ import { selectRules, selectSkills } from "../src/interactive.js";
 const config = loadConfig();
 const targetDir = process.cwd();
 
+function wrapAction(fn) {
+  return async (...args) => {
+    try {
+      await fn(...args);
+    } catch (err) {
+      console.error(`Error: ${err.message}`);
+      process.exit(1);
+    }
+  };
+}
+
 const program = new Command();
 
 program
@@ -18,53 +29,54 @@ program
 program
   .command("cursor")
   .description("Install Cursor rules")
-  .action(async () => {
+  .action(wrapAction(async () => {
     await downloadAndExtract(config, "cursor", targetDir);
-  });
+  }));
 
 program
   .command("claude")
   .description("Install Claude rules")
-  .action(async () => {
+  .action(wrapAction(async () => {
     await downloadAndExtract(config, "claude", targetDir);
-  });
+  }));
 
 program
   .command("antigravity")
   .description("Install Antigravity rules")
-  .action(async () => {
+  .action(wrapAction(async () => {
     await downloadAndExtract(config, "antigravity", targetDir);
-  });
+  }));
 
 program
   .command("copilot")
   .description("Install Copilot prompts")
-  .action(async () => {
+  .action(wrapAction(async () => {
     await downloadAndExtract(config, "copilot", targetDir);
-  });
+  }));
 
 program
   .command("all")
   .description("Install all rules")
-  .action(async () => {
+  .action(wrapAction(async () => {
     const allKeys = getRuleKeys(config);
     await downloadMultiple(config, allKeys, targetDir);
-  });
+  }));
 
 program
   .command("skills")
   .description("Install AI coding skills (interactive selection)")
-  .action(async () => {
+  .option("--replace", "Remove existing folders that match the zip contents before extracting (only those folders; other skills stay intact)")
+  .action(wrapAction(async (opts) => {
     const { selectedSkills, targetDir: skillsDir } = await selectSkills(config);
     if (selectedSkills.length > 0) {
-      await downloadMultipleSkills(config, selectedSkills, skillsDir);
+      await downloadMultipleSkills(config, selectedSkills, skillsDir, { replaceExtracted: opts.replace });
     }
-  });
+  }));
 
 program
-  .action(async () => {
+  .action(wrapAction(async () => {
     const selectedKeys = await selectRules(config);
     await downloadMultiple(config, selectedKeys, targetDir);
-  });
+  }));
 
 program.parse();

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "aicoding-rules",
-  "version": "0.2.0",
+  "version": "0.3.1",
   "description": "Download and install AI coding rules for Cursor, Claude, Antigravity, and Copilot",
   "license": "MIT",
   "type": "module",

package/src/download.js

@@ -1,10 +1,45 @@
 import AdmZip from "adm-zip";
-import { mkdirSync } from "fs";
+import { mkdirSync, rmSync, existsSync } from "fs";
+import { join } from "path";
 import { getAuthenticatedClient } from "./auth.js";
 
+const OVERWRITE_FILES = true;
+
+function getZipTopLevelNames(zip) {
+  const entries = zip.getEntries();
+  const topLevel = new Set();
+  for (const entry of entries) {
+    const name = entry.entryName.replace(/^\/+/, "");
+    if (!name) continue;
+
+    const firstSegment = name.split("/")[0];
+    if (firstSegment && firstSegment !== ".") {
+      topLevel.add(firstSegment);
+    }
+  }
+  return [...topLevel];
+}
+
+function removePathsInDir(targetDir, pathNames) {
+  for (const name of pathNames) {
+    const fullPath = join(targetDir, name);
+    if (existsSync(fullPath)) {
+      try {
+        rmSync(fullPath, { recursive: true, force: true });
+      } catch (err) {
+        throw new Error(`Failed to remove ${fullPath}: ${err.message}`);
+      }
+    }
+  }
+}
+
+function extractZip(zip, outputPath) {
+  zip.extractAllTo(outputPath, OVERWRITE_FILES);
+}
+
 function extractZipBuffer(buffer, outputPath) {
   const zip = new AdmZip(buffer);
-  zip.extractAllTo(outputPath, true);
+  zip.extractAllTo(outputPath, OVERWRITE_FILES);
 }
 
 function ensureDir(dirPath) {
@@ -44,7 +79,8 @@ export async function downloadMultiple(config, ruleKeys, targetDir) {
   }
 }
 
-export async function downloadSkill(config, skillKey, targetDir) {
+export async function downloadSkill(config, skillKey, targetDir, options = {}) {
+  const { replaceExtracted = false } = options;
   const skill = config.skills?.[skillKey];
   if (!skill) {
     throw new Error(`Unknown skill: ${skillKey}`);
@@ -71,15 +107,21 @@ export async function downloadSkill(config, skillKey, targetDir) {
 
   ensureDir(targetDir);
 
-  const attachmentBuffer = response.body;
-  extractZipBuffer(attachmentBuffer, targetDir);
+  const zip = new AdmZip(response.body);
+  if (replaceExtracted) {
+    const topLevelNames = getZipTopLevelNames(zip);
+    if (topLevelNames.length > 0) {
+      console.log(`  Replacing: ${topLevelNames.join(", ")}`);
+    }
+    removePathsInDir(targetDir, topLevelNames);
+  }
+  extractZip(zip, targetDir);
   
   console.log(`${skill.name} installed to ${targetDir}`);
 }
 
-export async function downloadMultipleSkills(config, skillKeys, targetDir) {
-  ensureDir(targetDir);
+export async function downloadMultipleSkills(config, skillKeys, targetDir, options = {}) {
   for (const key of skillKeys) {
-    await downloadSkill(config, key, targetDir);
+    await downloadSkill(config, key, targetDir, options);
   }
 }

package/src/interactive.js

@@ -71,8 +71,10 @@ export async function selectSkillsLocation() {
       choices: [
         { name: "~/.claude/skills (Claude global skills)", value: "claude-global" },
         { name: "~/.cursor/skills (Cursor global skills)", value: "cursor-global" },
+        { name: "~/.codex/skills (Codex global skills)", value: "codex-global" },
         { name: "Current directory - .claude/skills", value: "claude-local" },
-        { name: "Current directory - .cursor/skills", value: "cursor-local" }
+        { name: "Current directory - .cursor/skills", value: "cursor-local" },
+        { name: "Current directory - .codex/skills", value: "codex-local" }
       ]
     }
   ]);
@@ -89,10 +91,14 @@ function resolveSkillsPath(location) {
       return join(home, ".claude", "skills");
     case "cursor-global":
       return join(home, ".cursor", "skills");
+    case "codex-global":
+      return join(home, ".codex", "skills");
     case "claude-local":
       return join(cwd, ".claude", "skills");
     case "cursor-local":
       return join(cwd, ".cursor", "skills");
+    case "codex-local":
+      return join(cwd, ".codex", "skills");
     default:
       return cwd;
   }