claudekit-cli 3.18.0 → 3.20.0

package/dist/index.js

@@ -22342,6 +22342,153 @@ function getInstalledKits(metadata) {
   return [];
 }
 
+// node_modules/yocto-queue/index.js
+class Node {
+  value;
+  next;
+  constructor(value) {
+    this.value = value;
+  }
+}
+
+class Queue {
+  #head;
+  #tail;
+  #size;
+  constructor() {
+    this.clear();
+  }
+  enqueue(value) {
+    const node = new Node(value);
+    if (this.#head) {
+      this.#tail.next = node;
+      this.#tail = node;
+    } else {
+      this.#head = node;
+      this.#tail = node;
+    }
+    this.#size++;
+  }
+  dequeue() {
+    const current = this.#head;
+    if (!current) {
+      return;
+    }
+    this.#head = this.#head.next;
+    this.#size--;
+    if (!this.#head) {
+      this.#tail = undefined;
+    }
+    return current.value;
+  }
+  peek() {
+    if (!this.#head) {
+      return;
+    }
+    return this.#head.value;
+  }
+  clear() {
+    this.#head = undefined;
+    this.#tail = undefined;
+    this.#size = 0;
+  }
+  get size() {
+    return this.#size;
+  }
+  *[Symbol.iterator]() {
+    let current = this.#head;
+    while (current) {
+      yield current.value;
+      current = current.next;
+    }
+  }
+  *drain() {
+    while (this.#head) {
+      yield this.dequeue();
+    }
+  }
+}
+
+// node_modules/p-limit/index.js
+function pLimit(concurrency) {
+  validateConcurrency(concurrency);
+  const queue = new Queue;
+  let activeCount = 0;
+  const resumeNext = () => {
+    if (activeCount < concurrency && queue.size > 0) {
+      activeCount++;
+      queue.dequeue()();
+    }
+  };
+  const next = () => {
+    activeCount--;
+    resumeNext();
+  };
+  const run = async (function_, resolve2, arguments_) => {
+    const result = (async () => function_(...arguments_))();
+    resolve2(result);
+    try {
+      await result;
+    } catch {}
+    next();
+  };
+  const enqueue = (function_, resolve2, arguments_) => {
+    new Promise((internalResolve) => {
+      queue.enqueue(internalResolve);
+    }).then(run.bind(undefined, function_, resolve2, arguments_));
+    if (activeCount < concurrency) {
+      resumeNext();
+    }
+  };
+  const generator = (function_, ...arguments_) => new Promise((resolve2) => {
+    enqueue(function_, resolve2, arguments_);
+  });
+  Object.defineProperties(generator, {
+    activeCount: {
+      get: () => activeCount
+    },
+    pendingCount: {
+      get: () => queue.size
+    },
+    clearQueue: {
+      value() {
+        queue.clear();
+      }
+    },
+    concurrency: {
+      get: () => concurrency,
+      set(newConcurrency) {
+        validateConcurrency(newConcurrency);
+        concurrency = newConcurrency;
+        queueMicrotask(() => {
+          while (activeCount < concurrency && queue.size > 0) {
+            resumeNext();
+          }
+        });
+      }
+    },
+    map: {
+      async value(iterable, function_) {
+        const promises2 = Array.from(iterable, (value, index) => this(function_, value, index));
+        return Promise.all(promises2);
+      }
+    }
+  });
+  return generator;
+}
+function validateConcurrency(concurrency) {
+  if (!((Number.isInteger(concurrency) || concurrency === Number.POSITIVE_INFINITY) && concurrency > 0)) {
+    throw new TypeError("Expected `concurrency` to be a number from 1 and up");
+  }
+}
+
+// src/shared/concurrent-file-ops.ts
+var DEFAULT_CONCURRENCY = 50;
+async function mapWithLimit(items, fn, concurrency = DEFAULT_CONCURRENCY) {
+  const limit = pLimit(concurrency);
+  return Promise.all(items.map((item) => limit(() => fn(item))));
+}
+
 // src/services/file-operations/ownership-checker.ts
 class OwnershipChecker {
   static async calculateChecksum(filePath) {
@@ -22392,7 +22539,7 @@ class OwnershipChecker {
     };
   }
   static async checkBatch(filePaths, metadata, claudeDir) {
-    const results = await Promise.all(filePaths.map((path2) => OwnershipChecker.checkOwnership(path2, metadata, claudeDir)));
+    const results = await mapWithLimit(filePaths, (path2) => OwnershipChecker.checkOwnership(path2, metadata, claudeDir));
     return new Map(results.map((r2) => [r2.path, r2]));
   }
 }
@@ -23905,6 +24052,7 @@ init_logger();
 
 // src/domains/ui/prompts/kit-prompts.ts
 init_types2();
+var MIN_KITS_FOR_MULTISELECT = 2;
 async function selectKit(defaultKit, accessibleKits) {
   const kits = accessibleKits ?? Object.keys(AVAILABLE_KITS);
   const kit = await ie({
@@ -23921,6 +24069,24 @@ async function selectKit(defaultKit, accessibleKits) {
   }
   return kit;
 }
+async function selectKits(accessibleKits) {
+  if (accessibleKits.length < MIN_KITS_FOR_MULTISELECT) {
+    throw new Error(`selectKits requires at least ${MIN_KITS_FOR_MULTISELECT} accessible kits`);
+  }
+  const selected = await ae({
+    message: "Select ClaudeKit(s) to install:",
+    options: accessibleKits.map((key) => ({
+      value: key,
+      label: AVAILABLE_KITS[key].name,
+      hint: AVAILABLE_KITS[key].description
+    })),
+    required: true
+  });
+  if (lD(selected)) {
+    throw new Error("Kit selection cancelled");
+  }
+  return selected;
+}
 async function getDirectory(defaultDir = ".") {
   const dir = await te({
     message: "Enter target directory:",
@@ -24447,6 +24613,9 @@ class PromptsManager {
   async selectKit(defaultKit, accessibleKits) {
     return selectKit(defaultKit, accessibleKits);
   }
+  async selectKits(accessibleKits) {
+    return selectKits(accessibleKits);
+  }
   async selectVersion(versions, defaultVersion) {
     return selectVersion(versions, defaultVersion);
   }
@@ -24550,6 +24719,7 @@ class PromptsManager {
 
 // src/commands/init/init-command.ts
 init_logger();
+init_types2();
 
 // src/commands/init/phases/conflict-handler.ts
 init_logger();
@@ -31338,7 +31508,7 @@ class Yallist {
 function insertAfter(self2, node, value) {
   const prev = node;
   const next = node ? node.next : self2.head;
-  const inserted = new Node(value, prev, next, self2);
+  const inserted = new Node2(value, prev, next, self2);
   if (inserted.next === undefined) {
     self2.tail = inserted;
   }
@@ -31349,21 +31519,21 @@ function insertAfter(self2, node, value) {
   return inserted;
 }
 function push(self2, item) {
-  self2.tail = new Node(item, self2.tail, undefined, self2);
+  self2.tail = new Node2(item, self2.tail, undefined, self2);
   if (!self2.head) {
     self2.head = self2.tail;
   }
   self2.length++;
 }
 function unshift(self2, item) {
-  self2.head = new Node(item, undefined, self2.head, self2);
+  self2.head = new Node2(item, undefined, self2.head, self2);
   if (!self2.tail) {
     self2.tail = self2.head;
   }
   self2.length++;
 }
 
-class Node {
+class Node2 {
   list;
   next;
   prev;
@@ -36547,146 +36717,6 @@ class ReleaseManifestLoader {
 init_environment();
 init_logger();
 
-// node_modules/yocto-queue/index.js
-class Node2 {
-  value;
-  next;
-  constructor(value) {
-    this.value = value;
-  }
-}
-
-class Queue {
-  #head;
-  #tail;
-  #size;
-  constructor() {
-    this.clear();
-  }
-  enqueue(value) {
-    const node = new Node2(value);
-    if (this.#head) {
-      this.#tail.next = node;
-      this.#tail = node;
-    } else {
-      this.#head = node;
-      this.#tail = node;
-    }
-    this.#size++;
-  }
-  dequeue() {
-    const current = this.#head;
-    if (!current) {
-      return;
-    }
-    this.#head = this.#head.next;
-    this.#size--;
-    if (!this.#head) {
-      this.#tail = undefined;
-    }
-    return current.value;
-  }
-  peek() {
-    if (!this.#head) {
-      return;
-    }
-    return this.#head.value;
-  }
-  clear() {
-    this.#head = undefined;
-    this.#tail = undefined;
-    this.#size = 0;
-  }
-  get size() {
-    return this.#size;
-  }
-  *[Symbol.iterator]() {
-    let current = this.#head;
-    while (current) {
-      yield current.value;
-      current = current.next;
-    }
-  }
-  *drain() {
-    while (this.#head) {
-      yield this.dequeue();
-    }
-  }
-}
-
-// node_modules/p-limit/index.js
-function pLimit(concurrency) {
-  validateConcurrency(concurrency);
-  const queue = new Queue;
-  let activeCount = 0;
-  const resumeNext = () => {
-    if (activeCount < concurrency && queue.size > 0) {
-      activeCount++;
-      queue.dequeue()();
-    }
-  };
-  const next = () => {
-    activeCount--;
-    resumeNext();
-  };
-  const run = async (function_, resolve6, arguments_) => {
-    const result = (async () => function_(...arguments_))();
-    resolve6(result);
-    try {
-      await result;
-    } catch {}
-    next();
-  };
-  const enqueue = (function_, resolve6, arguments_) => {
-    new Promise((internalResolve) => {
-      queue.enqueue(internalResolve);
-    }).then(run.bind(undefined, function_, resolve6, arguments_));
-    if (activeCount < concurrency) {
-      resumeNext();
-    }
-  };
-  const generator = (function_, ...arguments_) => new Promise((resolve6) => {
-    enqueue(function_, resolve6, arguments_);
-  });
-  Object.defineProperties(generator, {
-    activeCount: {
-      get: () => activeCount
-    },
-    pendingCount: {
-      get: () => queue.size
-    },
-    clearQueue: {
-      value() {
-        queue.clear();
-      }
-    },
-    concurrency: {
-      get: () => concurrency,
-      set(newConcurrency) {
-        validateConcurrency(newConcurrency);
-        concurrency = newConcurrency;
-        queueMicrotask(() => {
-          while (activeCount < concurrency && queue.size > 0) {
-            resumeNext();
-          }
-        });
-      }
-    },
-    map: {
-      async value(iterable, function_) {
-        const promises3 = Array.from(iterable, (value, index) => this(function_, value, index));
-        return Promise.all(promises3);
-      }
-    }
-  });
-  return generator;
-}
-function validateConcurrency(concurrency) {
-  if (!((Number.isInteger(concurrency) || concurrency === Number.POSITIVE_INFINITY) && concurrency > 0)) {
-    throw new TypeError("Expected `concurrency` to be a number from 1 and up");
-  }
-}
-
 // src/services/file-operations/manifest/manifest-updater.ts
 import { join as join41 } from "node:path";
 init_logger();
@@ -37030,10 +37060,10 @@ class LegacyMigration {
       }
     }
     if (filesInManifest.length > 0) {
-      const checksumResults = await Promise.all(filesInManifest.map(async ({ file, relativePath, manifestChecksum }) => {
+      const checksumResults = await mapWithLimit(filesInManifest, async ({ file, relativePath, manifestChecksum }) => {
         const actualChecksum = await OwnershipChecker.calculateChecksum(file);
         return { relativePath, actualChecksum, manifestChecksum };
-      }));
+      });
       for (const { relativePath, actualChecksum, manifestChecksum } of checksumResults) {
         if (actualChecksum === manifestChecksum) {
           preview.ckPristine.push(relativePath);
@@ -37085,11 +37115,11 @@ User-created files (sample):`);
       ...preview.userCreated.map((p) => ({ relativePath: p, ownership: "user" }))
     ];
     if (filesToChecksum.length > 0) {
-      const checksumResults = await Promise.all(filesToChecksum.map(async ({ relativePath, ownership }) => {
+      const checksumResults = await mapWithLimit(filesToChecksum, async ({ relativePath, ownership }) => {
         const fullPath = join43(claudeDir, relativePath);
         const checksum = await OwnershipChecker.calculateChecksum(fullPath);
         return { relativePath, checksum, ownership };
-      }));
+      });
       for (const { relativePath, checksum, ownership } of checksumResults) {
         trackedFiles.push({
           path: relativePath,
@@ -39616,11 +39646,51 @@ async function handleSelection(ctx) {
       return { ...ctx, cancelled: true };
     }
   }
-  let kitType = ctx.options.kit || config.defaults?.kit;
-  if (kitType && accessibleKits && !accessibleKits.includes(kitType)) {
-    logger.error(`No access to ${AVAILABLE_KITS[kitType].name}`);
-    logger.info("Purchase at https://claudekit.cc");
-    return { ...ctx, cancelled: true };
+  let kitType;
+  let pendingKits;
+  const kitOption = ctx.options.kit || config.defaults?.kit;
+  if (kitOption) {
+    const allKitTypes = Object.keys(AVAILABLE_KITS);
+    if (kitOption === "all") {
+      const kitsToInstall = accessibleKits ?? allKitTypes;
+      if (kitsToInstall.length === 0) {
+        logger.error("No kits accessible for installation");
+        return { ...ctx, cancelled: true };
+      }
+      kitType = kitsToInstall[0];
+      if (kitsToInstall.length > 1) {
+        pendingKits = kitsToInstall.slice(1);
+      }
+      logger.info(`Installing all accessible kits: ${kitsToInstall.map((k2) => AVAILABLE_KITS[k2].name).join(", ")}`);
+    } else if (kitOption.includes(",")) {
+      const requestedKits = kitOption.split(",").map((k2) => k2.trim());
+      const invalidKits = requestedKits.filter((k2) => !allKitTypes.includes(k2));
+      if (invalidKits.length > 0) {
+        logger.error(`Invalid kit(s): ${invalidKits.join(", ")}`);
+        logger.info(`Valid kits: ${allKitTypes.join(", ")}`);
+        return { ...ctx, cancelled: true };
+      }
+      if (accessibleKits) {
+        const noAccessKits = requestedKits.filter((k2) => !accessibleKits.includes(k2));
+        if (noAccessKits.length > 0) {
+          logger.error(`No access to: ${noAccessKits.map((k2) => AVAILABLE_KITS[k2].name).join(", ")}`);
+          logger.info("Purchase at https://claudekit.cc");
+          return { ...ctx, cancelled: true };
+        }
+      }
+      kitType = requestedKits[0];
+      if (requestedKits.length > 1) {
+        pendingKits = requestedKits.slice(1);
+      }
+      logger.info(`Installing kits: ${requestedKits.map((k2) => AVAILABLE_KITS[k2].name).join(", ")}`);
+    } else {
+      kitType = kitOption;
+      if (accessibleKits && !accessibleKits.includes(kitType)) {
+        logger.error(`No access to ${AVAILABLE_KITS[kitType].name}`);
+        logger.info("Purchase at https://claudekit.cc");
+        return { ...ctx, cancelled: true };
+      }
+    }
   }
   if (!kitType) {
     if (ctx.isNonInteractive) {
@@ -39632,6 +39702,16 @@ async function handleSelection(ctx) {
     } else if (accessibleKits?.length === 1) {
       kitType = accessibleKits[0];
       logger.info(`Using ${AVAILABLE_KITS[kitType].name} (only accessible kit)`);
+    } else if (accessibleKits && accessibleKits.length > 1) {
+      const selectedKits = await ctx.prompts.selectKits(accessibleKits);
+      if (selectedKits.length === 0) {
+        throw new Error("At least one kit must be selected");
+      }
+      kitType = selectedKits[0];
+      if (selectedKits.length > 1) {
+        pendingKits = selectedKits.slice(1);
+        logger.success(`Selected ${selectedKits.length} kits: ${selectedKits.map((k2) => AVAILABLE_KITS[k2].name).join(", ")}`);
+      }
     } else {
       kitType = await ctx.prompts.selectKit(undefined, accessibleKits);
     }
@@ -39781,7 +39861,9 @@ async function handleSelection(ctx) {
     kitType,
     resolvedDir,
     release,
-    selectedVersion
+    selectedVersion,
+    pendingKits,
+    accessibleKits
   };
 }
 // src/commands/init/phases/sync-handler.ts
@@ -40605,6 +40687,50 @@ async function handleTransforms(ctx) {
   };
 }
 // src/commands/init/init-command.ts
+async function installAdditionalKit(baseCtx, kitType) {
+  const kit = AVAILABLE_KITS[kitType];
+  const github = new GitHubClient;
+  logger.info(`
+Installing additional kit: ${kit.name}`);
+  let release;
+  if (baseCtx.selectedVersion && !baseCtx.selectedVersion.includes("latest")) {
+    try {
+      release = await github.getReleaseByTag(kit, baseCtx.selectedVersion);
+      logger.success(`Found matching version: ${release.tag_name}`);
+    } catch {
+      logger.warning(`Version ${baseCtx.selectedVersion} not available for ${kit.name}, using latest`);
+      release = await github.getLatestRelease(kit, baseCtx.options.beta);
+      logger.success(`Found: ${release.tag_name}`);
+    }
+  } else {
+    release = await github.getLatestRelease(kit, baseCtx.options.beta);
+    logger.success(`Found: ${release.tag_name}`);
+  }
+  let ctx = {
+    ...baseCtx,
+    kit,
+    kitType,
+    release,
+    selectedVersion: release.tag_name,
+    tempDir: undefined,
+    archivePath: undefined,
+    extractDir: undefined
+  };
+  ctx = await handleDownload(ctx);
+  if (ctx.cancelled)
+    return ctx;
+  ctx = await handleTransforms(ctx);
+  if (ctx.cancelled)
+    return ctx;
+  ctx = await handleMigration(ctx);
+  if (ctx.cancelled)
+    return ctx;
+  ctx = await handleMerge(ctx);
+  if (ctx.cancelled)
+    return ctx;
+  ctx = await handlePostInstall(ctx);
+  return ctx;
+}
 function createInitContext(rawOptions, prompts) {
   const placeholderOptions = {
     dir: ".",
@@ -40685,6 +40811,28 @@ async function initCommand(options) {
       if (ctx.cancelled)
         return;
     }
+    if (!isSyncMode && ctx.pendingKits && ctx.pendingKits.length > 0 && ctx.kitType) {
+      const installedKits = [ctx.kitType];
+      const kitsToInstall = [...ctx.pendingKits];
+      for (const pendingKit of kitsToInstall) {
+        try {
+          ctx = await installAdditionalKit(ctx, pendingKit);
+          if (ctx.cancelled) {
+            logger.warning(`Installation of ${AVAILABLE_KITS[pendingKit].name} was cancelled`);
+            break;
+          }
+          installedKits.push(pendingKit);
+        } catch (error) {
+          logger.error(`Failed to install ${AVAILABLE_KITS[pendingKit].name}: ${error instanceof Error ? error.message : "Unknown error"}`);
+          if (installedKits.length > 1) {
+            logger.info(`Successfully installed: ${installedKits.map((k2) => AVAILABLE_KITS[k2].name).join(", ")}`);
+          }
+          throw error;
+        }
+      }
+      logger.success(`
+Installed ${installedKits.length} kits: ${installedKits.map((k2) => AVAILABLE_KITS[k2].name).join(", ")}`);
+    }
     prompts.outro(`Project initialized successfully at ${ctx.resolvedDir}`);
     const protectedNote = ctx.customClaudeFiles.length > 0 ? `Your project has been initialized with the latest version.
 Protected files (.env, .claude custom files, etc.) were not modified.` : `Your project has been initialized with the latest version.
@@ -41766,7 +41914,7 @@ var import_picocolors24 = __toESM(require_picocolors(), 1);
 // package.json
 var package_default = {
   name: "claudekit-cli",
-  version: "3.18.0",
+  version: "3.20.0",
   description: "CLI tool for bootstrapping and updating ClaudeKit projects",
   type: "module",
   repository: {
@@ -42136,13 +42284,13 @@ ${import_picocolors25.default.bold(import_picocolors25.default.cyan(result.kitCo
 // src/cli/command-registry.ts
 init_logger();
 function registerCommands(cli) {
-  cli.command("new", "Bootstrap a new ClaudeKit project (with interactive version selection)").option("--dir <dir>", "Target directory (default: .)").option("--kit <kit>", "Kit to use (engineer, marketing)").option("-r, --release <version>", "Skip version selection, use specific version (e.g., latest, v1.0.0)").option("--force", "Overwrite existing files without confirmation").option("--exclude <pattern>", "Exclude files matching glob pattern (can be used multiple times)").option("--opencode", "Install OpenCode CLI package (non-interactive mode)").option("--gemini", "Install Google Gemini CLI package (non-interactive mode)").option("--install-skills", "Install skills dependencies (non-interactive mode)").option("--with-sudo", "Include system packages requiring sudo (Linux: ffmpeg, imagemagick)").option("--prefix", "Add /ck: prefix to all slash commands by moving them to commands/ck/ subdirectory").option("--beta", "Show beta versions in selection prompt").option("--refresh", "Bypass release cache to fetch latest versions from GitHub").option("--docs-dir <name>", "Custom docs folder name (default: docs)").option("--plans-dir <name>", "Custom plans folder name (default: plans)").option("-y, --yes", "Non-interactive mode with sensible defaults (skip all prompts)").option("--use-git", "Use git clone instead of GitHub API (uses SSH/HTTPS credentials)").action(async (options) => {
+  cli.command("new", "Bootstrap a new ClaudeKit project (with interactive version selection)").option("--dir <dir>", "Target directory (default: .)").option("--kit <kit>", "Kit to use: engineer, marketing, all, or comma-separated").option("-r, --release <version>", "Skip version selection, use specific version (e.g., latest, v1.0.0)").option("--force", "Overwrite existing files without confirmation").option("--exclude <pattern>", "Exclude files matching glob pattern (can be used multiple times)").option("--opencode", "Install OpenCode CLI package (non-interactive mode)").option("--gemini", "Install Google Gemini CLI package (non-interactive mode)").option("--install-skills", "Install skills dependencies (non-interactive mode)").option("--with-sudo", "Include system packages requiring sudo (Linux: ffmpeg, imagemagick)").option("--prefix", "Add /ck: prefix to all slash commands by moving them to commands/ck/ subdirectory").option("--beta", "Show beta versions in selection prompt").option("--refresh", "Bypass release cache to fetch latest versions from GitHub").option("--docs-dir <name>", "Custom docs folder name (default: docs)").option("--plans-dir <name>", "Custom plans folder name (default: plans)").option("-y, --yes", "Non-interactive mode with sensible defaults (skip all prompts)").option("--use-git", "Use git clone instead of GitHub API (uses SSH/HTTPS credentials)").action(async (options) => {
     if (options.exclude && !Array.isArray(options.exclude)) {
       options.exclude = [options.exclude];
     }
     await newCommand(options);
   });
-  cli.command("init", "Initialize or update ClaudeKit project (with interactive version selection)").option("--dir <dir>", "Target directory (default: .)").option("--kit <kit>", "Kit to use (engineer, marketing)").option("-r, --release <version>", "Skip version selection, use specific version (e.g., latest, v1.0.0)").option("--exclude <pattern>", "Exclude files matching glob pattern (can be used multiple times)").option("--only <pattern>", "Include only files matching glob pattern (can be used multiple times)").option("-g, --global", "Use platform-specific user configuration directory").option("--fresh", "Completely remove .claude directory before downloading (requires confirmation)").option("--install-skills", "Install skills dependencies (non-interactive mode)").option("--with-sudo", "Include system packages requiring sudo (Linux: ffmpeg, imagemagick)").option("--prefix", "Add /ck: prefix to all slash commands by moving them to commands/ck/ subdirectory").option("--beta", "Show beta versions in selection prompt").option("--refresh", "Bypass release cache to fetch latest versions from GitHub").option("--dry-run", "Preview changes without applying them (requires --prefix)").option("--force-overwrite", "Override ownership protections and delete user-modified files (requires --prefix)").option("--force-overwrite-settings", "Fully replace settings.json instead of selective merge (destroys user customizations)").option("--skip-setup", "Skip interactive configuration wizard").option("--docs-dir <name>", "Custom docs folder name (default: docs)").option("--plans-dir <name>", "Custom plans folder name (default: plans)").option("-y, --yes", "Non-interactive mode with sensible defaults (skip all prompts)").option("--sync", "Sync config files from upstream with interactive hunk-by-hunk merge").option("--use-git", "Use git clone instead of GitHub API (uses SSH/HTTPS credentials)").action(async (options) => {
+  cli.command("init", "Initialize or update ClaudeKit project (with interactive version selection)").option("--dir <dir>", "Target directory (default: .)").option("--kit <kit>", "Kit to use: engineer, marketing, all, or comma-separated").option("-r, --release <version>", "Skip version selection, use specific version (e.g., latest, v1.0.0)").option("--exclude <pattern>", "Exclude files matching glob pattern (can be used multiple times)").option("--only <pattern>", "Include only files matching glob pattern (can be used multiple times)").option("-g, --global", "Use platform-specific user configuration directory").option("--fresh", "Completely remove .claude directory before downloading (requires confirmation)").option("--install-skills", "Install skills dependencies (non-interactive mode)").option("--with-sudo", "Include system packages requiring sudo (Linux: ffmpeg, imagemagick)").option("--prefix", "Add /ck: prefix to all slash commands by moving them to commands/ck/ subdirectory").option("--beta", "Show beta versions in selection prompt").option("--refresh", "Bypass release cache to fetch latest versions from GitHub").option("--dry-run", "Preview changes without applying them (requires --prefix)").option("--force-overwrite", "Override ownership protections and delete user-modified files (requires --prefix)").option("--force-overwrite-settings", "Fully replace settings.json instead of selective merge (destroys user customizations)").option("--skip-setup", "Skip interactive configuration wizard").option("--docs-dir <name>", "Custom docs folder name (default: docs)").option("--plans-dir <name>", "Custom plans folder name (default: plans)").option("-y, --yes", "Non-interactive mode with sensible defaults (skip all prompts)").option("--sync", "Sync config files from upstream with interactive hunk-by-hunk merge").option("--use-git", "Use git clone instead of GitHub API (uses SSH/HTTPS credentials)").action(async (options) => {
     if (options.exclude && !Array.isArray(options.exclude)) {
       options.exclude = [options.exclude];
     }

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "claudekit-cli",
-	"version": "3.18.0",
+	"version": "3.20.0",
 	"description": "CLI tool for bootstrapping and updating ClaudeKit projects",
 	"type": "module",
 	"repository": {