@przeprogramowani/10x-cli 0.4.0 → 0.6.0

package/README.md

@@ -13,6 +13,26 @@ npm install -g @przeprogramowani/10x-cli
 # https://github.com/przeprogramowani/10x-cli/releases
 ```
 
+## Agentic Installation
+
+Let your AI coding agent handle the setup. This repo ships a [`10x-cli-setup`](skills/10x-cli-setup/SKILL.md) skill that walks your agent through installing, authenticating, and configuring the CLI — all driven by the latest README.
+
+Install the skill with [skills.sh](https://skills.sh):
+
+```bash
+# Add the skill to your current project (symlinked)
+npx skills add przeprogramowani/10x-cli
+
+# Or install globally so it's available in every project
+npx skills add przeprogramowani/10x-cli -g
+
+# Target a specific agent
+npx skills add przeprogramowani/10x-cli -a claude-code
+npx skills add przeprogramowani/10x-cli -a cursor
+```
+
+Once installed, just tell your agent to **set up 10x-cli** and it will pick up the skill automatically.
+
 ## Quick Start
 
 ```bash

package/dist/index.mjs

@@ -2271,7 +2271,7 @@ var cac = (name = "") => new CAC(name);
 // package.json
 var package_default = {
   name: "@przeprogramowani/10x-cli",
-  version: "0.4.0",
+  version: "0.6.0",
   description: "Open-source CLI for 10xDevs course content",
   repository: {
     type: "git",
@@ -2287,6 +2287,7 @@ var package_default = {
   },
   files: [
     "dist",
+    "skills",
     "README.md",
     "LICENSE"
   ],
@@ -2323,6 +2324,9 @@ var package_default = {
   }
 };
 
+// node_modules/@clack/prompts/dist/index.mjs
+import { stripVTControlCharacters as T2 } from "node:util";
+
 // node_modules/@clack/core/dist/index.mjs
 var import_sisteransi = __toESM(require_src(), 1);
 var import_picocolors = __toESM(require_picocolors(), 1);
@@ -2832,6 +2836,21 @@ ${import_picocolors2.default.cyan(m2)}
     }
   } }).prompt();
 };
+var ye = (s = "", n = "") => {
+  const t = `
+${s}
+`.split(`
+`), i = T2(n).length, r2 = Math.max(t.reduce((o, l2) => {
+    const $2 = T2(l2);
+    return $2.length > o ? $2.length : o;
+  }, 0), i) + 2, c2 = t.map((o) => `${import_picocolors2.default.gray(a)}  ${import_picocolors2.default.dim(o)}${" ".repeat(r2 - T2(o).length)}${import_picocolors2.default.gray(a)}`).join(`
+`);
+  process.stdout.write(`${import_picocolors2.default.gray(a)}
+${import_picocolors2.default.green(S2)}  ${import_picocolors2.default.reset(n)} ${import_picocolors2.default.gray(N2.repeat(Math.max(r2 - i - 1, 1)) + re)}
+${c2}
+${import_picocolors2.default.gray(ie + N2.repeat(r2 + 2) + ne)}
+`);
+};
 var ve = (s = "") => {
   process.stdout.write(`${import_picocolors2.default.gray(m2)}  ${import_picocolors2.default.red(s)}
 
@@ -2926,6 +2945,20 @@ function readAuth() {
     return null;
   }
 }
+function writeJsonAtomic(path, data, opts = {}) {
+  const tmp = `${path}.tmp`;
+  rmSync(tmp, { force: true });
+  const body = `${JSON.stringify(data, null, 2)}
+`;
+  const writeOpts = opts.mode !== undefined ? { mode: opts.mode } : undefined;
+  writeFileSync(tmp, body, writeOpts);
+  if (opts.mode !== undefined && process.platform !== "win32") {
+    try {
+      chmodSync(tmp, opts.mode);
+    } catch {}
+  }
+  renameSync(tmp, path);
+}
 function saveAuth(data) {
   const dir = configDir();
   if (!existsSync(dir)) {
@@ -2936,17 +2969,7 @@ function saveAuth(data) {
       chmodSync(dir, 448);
     } catch {}
   }
-  const file = authFilePath();
-  const tmp = `${file}.tmp`;
-  rmSync(tmp, { force: true });
-  writeFileSync(tmp, `${JSON.stringify(data, null, 2)}
-`, { mode: 384 });
-  if (process.platform !== "win32") {
-    try {
-      chmodSync(tmp, 384);
-    } catch {}
-  }
-  renameSync(tmp, file);
+  writeJsonAtomic(authFilePath(), data, { mode: 384 });
 }
 function deleteAuth() {
   const file = authFilePath();
@@ -2966,6 +2989,9 @@ function readToolConfig() {
     const parsed = JSON.parse(raw);
     if (typeof parsed.tool !== "string")
       return null;
+    if (parsed.acknowledgedOrphans !== undefined && (!Array.isArray(parsed.acknowledgedOrphans) || !parsed.acknowledgedOrphans.every((x2) => typeof x2 === "string"))) {
+      delete parsed.acknowledgedOrphans;
+    }
     return parsed;
   } catch {
     return null;
@@ -2976,9 +3002,7 @@ function saveToolConfig(config) {
   if (!existsSync(dir)) {
     mkdirSync(dir, { recursive: true, mode: 448 });
   }
-  const file = toolConfigPath();
-  writeFileSync(file, `${JSON.stringify(config, null, 2)}
-`);
+  writeJsonAtomic(toolConfigPath(), config);
 }
 
 // src/lib/api-client.ts
@@ -3916,7 +3940,71 @@ function parseModuleRef(raw) {
   return module;
 }
 
+// src/lib/tool-detect.ts
+import { existsSync as existsSync4 } from "node:fs";
+import { join as join4 } from "node:path";
+
+// src/lib/manifest.ts
+import { existsSync as existsSync3, mkdirSync as mkdirSync3, readFileSync as readFileSync2, writeFileSync as writeFileSync2 } from "node:fs";
+import { dirname as dirname2, join as join3 } from "node:path";
+var MANIFEST_FILENAME = ".10x-cli-manifest.json";
+var CLI_PACKAGE_NAME = "@przeprogramowani/10x-cli";
+function readManifest(dir) {
+  const manifestPath = join3(dir, MANIFEST_FILENAME);
+  if (!existsSync3(manifestPath))
+    return null;
+  let raw;
+  try {
+    raw = readFileSync2(manifestPath, "utf8");
+  } catch {
+    return null;
+  }
+  let parsed;
+  try {
+    parsed = JSON.parse(raw);
+  } catch {
+    return null;
+  }
+  if (!isManifest(parsed))
+    return null;
+  return parsed;
+}
+function writeManifest(dir, manifest) {
+  if (!existsSync3(dir)) {
+    mkdirSync3(dir, { recursive: true });
+  }
+  const manifestPath = join3(dir, MANIFEST_FILENAME);
+  mkdirSync3(dirname2(manifestPath), { recursive: true });
+  writeFileSync2(manifestPath, `${JSON.stringify(manifest, null, 2)}
+`);
+}
+function isManifest(value) {
+  if (typeof value !== "object" || value === null)
+    return false;
+  const v2 = value;
+  if (v2["package"] !== CLI_PACKAGE_NAME)
+    return false;
+  if (typeof v2["version"] !== "string")
+    return false;
+  if (typeof v2["lastApplied"] !== "string")
+    return false;
+  if (typeof v2["lessonId"] !== "string")
+    return false;
+  if (typeof v2["course"] !== "string")
+    return false;
+  const files = v2["files"];
+  if (typeof files !== "object" || files === null)
+    return false;
+  const f2 = files;
+  return isStringArray(f2["skills"]) && isStringArray(f2["prompts"]) && isStringArray(f2["configs"]);
+}
+function isStringArray(value) {
+  return Array.isArray(value) && value.every((item) => typeof item === "string");
+}
+
 // src/lib/tool-profile.ts
+var SENTINEL_BEGIN = "<!-- BEGIN @przeprogramowani/10x-cli -->";
+var SENTINEL_END = "<!-- END @przeprogramowani/10x-cli -->";
 var PROFILES = {
   "claude-code": {
     toolId: "claude-code",
@@ -3926,8 +4014,8 @@ var PROFILES = {
     configPath: (n) => `.claude/config-templates/${n}`,
     rulesFile: "CLAUDE.md",
     manifestDir: ".claude",
-    sentinelBegin: "<!-- BEGIN @przeprogramowani/10x-cli -->",
-    sentinelEnd: "<!-- END @przeprogramowani/10x-cli -->"
+    sentinelBegin: SENTINEL_BEGIN,
+    sentinelEnd: SENTINEL_END
   },
   cursor: {
     toolId: "cursor",
@@ -3937,8 +4025,8 @@ var PROFILES = {
     configPath: (n) => `.cursor/config-templates/${n}`,
     rulesFile: ".cursor/rules/10x-course.mdc",
     manifestDir: ".cursor",
-    sentinelBegin: "<!-- BEGIN @przeprogramowani/10x-cli -->",
-    sentinelEnd: "<!-- END @przeprogramowani/10x-cli -->"
+    sentinelBegin: SENTINEL_BEGIN,
+    sentinelEnd: SENTINEL_END
   },
   copilot: {
     toolId: "copilot",
@@ -3948,8 +4036,8 @@ var PROFILES = {
     configPath: (n) => `.github/config-templates/${n}`,
     rulesFile: ".github/copilot-instructions.md",
     manifestDir: ".github",
-    sentinelBegin: "<!-- BEGIN @przeprogramowani/10x-cli -->",
-    sentinelEnd: "<!-- END @przeprogramowani/10x-cli -->"
+    sentinelBegin: SENTINEL_BEGIN,
+    sentinelEnd: SENTINEL_END
   },
   codex: {
     toolId: "codex",
@@ -3959,8 +4047,8 @@ var PROFILES = {
     configPath: (n) => `.agents/config-templates/${n}`,
     rulesFile: "AGENTS.md",
     manifestDir: ".agents",
-    sentinelBegin: "<!-- BEGIN @przeprogramowani/10x-cli -->",
-    sentinelEnd: "<!-- END @przeprogramowani/10x-cli -->"
+    sentinelBegin: SENTINEL_BEGIN,
+    sentinelEnd: SENTINEL_END
   },
   generic: {
     toolId: "generic",
@@ -3970,116 +4058,143 @@ var PROFILES = {
     configPath: (n) => `.ai/config-templates/${n}`,
     rulesFile: "AGENTS.md",
     manifestDir: ".ai",
-    sentinelBegin: "<!-- BEGIN @przeprogramowani/10x-cli -->",
-    sentinelEnd: "<!-- END @przeprogramowani/10x-cli -->"
+    sentinelBegin: SENTINEL_BEGIN,
+    sentinelEnd: SENTINEL_END
   }
 };
 var DEFAULT_TOOL = "claude-code";
 
-// src/lib/tool-prompt.ts
-async function resolveToolProfile(flagOverride) {
-  if (flagOverride) {
-    const profile = PROFILES[flagOverride];
-    if (!profile) {
-      throw new Error(`Unknown tool '${flagOverride}'. Supported: ${Object.keys(PROFILES).join(", ")}`);
-    }
-    return profile;
-  }
-  const config = readToolConfig();
-  if (config?.tool && PROFILES[config.tool]) {
-    return PROFILES[config.tool];
+// src/lib/tool-detect.ts
+function detectTools(projectRoot) {
+  const hit = (rel) => existsSync4(join4(projectRoot, rel));
+  const signals = [];
+  if (hit(".claude/" + MANIFEST_FILENAME)) {
+    signals.push({
+      profileId: "claude-code",
+      confidence: "strong",
+      reason: ".claude/.10x-cli-manifest.json"
+    });
+  } else if (hit(".claude")) {
+    signals.push({ profileId: "claude-code", confidence: "medium", reason: ".claude/ directory" });
+  } else if (hit("CLAUDE.md")) {
+    signals.push({ profileId: "claude-code", confidence: "weak", reason: "CLAUDE.md" });
+  }
+  if (hit(".cursor/" + MANIFEST_FILENAME)) {
+    signals.push({
+      profileId: "cursor",
+      confidence: "strong",
+      reason: ".cursor/.10x-cli-manifest.json"
+    });
+  } else if (hit(".cursor/rules")) {
+    signals.push({ profileId: "cursor", confidence: "strong", reason: ".cursor/rules/" });
+  } else if (hit(".cursor")) {
+    signals.push({ profileId: "cursor", confidence: "medium", reason: ".cursor/ directory" });
+  }
+  if (hit(".github/" + MANIFEST_FILENAME)) {
+    signals.push({
+      profileId: "copilot",
+      confidence: "strong",
+      reason: ".github/.10x-cli-manifest.json"
+    });
+  } else if (hit(".github/copilot-instructions.md")) {
+    signals.push({
+      profileId: "copilot",
+      confidence: "strong",
+      reason: ".github/copilot-instructions.md"
+    });
+  } else if (hit(".github/skills") || hit(".github/prompts")) {
+    signals.push({
+      profileId: "copilot",
+      confidence: "medium",
+      reason: ".github/skills/ or .github/prompts/"
+    });
   }
-  if (process.stdout.isTTY) {
-    const choice = await de({
-      message: "Which AI coding tool do you use?",
-      options: Object.values(PROFILES).map((profile) => ({
-        value: profile.toolId,
-        label: profile.displayName,
-        hint: profile.toolId === DEFAULT_TOOL ? "default" : undefined
-      })),
-      initialValue: DEFAULT_TOOL
+  if (hit(".agents/" + MANIFEST_FILENAME)) {
+    signals.push({
+      profileId: "codex",
+      confidence: "strong",
+      reason: ".agents/.10x-cli-manifest.json"
     });
-    if (BD(choice)) {
-      ve("Using default (Claude Code).");
-      return PROFILES[DEFAULT_TOOL];
-    }
-    saveToolConfig({ tool: choice });
-    return PROFILES[choice];
+  } else if (hit(".agents")) {
+    signals.push({ profileId: "codex", confidence: "strong", reason: ".agents/ directory" });
+  } else if (hit("AGENTS.md") && !hit(".ai")) {
+    signals.push({ profileId: "codex", confidence: "medium", reason: "AGENTS.md" });
+  }
+  if (hit(".ai/" + MANIFEST_FILENAME)) {
+    signals.push({
+      profileId: "generic",
+      confidence: "strong",
+      reason: ".ai/.10x-cli-manifest.json"
+    });
+  } else if (hit(".ai")) {
+    signals.push({ profileId: "generic", confidence: "strong", reason: ".ai/ directory" });
+  } else if (hit("AGENTS.md") && !hit(".agents")) {
+    signals.push({ profileId: "generic", confidence: "weak", reason: "AGENTS.md (generic fallback)" });
   }
-  return PROFILES[DEFAULT_TOOL];
+  return rankSignals(signals);
+}
+var CONFIDENCE_ORDER = { strong: 3, medium: 2, weak: 1 };
+var PROFILE_ORDER = ["claude-code", "cursor", "copilot", "codex", "generic"];
+function rankSignals(signals) {
+  return [...signals].sort((a2, b2) => {
+    const c2 = CONFIDENCE_ORDER[b2.confidence] - CONFIDENCE_ORDER[a2.confidence];
+    if (c2 !== 0)
+      return c2;
+    return PROFILE_ORDER.indexOf(a2.profileId) - PROFILE_ORDER.indexOf(b2.profileId);
+  });
+}
+function topDetectedProfile(signals) {
+  const top = signals[0];
+  if (!top)
+    return null;
+  return PROFILES[top.profileId] ?? null;
 }
 
-// src/lib/writer.ts
+// src/lib/tool-switch.ts
 import {
-  existsSync as existsSync4,
-  mkdirSync as mkdirSync4,
-  readFileSync as readFileSync3,
-  rmSync as rmSync2,
-  writeFileSync as writeFileSync3
+  existsSync as existsSync6,
+  lstatSync,
+  mkdirSync as mkdirSync5,
+  readFileSync as readFileSync5,
+  renameSync as renameSync2,
+  rmdirSync,
+  rmSync as rmSync3,
+  statSync,
+  writeFileSync as writeFileSync4
 } from "node:fs";
-import { dirname as dirname3, join as join4 } from "node:path";
+import { dirname as dirname4, join as join6 } from "node:path";
 
-// src/lib/manifest.ts
-import { existsSync as existsSync3, mkdirSync as mkdirSync3, readFileSync as readFileSync2, writeFileSync as writeFileSync2 } from "node:fs";
-import { dirname as dirname2, join as join3 } from "node:path";
-var MANIFEST_FILENAME = ".10x-cli-manifest.json";
-var CLI_PACKAGE_NAME = "@przeprogramowani/10x-cli";
-function readManifest(dir) {
-  const manifestPath = join3(dir, MANIFEST_FILENAME);
-  if (!existsSync3(manifestPath))
-    return null;
-  let raw;
+// src/lib/fs-utils.ts
+import { readFileSync as readFileSync3 } from "node:fs";
+function readFileOrNull(path) {
   try {
-    raw = readFileSync2(manifestPath, "utf8");
+    return readFileSync3(path, "utf8");
   } catch {
     return null;
   }
-  let parsed;
-  try {
-    parsed = JSON.parse(raw);
-  } catch {
-    return null;
-  }
-  if (!isManifest(parsed))
-    return null;
-  return parsed;
-}
-function writeManifest(dir, manifest) {
-  if (!existsSync3(dir)) {
-    mkdirSync3(dir, { recursive: true });
-  }
-  const manifestPath = join3(dir, MANIFEST_FILENAME);
-  mkdirSync3(dirname2(manifestPath), { recursive: true });
-  writeFileSync2(manifestPath, `${JSON.stringify(manifest, null, 2)}
-`);
-}
-function isManifest(value) {
-  if (typeof value !== "object" || value === null)
-    return false;
-  const v2 = value;
-  if (v2["package"] !== CLI_PACKAGE_NAME)
-    return false;
-  if (typeof v2["version"] !== "string")
-    return false;
-  if (typeof v2["lastApplied"] !== "string")
-    return false;
-  if (typeof v2["lessonId"] !== "string")
-    return false;
-  if (typeof v2["course"] !== "string")
-    return false;
-  const files = v2["files"];
-  if (typeof files !== "object" || files === null)
-    return false;
-  const f2 = files;
-  return isStringArray(f2["skills"]) && isStringArray(f2["prompts"]) && isStringArray(f2["configs"]);
-}
-function isStringArray(value) {
-  return Array.isArray(value) && value.every((item) => typeof item === "string");
 }
 
 // src/lib/sentinel-migration.ts
 var OLD_BEGIN = "<!-- BEGIN @przeprogramowani/10x-toolkit -->";
 var OLD_END = "<!-- END @przeprogramowani/10x-toolkit -->";
+function removeRulesBlockWithMarkers(existing, begin, end) {
+  const beginIdx = existing.indexOf(begin);
+  const endIdx = existing.indexOf(end);
+  if (beginIdx === -1 || endIdx === -1 || endIdx < beginIdx) {
+    return { content: existing, removed: false };
+  }
+  const beforeRaw = existing.slice(0, beginIdx);
+  const afterRaw = existing.slice(endIdx + end.length);
+  const before = beforeRaw.replace(/[\r\n]*$/, "");
+  const after = afterRaw.replace(/^[\r\n]*/, "");
+  const joiner = before.length > 0 && after.length > 0 ? `
+
+` : "";
+  const combined = before + joiner + after;
+  const content = combined.length === 0 ? "" : combined.replace(/[\r\n]*$/, `
+`);
+  return { content, removed: true };
+}
 function applyRulesBlockWithMarkers(existingContent, rulesBody, beginMarker, endMarker) {
   for (const marker of [OLD_BEGIN, OLD_END, beginMarker, endMarker]) {
     if (rulesBody.includes(marker)) {
@@ -4127,6 +4242,14 @@ function stripBlock(content, begin, end, label, warnings) {
 }
 
 // src/lib/writer.ts
+import {
+  existsSync as existsSync5,
+  mkdirSync as mkdirSync4,
+  readFileSync as readFileSync4,
+  rmSync as rmSync2,
+  writeFileSync as writeFileSync3
+} from "node:fs";
+import { dirname as dirname3, join as join5 } from "node:path";
 var CLI_VERSION = package_default.version;
 var DEFAULT_COURSE = "10xdevs3";
 function applyBundle(bundle, projectRoot, options = {}) {
@@ -4134,7 +4257,7 @@ function applyBundle(bundle, projectRoot, options = {}) {
   const partial = options.partial === true;
   const course = options.course ?? DEFAULT_COURSE;
   const profile = options.profile ?? PROFILES[DEFAULT_TOOL];
-  const manifestDir = join4(projectRoot, profile.manifestDir);
+  const manifestDir = join5(projectRoot, profile.manifestDir);
   const prevManifest = readManifest(manifestDir);
   for (const skill of bundle.skills)
     assertSafeName(skill.name, "skill");
@@ -4143,7 +4266,7 @@ function applyBundle(bundle, projectRoot, options = {}) {
   for (const config of bundle.configs)
     assertSafeName(config.name, "config");
   const skills = bundle.skills.map((skill) => {
-    const target = join4(projectRoot, profile.skillPath(skill.name));
+    const target = join5(projectRoot, profile.skillPath(skill.name));
     const action = computeFileAction(target, skill.content);
     if (!dryRun && action !== "unchanged") {
       writeFileAt(target, skill.content);
@@ -4151,14 +4274,14 @@ function applyBundle(bundle, projectRoot, options = {}) {
     return { name: skill.name, path: target, action };
   });
   const prompts = bundle.prompts.map((prompt) => {
-    const target = join4(projectRoot, profile.promptPath(prompt.name));
+    const target = join5(projectRoot, profile.promptPath(prompt.name));
     const action = computeFileAction(target, prompt.content);
     if (!dryRun && action !== "unchanged") {
       writeFileAt(target, prompt.content);
     }
     return { name: prompt.name, path: target, action };
   });
-  const rulesFilePath = join4(projectRoot, profile.rulesFile);
+  const rulesFilePath = join5(projectRoot, profile.rulesFile);
   const existingRules = readFileOrEmpty(rulesFilePath);
   let rulesAction;
   if (bundle.rules.length === 0) {
@@ -4180,8 +4303,8 @@ function applyBundle(bundle, projectRoot, options = {}) {
     }
   }
   const configs = bundle.configs.map((config) => {
-    const target = join4(projectRoot, profile.configPath(config.name));
-    const action = existsSync4(target) ? "skipped" : "created";
+    const target = join5(projectRoot, profile.configPath(config.name));
+    const action = existsSync5(target) ? "skipped" : "created";
     if (!dryRun && action === "created") {
       writeFileAt(target, config.content);
     }
@@ -4220,21 +4343,21 @@ function applyBundle(bundle, projectRoot, options = {}) {
   };
 }
 function computeFileAction(filePath, newContent) {
-  if (!existsSync4(filePath))
+  if (!existsSync5(filePath))
     return "created";
   let current;
   try {
-    current = readFileSync3(filePath, "utf8");
+    current = readFileSync4(filePath, "utf8");
   } catch {
     return "updated";
   }
   return current === newContent ? "unchanged" : "updated";
 }
 function readFileOrEmpty(filePath) {
-  if (!existsSync4(filePath))
+  if (!existsSync5(filePath))
     return "";
   try {
-    return readFileSync3(filePath, "utf8");
+    return readFileSync4(filePath, "utf8");
   } catch {
     return "";
   }
@@ -4256,7 +4379,7 @@ function computeRemovals(prevManifest, bundle, profile, projectRoot) {
       continue;
     if (!isSafeName(skillName))
       continue;
-    const skillTarget = join4(projectRoot, profile.skillPath(skillName));
+    const skillTarget = join5(projectRoot, profile.skillPath(skillName));
     removed.skills.push({ name: skillName, path: dirname3(skillTarget) });
   }
   for (const promptFile of prevManifest.files.prompts) {
@@ -4267,7 +4390,7 @@ function computeRemovals(prevManifest, bundle, profile, projectRoot) {
     const promptName = promptFile.replace(/\.md$/, "");
     removed.prompts.push({
       name: promptFile,
-      path: join4(projectRoot, profile.promptPath(promptName))
+      path: join5(projectRoot, profile.promptPath(promptName))
     });
   }
   for (const configFile of prevManifest.files.configs) {
@@ -4277,23 +4400,33 @@ function computeRemovals(prevManifest, bundle, profile, projectRoot) {
       continue;
     removed.configs.push({
       name: configFile,
-      path: join4(projectRoot, profile.configPath(configFile))
+      path: join5(projectRoot, profile.configPath(configFile))
     });
   }
   return removed;
 }
-function detectOrphanedArtifacts(projectRoot, currentProfile) {
+function findOrphanedManifests(projectRoot, currentProfile) {
+  const out = [];
   for (const profile of Object.values(PROFILES)) {
     if (profile.toolId === currentProfile.toolId)
       continue;
-    const otherManifest = join4(projectRoot, profile.manifestDir, MANIFEST_FILENAME);
-    if (existsSync4(otherManifest)) {
-      return `Found existing 10x artifacts in ${profile.manifestDir}/ from ${profile.displayName}.
-  Manually remove ${profile.manifestDir}/ if you no longer need it.
-  Your new artifacts will be written to ${currentProfile.manifestDir}/`;
-    }
+    const manifestPath = join5(projectRoot, profile.manifestDir, MANIFEST_FILENAME);
+    if (!existsSync5(manifestPath))
+      continue;
+    const manifest = readManifest(join5(projectRoot, profile.manifestDir));
+    if (!manifest)
+      continue;
+    out.push({ profile, manifestPath, manifest });
   }
-  return null;
+  return out;
+}
+function detectOrphanedArtifacts(projectRoot, currentProfile) {
+  const first = findOrphanedManifests(projectRoot, currentProfile)[0];
+  if (!first)
+    return null;
+  return `Found existing 10x artifacts in ${first.profile.manifestDir}/ from ${first.profile.displayName}.
+  Manually remove ${first.profile.manifestDir}/ if you no longer need it.
+  Your new artifacts will be written to ${currentProfile.manifestDir}/`;
 }
 function assertSafeName(name, kind) {
   if (!isSafeName(name)) {
@@ -4321,6 +4454,296 @@ function isSafeName(name) {
   return true;
 }
 
+// src/lib/tool-switch.ts
+function migrateArtifacts(projectRoot, orphan, newProfile) {
+  const summary = {
+    action: "migrated",
+    oldToolId: orphan.profile.toolId,
+    movedOrRemoved: { skills: [], prompts: [], configs: [] },
+    sentinelStripped: false,
+    skipped: []
+  };
+  const oldProfile = orphan.profile;
+  for (const skillName of orphan.manifest.files.skills) {
+    if (!isSafeName(skillName)) {
+      summary.skipped.push({ path: skillName, reason: "unsafe name in manifest" });
+      continue;
+    }
+    const from = join6(projectRoot, oldProfile.skillPath(skillName));
+    const to = join6(projectRoot, newProfile.skillPath(skillName));
+    if (moveIfSafe(from, to, summary.skipped)) {
+      summary.movedOrRemoved.skills.push(skillName);
+    }
+  }
+  for (const promptFile of orphan.manifest.files.prompts) {
+    if (!isSafeName(promptFile)) {
+      summary.skipped.push({ path: promptFile, reason: "unsafe name in manifest" });
+      continue;
+    }
+    const promptName = promptFile.replace(/\.md$/, "");
+    const from = join6(projectRoot, oldProfile.promptPath(promptName));
+    const to = join6(projectRoot, newProfile.promptPath(promptName));
+    if (moveIfSafe(from, to, summary.skipped)) {
+      summary.movedOrRemoved.prompts.push(promptFile);
+    }
+  }
+  for (const configFile of orphan.manifest.files.configs) {
+    if (!isSafeName(configFile)) {
+      summary.skipped.push({ path: configFile, reason: "unsafe name in manifest" });
+      continue;
+    }
+    const from = join6(projectRoot, oldProfile.configPath(configFile));
+    const to = join6(projectRoot, newProfile.configPath(configFile));
+    if (moveIfSafe(from, to, summary.skipped)) {
+      summary.movedOrRemoved.configs.push(configFile);
+    }
+  }
+  summary.sentinelStripped = stripSentinelFromRulesFile(projectRoot, oldProfile);
+  rmSync3(orphan.manifestPath, { force: true });
+  tryRemoveEmptyDir(join6(projectRoot, oldProfile.manifestDir));
+  return summary;
+}
+function deleteArtifacts(projectRoot, orphan) {
+  const summary = {
+    action: "deleted",
+    oldToolId: orphan.profile.toolId,
+    movedOrRemoved: { skills: [], prompts: [], configs: [] },
+    sentinelStripped: false,
+    skipped: []
+  };
+  const oldProfile = orphan.profile;
+  for (const skillName of orphan.manifest.files.skills) {
+    if (!isSafeName(skillName)) {
+      summary.skipped.push({ path: skillName, reason: "unsafe name in manifest" });
+      continue;
+    }
+    const skillFile = join6(projectRoot, oldProfile.skillPath(skillName));
+    const skillDir = dirname4(skillFile);
+    rmSync3(skillFile, { force: true });
+    tryRemoveEmptyDir(skillDir);
+    summary.movedOrRemoved.skills.push(skillName);
+  }
+  for (const promptFile of orphan.manifest.files.prompts) {
+    if (!isSafeName(promptFile)) {
+      summary.skipped.push({ path: promptFile, reason: "unsafe name in manifest" });
+      continue;
+    }
+    const promptName = promptFile.replace(/\.md$/, "");
+    rmSync3(join6(projectRoot, oldProfile.promptPath(promptName)), { force: true });
+    summary.movedOrRemoved.prompts.push(promptFile);
+  }
+  for (const configFile of orphan.manifest.files.configs) {
+    if (!isSafeName(configFile)) {
+      summary.skipped.push({ path: configFile, reason: "unsafe name in manifest" });
+      continue;
+    }
+    rmSync3(join6(projectRoot, oldProfile.configPath(configFile)), { force: true });
+    summary.movedOrRemoved.configs.push(configFile);
+  }
+  summary.sentinelStripped = stripSentinelFromRulesFile(projectRoot, oldProfile);
+  rmSync3(orphan.manifestPath, { force: true });
+  const manifestDirAbs = join6(projectRoot, oldProfile.manifestDir);
+  tryRemoveEmptyDir(join6(manifestDirAbs, "skills"));
+  tryRemoveEmptyDir(join6(manifestDirAbs, "prompts"));
+  tryRemoveEmptyDir(join6(manifestDirAbs, "config-templates"));
+  tryRemoveEmptyDir(manifestDirAbs);
+  return summary;
+}
+function moveIfSafe(from, to, skipped) {
+  if (!existsSync6(from)) {
+    return false;
+  }
+  if (lstatSync(from).isSymbolicLink()) {
+    skipped.push({ path: from, reason: "source is a symlink" });
+    return false;
+  }
+  if (existsSync6(to)) {
+    if (!filesAreIdentical(from, to)) {
+      skipped.push({
+        path: to,
+        reason: "destination already exists with different content"
+      });
+      return false;
+    }
+    rmSync3(from, { force: true });
+    return true;
+  }
+  mkdirSync5(dirname4(to), { recursive: true });
+  try {
+    renameSync2(from, to);
+  } catch (err) {
+    const code = err?.code;
+    if (code !== "EXDEV")
+      throw err;
+    const bytes = readFileSync5(from);
+    const tmp = `${to}.tmp`;
+    writeFileSync4(tmp, bytes);
+    renameSync2(tmp, to);
+    try {
+      rmSync3(from, { force: true });
+    } catch {
+      skipped.push({
+        path: from,
+        reason: "copied to destination but could not remove source"
+      });
+      return true;
+    }
+  }
+  return true;
+}
+function stripSentinelFromRulesFile(projectRoot, oldProfile) {
+  const rulesPath = join6(projectRoot, oldProfile.rulesFile);
+  if (!existsSync6(rulesPath))
+    return false;
+  const existing = readFileOrNull(rulesPath);
+  if (existing === null)
+    return false;
+  const { content, removed } = removeRulesBlockWithMarkers(existing, oldProfile.sentinelBegin, oldProfile.sentinelEnd);
+  if (!removed)
+    return false;
+  if (content.trim().length === 0) {
+    rmSync3(rulesPath, { force: true });
+  } else {
+    writeFileSync4(rulesPath, content);
+  }
+  return true;
+}
+function filesAreIdentical(a2, b2) {
+  try {
+    const aStat = statSync(a2);
+    const bStat = statSync(b2);
+    if (aStat.size !== bStat.size)
+      return false;
+    return readFileSync5(a2).equals(readFileSync5(b2));
+  } catch {
+    return false;
+  }
+}
+function tryRemoveEmptyDir(dir) {
+  if (!existsSync6(dir))
+    return;
+  try {
+    rmdirSync(dir);
+  } catch {}
+}
+
+// src/lib/tool-prompt.ts
+async function resolveToolProfile(flagOverride, projectRoot = process.cwd()) {
+  const profile = await resolveProfileOnly(flagOverride, projectRoot);
+  await handleToolSwitch(projectRoot, profile);
+  return profile;
+}
+async function resolveProfileOnly(flagOverride, projectRoot) {
+  if (flagOverride) {
+    const profile = PROFILES[flagOverride];
+    if (!profile) {
+      throw new Error(`Unknown tool '${flagOverride}'. Supported: ${Object.keys(PROFILES).join(", ")}`);
+    }
+    return profile;
+  }
+  const config = readToolConfig();
+  if (config?.tool && PROFILES[config.tool]) {
+    return PROFILES[config.tool];
+  }
+  if (process.stdout.isTTY) {
+    const signals = detectTools(projectRoot);
+    const detected = topDetectedProfile(signals);
+    const top = signals[0];
+    if (top && detected) {
+      ye(`Detected: ${detected.displayName} (${top.reason})`);
+    }
+    const initial = detected?.toolId ?? DEFAULT_TOOL;
+    const choice = await de({
+      message: "Which AI coding tool do you use?",
+      options: Object.values(PROFILES).map((profile) => ({
+        value: profile.toolId,
+        label: profile.displayName,
+        hint: profile.toolId === initial ? "default" : undefined
+      })),
+      initialValue: initial
+    });
+    if (BD(choice)) {
+      ve("Using default (Claude Code).");
+      return PROFILES[DEFAULT_TOOL];
+    }
+    saveToolConfig({ ...config ?? {}, tool: choice });
+    return PROFILES[choice];
+  }
+  return PROFILES[DEFAULT_TOOL];
+}
+async function handleToolSwitch(projectRoot, newProfile) {
+  if (!process.stdout.isTTY)
+    return;
+  const cfg = readToolConfig();
+  const acknowledged = new Set(cfg?.acknowledgedOrphans ?? []);
+  const orphans = findOrphanedManifests(projectRoot, newProfile).filter((o) => !acknowledged.has(o.profile.toolId));
+  if (orphans.length === 0)
+    return;
+  for (const orphan of orphans) {
+    const action = await de({
+      message: `Found 10x artifacts from ${orphan.profile.displayName} in ${orphan.profile.manifestDir}/. What should we do?`,
+      options: [
+        {
+          value: "migrate",
+          label: `Migrate to ${newProfile.manifestDir}/`,
+          hint: "recommended"
+        },
+        {
+          value: "delete",
+          label: `Remove 10x artifacts from ${orphan.profile.manifestDir}/`
+        },
+        { value: "keep", label: "Keep both (don't ask again)" }
+      ],
+      initialValue: "migrate"
+    });
+    if (BD(action))
+      continue;
+    if (action === "migrate") {
+      const summary = migrateArtifacts(projectRoot, orphan, newProfile);
+      printMigrationSummary(summary, newProfile);
+    } else if (action === "delete") {
+      const summary = deleteArtifacts(projectRoot, orphan);
+      printMigrationSummary(summary, newProfile);
+    } else {
+      const existing = readToolConfig();
+      const nextAcks = [
+        ...existing?.acknowledgedOrphans ?? [],
+        orphan.profile.toolId
+      ];
+      saveToolConfig({
+        ...existing ?? {},
+        tool: existing?.tool ?? newProfile.toolId,
+        acknowledgedOrphans: nextAcks
+      });
+    }
+  }
+}
+function printMigrationSummary(summary, newProfile) {
+  const { skills, prompts, configs } = summary.movedOrRemoved;
+  const verb = summary.action === "migrated" ? "Moved" : "Removed";
+  const target = summary.action === "migrated" ? `to ${newProfile.manifestDir}/` : "";
+  const parts = [];
+  if (skills.length)
+    parts.push(`${skills.length} skill${skills.length === 1 ? "" : "s"}`);
+  if (prompts.length)
+    parts.push(`${prompts.length} prompt${prompts.length === 1 ? "" : "s"}`);
+  if (configs.length)
+    parts.push(`${configs.length} config${configs.length === 1 ? "" : "s"}`);
+  const lines = [];
+  if (parts.length > 0) {
+    lines.push(`${verb} ${parts.join(", ")}${target ? " " + target : ""}.`);
+  }
+  if (summary.sentinelStripped) {
+    lines.push(`Removed 10x block from the old rules file.`);
+  }
+  for (const s of summary.skipped) {
+    lines.push(`Skipped ${s.path} (${s.reason}).`);
+  }
+  if (lines.length > 0)
+    ye(lines.join(`
+`));
+}
+
 // src/commands/get.ts
 var ARTIFACT_TYPES = ["skills", "prompts", "rules", "configs"];
 function isArtifactType(s) {
@@ -4350,7 +4773,7 @@ async function runGet(ctx, ref, options) {
   }
   const auth = await requireAuth(ctx);
   const course = options.course ?? DEFAULT_COURSE2;
-  const profile = await resolveToolProfile(options.tool);
+  const profile = await resolveToolProfile(options.tool, process.cwd());
   const lang = options.lang ?? readToolConfig()?.lang ?? "en";
   if (options.lang) {
     const existing = readToolConfig();
@@ -4370,9 +4793,11 @@ async function runGet(ctx, ref, options) {
   if (isFallback && contentLang) {
     verbose(ctx, `${lang.toUpperCase()} not available for ${parsed.lessonId}, showing ${contentLang.toUpperCase()}.`);
   }
-  const orphanWarning = detectOrphanedArtifacts(process.cwd(), profile);
-  if (orphanWarning)
-    verbose(ctx, orphanWarning);
+  if (!process.stdout.isTTY) {
+    const orphanWarning = detectOrphanedArtifacts(process.cwd(), profile);
+    if (orphanWarning)
+      verbose(ctx, orphanWarning);
+  }
   const isFiltered = options.type !== undefined;
   const bundle = filterBundle(ctx, result.data, options);
   const writeResult = applyBundle(bundle, process.cwd(), {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@przeprogramowani/10x-cli",
-  "version": "0.4.0",
+  "version": "0.6.0",
   "description": "Open-source CLI for 10xDevs course content",
   "repository": {
     "type": "git",
@@ -16,6 +16,7 @@
   },
   "files": [
     "dist",
+    "skills",
     "README.md",
     "LICENSE"
   ],

package/skills/10x-cli-setup/SKILL.md

@@ -0,0 +1,53 @@
+---
+name: 10x-cli-setup
+description: ALWAYS invoke this skill when the user mentions 10x-cli, @przeprogramowani/10x-cli, the 10xDevs CLI, or the 10xDevs course environment in a setup context. This skill fetches the live README — Claude does not know 10x-cli's current install steps without it. Applies to: installing, updating, reconfiguring for different AI tools (Cursor, Copilot, Claude Code), permission/npm errors, authentication, and onboarding after 10xDevs enrollment. Excludes: developing 10x-cli source code, contributing to the repo, building similar CLIs, or general project setup.
+---
+
+# 10x-cli Setup
+
+This skill sets up the `@przeprogramowani/10x-cli` on the user's machine. The core principle is simple: **the README is the single source of truth**. The CLI evolves — version requirements change, new install methods appear, commands get updated. Rather than hardcoding any of that here, this skill tells you *how to work*, and the README tells you *what to do*.
+
+## Step 1: Check if the CLI is already installed
+
+Before anything else, check the current state:
+
+```bash
+10x --version 2>/dev/null || echo "NOT_INSTALLED"
+```
+
+- If a version is printed, the CLI is already installed. Tell the user and ask if they want to update, reconfigure, or troubleshoot.
+- If not installed, proceed to Step 2.
+
+This avoids wasting time on prerequisites when the user might just need a config change or re-auth.
+
+## Step 2: Fetch the latest README
+
+Retrieve the current README from GitHub — this is the authoritative source for all install steps, prerequisites, commands, and tool configurations:
+
+```
+URL: https://raw.githubusercontent.com/przeprogramowani/10x-cli/refs/heads/master/README.md
+```
+
+Use WebFetch or `curl -sL` to get it. If the fetch fails, tell the user and stop — don't guess at install steps from memory, because they may be outdated.
+
+## Step 3: Build a plan from the README and execute it
+
+Read the fetched README and construct a step-by-step setup plan from it. The README contains everything needed: prerequisites, install commands, auth flow, available commands, and tool-specific configuration. Your job is to translate the README into actionable steps for the user's specific situation.
+
+The general flow from the README is:
+1. **Prerequisites** — whatever the README says is required (runtime version, package manager, etc.). Check each one and stop if something is missing.
+2. **Install** — use the install method described in the README. Verify it worked.
+3. **Authenticate** — the README describes the auth command and flow. Note: auth is interactive (magic-link email), so the user may need to run it themselves via `! 10x auth` if the shell doesn't support input.
+4. **Verify** — the README lists a diagnostic command. Run it and review the output with the user.
+5. **Explore** — show the user how to browse and fetch content using the commands from the README.
+6. **Tool configuration** — if the user mentioned a specific AI tool (Claude Code, Cursor, etc.), use the README's multi-tool support section to configure it. If not, explain the options and let them choose.
+
+Do not hardcode specific version numbers, command flags, or directory paths — read them from the README. This way the skill stays correct even when the CLI changes.
+
+## Important principles
+
+- **README over memory.** If you think you know a command or requirement, but the fetched README says something different, follow the README. Always.
+- **Check before installing.** Step 1 exists for a reason — don't reinstall what's already there.
+- **Be interactive.** Confirm with the user before installing global packages or modifying their system. Ask before running `sudo`.
+- **Diagnose before fixing.** If something fails, read the error and the README's guidance before suggesting a fix. Don't just retry blindly.
+- **Stay focused on end-user setup.** This skill is about installing and configuring the published CLI package, not about development/contributing workflows.