@rely-ai/caliber 1.4.1 → 1.5.0

package/dist/bin.js

@@ -51,17 +51,17 @@ var init_constants = __esm({
 
 // src/cli.ts
 import { Command } from "commander";
-import fs27 from "fs";
+import fs28 from "fs";
 import path22 from "path";
 import { fileURLToPath } from "url";
 
 // src/commands/onboard.ts
-import chalk5 from "chalk";
-import ora2 from "ora";
+import chalk7 from "chalk";
+import ora3 from "ora";
 import readline4 from "readline";
-import select2 from "@inquirer/select";
+import select4 from "@inquirer/select";
 import checkbox from "@inquirer/checkbox";
-import fs20 from "fs";
+import fs22 from "fs";
 
 // src/fingerprint/index.ts
 import fs6 from "fs";
@@ -1242,11 +1242,23 @@ AgentSetup schema:
 
 Do NOT generate mcpServers \u2014 MCP configuration is managed separately.
 
-All skills follow the OpenSkills standard (agentskills.io):
-- The "name" field must be kebab-case (lowercase letters, numbers, hyphens only). It becomes the directory name.
-- The "description" field should describe what the skill does AND when to use it \u2014 this drives automatic skill discovery by agents.
-- The "content" field is the markdown body only \u2014 do NOT include YAML frontmatter in the content, it will be generated from the name and description fields.
-- Keep skill content under 500 lines. Move detailed references to separate files if needed.
+All skills follow the OpenSkills standard (agentskills.io). Anthropic's official skill guide defines three levels of progressive disclosure:
+- Level 1 (YAML frontmatter): Always loaded. Must have enough info for the agent to decide when to activate the skill.
+- Level 2 (SKILL.md body): Loaded when the skill is relevant. Contains full instructions.
+- Level 3 (references/): Only loaded on demand for deep detail.
+
+Skill field requirements:
+- "name": kebab-case (lowercase letters, numbers, hyphens only). Becomes the directory name.
+- "description": MUST include WHAT it does + WHEN to use it with specific trigger phrases. Example: "Manages database migrations. Use when user says 'run migration', 'create migration', 'db schema change', or modifies files in db/migrations/."
+- "content": markdown body only \u2014 do NOT include YAML frontmatter, it is generated from name+description.
+
+Skill content structure \u2014 follow this template:
+1. A heading with the skill name
+2. "## Instructions" \u2014 clear, numbered steps. Be specific: include exact commands, file paths, parameter names.
+3. "## Examples" \u2014 at least one example showing: User says \u2192 Actions taken \u2192 Result
+4. "## Troubleshooting" (optional) \u2014 common errors and how to fix them
+
+Keep skill content under 200 lines. Focus on actionable instructions, not documentation prose.
 
 The "fileDescriptions" object MUST include a one-liner for every file that will be created or modified. Use actual file paths as keys (e.g. "CLAUDE.md", "AGENTS.md", ".claude/skills/my-skill/SKILL.md", ".agents/skills/my-skill/SKILL.md", ".cursor/skills/my-skill/SKILL.md", ".cursor/rules/my-rule.mdc"). Each description should explain why the change is needed, be concise and lowercase.
 
@@ -2163,6 +2175,12 @@ function cleanupStaging() {
   }
 }
 
+// src/utils/review.ts
+import chalk from "chalk";
+import fs14 from "fs";
+import select from "@inquirer/select";
+import { createTwoFilesPatch } from "diff";
+
 // src/utils/editor.ts
 import { execSync as execSync4, spawn as spawn3 } from "child_process";
 function commandExists(cmd) {
@@ -2201,11 +2219,206 @@ function openDiffsInEditor(editor, files) {
   }
 }
 
-// src/commands/onboard.ts
-import { createTwoFilesPatch } from "diff";
+// src/utils/review.ts
+async function promptWantsReview() {
+  return select({
+    message: "Would you like to review the diffs before deciding?",
+    choices: [
+      { name: "Yes, show me the diffs", value: true },
+      { name: "No, continue", value: false }
+    ]
+  });
+}
+async function promptReviewMethod() {
+  const available = detectAvailableEditors();
+  if (available.length === 1) return "terminal";
+  const choices = available.map((method) => {
+    switch (method) {
+      case "cursor":
+        return { name: "Cursor (diff view)", value: "cursor" };
+      case "vscode":
+        return { name: "VS Code (diff view)", value: "vscode" };
+      case "terminal":
+        return { name: "Terminal", value: "terminal" };
+    }
+  });
+  return select({ message: "How would you like to review the changes?", choices });
+}
+async function openReview(method, stagedFiles) {
+  if (method === "cursor" || method === "vscode") {
+    openDiffsInEditor(method, stagedFiles.map((f) => ({
+      originalPath: f.originalPath,
+      proposedPath: f.proposedPath
+    })));
+    console.log(chalk.dim("  Diffs opened in your editor.\n"));
+    return;
+  }
+  const fileInfos = stagedFiles.map((file) => {
+    const proposed = fs14.readFileSync(file.proposedPath, "utf-8");
+    const current = file.currentPath ? fs14.readFileSync(file.currentPath, "utf-8") : "";
+    const patch = createTwoFilesPatch(
+      file.isNew ? "/dev/null" : file.relativePath,
+      file.relativePath,
+      current,
+      proposed
+    );
+    let added = 0, removed = 0;
+    for (const line of patch.split("\n")) {
+      if (line.startsWith("+") && !line.startsWith("+++")) added++;
+      if (line.startsWith("-") && !line.startsWith("---")) removed++;
+    }
+    return {
+      relativePath: file.relativePath,
+      isNew: file.isNew,
+      added,
+      removed,
+      lines: proposed.split("\n").length,
+      patch
+    };
+  });
+  await interactiveDiffExplorer(fileInfos);
+}
+async function interactiveDiffExplorer(files) {
+  if (!process.stdin.isTTY) {
+    for (const f of files) {
+      const icon = f.isNew ? chalk.green("+") : chalk.yellow("~");
+      const stats = f.isNew ? chalk.dim(`${f.lines} lines`) : `${chalk.green(`+${f.added}`)} ${chalk.red(`-${f.removed}`)}`;
+      console.log(`    ${icon} ${f.relativePath}  ${stats}`);
+    }
+    console.log("");
+    return;
+  }
+  const { stdin, stdout } = process;
+  let cursor = 0;
+  let viewing = null;
+  let scrollOffset = 0;
+  let lineCount = 0;
+  function getTermHeight() {
+    return (stdout.rows || 24) - 4;
+  }
+  function renderFileList() {
+    const lines = [];
+    lines.push(chalk.bold("  Review changes"));
+    lines.push("");
+    for (let i = 0; i < files.length; i++) {
+      const f = files[i];
+      const ptr = i === cursor ? chalk.cyan(">") : " ";
+      const icon = f.isNew ? chalk.green("+") : chalk.yellow("~");
+      const stats = f.isNew ? chalk.dim(`${f.lines} lines`) : `${chalk.green(`+${f.added}`)} ${chalk.red(`-${f.removed}`)}`;
+      lines.push(`  ${ptr} ${icon} ${f.relativePath}  ${stats}`);
+    }
+    lines.push("");
+    lines.push(chalk.dim("  \u2191\u2193 navigate  \u23CE view diff  q done"));
+    return lines.join("\n");
+  }
+  function renderDiff(index) {
+    const f = files[index];
+    const lines = [];
+    const header = f.isNew ? `  ${chalk.green("+")} ${f.relativePath} ${chalk.dim("(new file)")}` : `  ${chalk.yellow("~")} ${f.relativePath} ${chalk.green(`+${f.added}`)} ${chalk.red(`-${f.removed}`)}`;
+    lines.push(header);
+    lines.push(chalk.dim("  " + "\u2500".repeat(60)));
+    const patchLines = f.patch.split("\n");
+    const bodyLines = patchLines.slice(4);
+    const maxVisible = getTermHeight() - 4;
+    const visibleLines = bodyLines.slice(scrollOffset, scrollOffset + maxVisible);
+    for (const line of visibleLines) {
+      if (line.startsWith("+")) {
+        lines.push(chalk.green("  " + line));
+      } else if (line.startsWith("-")) {
+        lines.push(chalk.red("  " + line));
+      } else if (line.startsWith("@@")) {
+        lines.push(chalk.cyan("  " + line));
+      } else {
+        lines.push(chalk.dim("  " + line));
+      }
+    }
+    const totalBody = bodyLines.length;
+    if (totalBody > maxVisible) {
+      const pct = Math.round((scrollOffset + maxVisible) / totalBody * 100);
+      lines.push(chalk.dim(`  \u2500\u2500 ${Math.min(pct, 100)}% \u2500\u2500`));
+    }
+    lines.push("");
+    lines.push(chalk.dim("  \u2191\u2193 scroll  \u23B5/esc back to file list"));
+    return lines.join("\n");
+  }
+  function draw(initial) {
+    if (!initial && lineCount > 0) {
+      stdout.write(`\x1B[${lineCount}A`);
+    }
+    stdout.write("\x1B[0J");
+    const output = viewing !== null ? renderDiff(viewing) : renderFileList();
+    stdout.write(output + "\n");
+    lineCount = output.split("\n").length;
+  }
+  return new Promise((resolve2) => {
+    console.log("");
+    draw(true);
+    stdin.setRawMode(true);
+    stdin.resume();
+    stdin.setEncoding("utf8");
+    function cleanup() {
+      stdin.removeListener("data", onData);
+      stdin.setRawMode(false);
+      stdin.pause();
+    }
+    function onData(key) {
+      if (viewing !== null) {
+        const f = files[viewing];
+        const totalBody = f.patch.split("\n").length - 4;
+        const maxVisible = getTermHeight() - 4;
+        switch (key) {
+          case "\x1B[A":
+            scrollOffset = Math.max(0, scrollOffset - 1);
+            draw(false);
+            break;
+          case "\x1B[B":
+            scrollOffset = Math.min(Math.max(0, totalBody - maxVisible), scrollOffset + 1);
+            draw(false);
+            break;
+          case " ":
+          case "\x1B":
+            viewing = null;
+            scrollOffset = 0;
+            draw(false);
+            break;
+          case "q":
+          case "":
+            cleanup();
+            console.log("");
+            resolve2();
+            break;
+        }
+      } else {
+        switch (key) {
+          case "\x1B[A":
+            cursor = (cursor - 1 + files.length) % files.length;
+            draw(false);
+            break;
+          case "\x1B[B":
+            cursor = (cursor + 1) % files.length;
+            draw(false);
+            break;
+          case "\r":
+          case "\n":
+            viewing = cursor;
+            scrollOffset = 0;
+            draw(false);
+            break;
+          case "q":
+          case "":
+            cleanup();
+            console.log("");
+            resolve2();
+            break;
+        }
+      }
+    }
+    stdin.on("data", onData);
+  });
+}
 
 // src/commands/setup-files.ts
-import fs14 from "fs";
+import fs15 from "fs";
 function buildSkillContent(skill) {
   const frontmatter = `---
 name: ${skill.name}
@@ -2253,7 +2466,7 @@ function collectSetupFiles(setup) {
       }
     }
   }
-  if (!fs14.existsSync("AGENTS.md") && !(codex && codex.agentsMd)) {
+  if (!fs15.existsSync("AGENTS.md") && !(codex && codex.agentsMd)) {
     const agentRefs = [];
     if (claude) agentRefs.push("See `CLAUDE.md` for Claude Code configuration.");
     if (cursor) agentRefs.push("See `.cursor/rules/` for Cursor rules.");
@@ -2272,24 +2485,24 @@ ${agentRefs.join(" ")}
 }
 
 // src/lib/hooks.ts
-import fs15 from "fs";
+import fs16 from "fs";
 import path12 from "path";
 import { execSync as execSync5 } from "child_process";
 var SETTINGS_PATH = path12.join(".claude", "settings.json");
 var HOOK_COMMAND = "caliber refresh --quiet";
 var HOOK_DESCRIPTION = "Caliber: auto-refreshing docs based on code changes";
 function readSettings() {
-  if (!fs15.existsSync(SETTINGS_PATH)) return {};
+  if (!fs16.existsSync(SETTINGS_PATH)) return {};
   try {
-    return JSON.parse(fs15.readFileSync(SETTINGS_PATH, "utf-8"));
+    return JSON.parse(fs16.readFileSync(SETTINGS_PATH, "utf-8"));
   } catch {
     return {};
   }
 }
 function writeSettings(settings) {
   const dir = path12.dirname(SETTINGS_PATH);
-  if (!fs15.existsSync(dir)) fs15.mkdirSync(dir, { recursive: true });
-  fs15.writeFileSync(SETTINGS_PATH, JSON.stringify(settings, null, 2));
+  if (!fs16.existsSync(dir)) fs16.mkdirSync(dir, { recursive: true });
+  fs16.writeFileSync(SETTINGS_PATH, JSON.stringify(settings, null, 2));
 }
 function findHookIndex(sessionEnd) {
   return sessionEnd.findIndex(
@@ -2358,8 +2571,8 @@ function getPreCommitPath() {
 }
 function isPreCommitHookInstalled() {
   const hookPath = getPreCommitPath();
-  if (!hookPath || !fs15.existsSync(hookPath)) return false;
-  const content = fs15.readFileSync(hookPath, "utf-8");
+  if (!hookPath || !fs16.existsSync(hookPath)) return false;
+  const content = fs16.readFileSync(hookPath, "utf-8");
   return content.includes(PRECOMMIT_START);
 }
 function installPreCommitHook() {
@@ -2369,40 +2582,40 @@ function installPreCommitHook() {
   const hookPath = getPreCommitPath();
   if (!hookPath) return { installed: false, alreadyInstalled: false };
   const hooksDir = path12.dirname(hookPath);
-  if (!fs15.existsSync(hooksDir)) fs15.mkdirSync(hooksDir, { recursive: true });
+  if (!fs16.existsSync(hooksDir)) fs16.mkdirSync(hooksDir, { recursive: true });
   let content = "";
-  if (fs15.existsSync(hookPath)) {
-    content = fs15.readFileSync(hookPath, "utf-8");
+  if (fs16.existsSync(hookPath)) {
+    content = fs16.readFileSync(hookPath, "utf-8");
     if (!content.endsWith("\n")) content += "\n";
     content += "\n" + PRECOMMIT_BLOCK + "\n";
   } else {
     content = "#!/bin/sh\n\n" + PRECOMMIT_BLOCK + "\n";
   }
-  fs15.writeFileSync(hookPath, content);
-  fs15.chmodSync(hookPath, 493);
+  fs16.writeFileSync(hookPath, content);
+  fs16.chmodSync(hookPath, 493);
   return { installed: true, alreadyInstalled: false };
 }
 function removePreCommitHook() {
   const hookPath = getPreCommitPath();
-  if (!hookPath || !fs15.existsSync(hookPath)) {
+  if (!hookPath || !fs16.existsSync(hookPath)) {
     return { removed: false, notFound: true };
   }
-  let content = fs15.readFileSync(hookPath, "utf-8");
+  let content = fs16.readFileSync(hookPath, "utf-8");
   if (!content.includes(PRECOMMIT_START)) {
     return { removed: false, notFound: true };
   }
   const regex = new RegExp(`\\n?${PRECOMMIT_START}[\\s\\S]*?${PRECOMMIT_END}\\n?`);
   content = content.replace(regex, "\n");
   if (content.trim() === "#!/bin/sh" || content.trim() === "") {
-    fs15.unlinkSync(hookPath);
+    fs16.unlinkSync(hookPath);
   } else {
-    fs15.writeFileSync(hookPath, content);
+    fs16.writeFileSync(hookPath, content);
   }
   return { removed: true, notFound: false };
 }
 
 // src/lib/learning-hooks.ts
-import fs16 from "fs";
+import fs17 from "fs";
 import path13 from "path";
 var SETTINGS_PATH2 = path13.join(".claude", "settings.json");
 var HOOK_CONFIGS = [
@@ -2423,17 +2636,17 @@ var HOOK_CONFIGS = [
   }
 ];
 function readSettings2() {
-  if (!fs16.existsSync(SETTINGS_PATH2)) return {};
+  if (!fs17.existsSync(SETTINGS_PATH2)) return {};
   try {
-    return JSON.parse(fs16.readFileSync(SETTINGS_PATH2, "utf-8"));
+    return JSON.parse(fs17.readFileSync(SETTINGS_PATH2, "utf-8"));
   } catch {
     return {};
   }
 }
 function writeSettings2(settings) {
   const dir = path13.dirname(SETTINGS_PATH2);
-  if (!fs16.existsSync(dir)) fs16.mkdirSync(dir, { recursive: true });
-  fs16.writeFileSync(SETTINGS_PATH2, JSON.stringify(settings, null, 2));
+  if (!fs17.existsSync(dir)) fs17.mkdirSync(dir, { recursive: true });
+  fs17.writeFileSync(SETTINGS_PATH2, JSON.stringify(settings, null, 2));
 }
 function hasLearningHook(matchers, command) {
   return matchers.some((entry) => entry.hooks?.some((h) => h.command === command));
@@ -2490,7 +2703,7 @@ function removeLearningHooks() {
 
 // src/lib/state.ts
 init_constants();
-import fs17 from "fs";
+import fs18 from "fs";
 import path14 from "path";
 import { execSync as execSync6 } from "child_process";
 var STATE_FILE = path14.join(CALIBER_DIR, ".caliber-state.json");
@@ -2504,8 +2717,8 @@ function normalizeTargetAgent(value) {
 }
 function readState() {
   try {
-    if (!fs17.existsSync(STATE_FILE)) return null;
-    const raw = JSON.parse(fs17.readFileSync(STATE_FILE, "utf-8"));
+    if (!fs18.existsSync(STATE_FILE)) return null;
+    const raw = JSON.parse(fs18.readFileSync(STATE_FILE, "utf-8"));
     if (raw.targetAgent) raw.targetAgent = normalizeTargetAgent(raw.targetAgent);
     return raw;
   } catch {
@@ -2513,10 +2726,10 @@ function readState() {
   }
 }
 function writeState(state) {
-  if (!fs17.existsSync(CALIBER_DIR)) {
-    fs17.mkdirSync(CALIBER_DIR, { recursive: true });
+  if (!fs18.existsSync(CALIBER_DIR)) {
+    fs18.mkdirSync(CALIBER_DIR, { recursive: true });
   }
-  fs17.writeFileSync(STATE_FILE, JSON.stringify(state, null, 2));
+  fs18.writeFileSync(STATE_FILE, JSON.stringify(state, null, 2));
 }
 function getCurrentHeadSha() {
   try {
@@ -2530,7 +2743,7 @@ function getCurrentHeadSha() {
 }
 
 // src/utils/spinner-messages.ts
-import chalk from "chalk";
+import chalk2 from "chalk";
 var GENERATION_MESSAGES = [
   "Analyzing your project structure and dependencies...",
   "Mapping out build commands and test workflows...",
@@ -2580,9 +2793,9 @@ var SpinnerMessages = class {
     this.currentBaseMessage = this.messages[0];
     this.updateSpinnerText();
     if (this.showElapsedTime) {
-      this.spinner.suffixText = chalk.dim(`(${this.formatElapsed()})`);
+      this.spinner.suffixText = chalk2.dim(`(${this.formatElapsed()})`);
       this.elapsedTimer = setInterval(() => {
-        this.spinner.suffixText = chalk.dim(`(${this.formatElapsed()})`);
+        this.spinner.suffixText = chalk2.dim(`(${this.formatElapsed()})`);
       }, 1e3);
     }
     this.timer = setInterval(() => {
@@ -2617,13 +2830,13 @@ var SpinnerMessages = class {
 };
 
 // src/commands/interactive-provider-setup.ts
-import chalk2 from "chalk";
+import chalk3 from "chalk";
 import readline2 from "readline";
-import select from "@inquirer/select";
+import select2 from "@inquirer/select";
 function promptInput(question) {
   const rl = readline2.createInterface({ input: process.stdin, output: process.stdout });
   return new Promise((resolve2) => {
-    rl.question(chalk2.cyan(`${question} `), (answer) => {
+    rl.question(chalk3.cyan(`${question} `), (answer) => {
       rl.close();
       resolve2(answer.trim());
     });
@@ -2638,7 +2851,7 @@ var PROVIDER_CHOICES = [
 ];
 async function runInteractiveProviderSetup(options) {
   const message = options?.selectMessage ?? "Select LLM provider";
-  const provider = await select({
+  const provider = await select2({
     message,
     choices: PROVIDER_CHOICES
   });
@@ -2646,19 +2859,19 @@ async function runInteractiveProviderSetup(options) {
   switch (provider) {
     case "claude-cli": {
       config.model = "default";
-      console.log(chalk2.dim("  Run `claude` once and log in with your Pro/Max/Team account if you haven't."));
+      console.log(chalk3.dim("  Run `claude` once and log in with your Pro/Max/Team account if you haven't."));
       break;
     }
     case "cursor": {
       config.model = "default";
-      console.log(chalk2.dim("  Run `agent login` if you haven't, or set CURSOR_API_KEY."));
+      console.log(chalk3.dim("  Run `agent login` if you haven't, or set CURSOR_API_KEY."));
       break;
     }
     case "anthropic": {
-      console.log(chalk2.dim("  Get a key at https://console.anthropic.com (same account as Claude Pro/Team/Max)."));
+      console.log(chalk3.dim("  Get a key at https://console.anthropic.com (same account as Claude Pro/Team/Max)."));
       config.apiKey = await promptInput("Anthropic API key:");
       if (!config.apiKey) {
-        console.log(chalk2.red("API key is required."));
+        console.log(chalk3.red("API key is required."));
         throw new Error("__exit__");
       }
       config.model = await promptInput(`Model (default: ${DEFAULT_MODELS.anthropic}):`) || DEFAULT_MODELS.anthropic;
@@ -2667,7 +2880,7 @@ async function runInteractiveProviderSetup(options) {
     case "vertex": {
       config.vertexProjectId = await promptInput("GCP Project ID:");
       if (!config.vertexProjectId) {
-        console.log(chalk2.red("Project ID is required."));
+        console.log(chalk3.red("Project ID is required."));
         throw new Error("__exit__");
       }
       config.vertexRegion = await promptInput("Region (default: us-east5):") || "us-east5";
@@ -2678,7 +2891,7 @@ async function runInteractiveProviderSetup(options) {
     case "openai": {
       config.apiKey = await promptInput("API key:");
       if (!config.apiKey) {
-        console.log(chalk2.red("API key is required."));
+        console.log(chalk3.red("API key is required."));
         throw new Error("__exit__");
       }
       config.baseUrl = await promptInput("Base URL (leave empty for OpenAI, or enter custom endpoint):") || void 0;
@@ -3737,22 +3950,22 @@ function checkBonus(dir) {
 
 // src/scoring/dismissed.ts
 init_constants();
-import fs18 from "fs";
+import fs19 from "fs";
 import path15 from "path";
 var DISMISSED_FILE = path15.join(CALIBER_DIR, "dismissed-checks.json");
 function readDismissedChecks() {
   try {
-    if (!fs18.existsSync(DISMISSED_FILE)) return [];
-    return JSON.parse(fs18.readFileSync(DISMISSED_FILE, "utf-8"));
+    if (!fs19.existsSync(DISMISSED_FILE)) return [];
+    return JSON.parse(fs19.readFileSync(DISMISSED_FILE, "utf-8"));
   } catch {
     return [];
   }
 }
 function writeDismissedChecks(checks) {
-  if (!fs18.existsSync(CALIBER_DIR)) {
-    fs18.mkdirSync(CALIBER_DIR, { recursive: true });
+  if (!fs19.existsSync(CALIBER_DIR)) {
+    fs19.mkdirSync(CALIBER_DIR, { recursive: true });
   }
-  fs18.writeFileSync(DISMISSED_FILE, JSON.stringify(checks, null, 2) + "\n");
+  fs19.writeFileSync(DISMISSED_FILE, JSON.stringify(checks, null, 2) + "\n");
 }
 function getDismissedIds() {
   return new Set(readDismissedChecks().map((c) => c.id));
@@ -3816,7 +4029,7 @@ function computeLocalScore(dir, targetAgent) {
 }
 
 // src/scoring/display.ts
-import chalk3 from "chalk";
+import chalk4 from "chalk";
 var AGENT_DISPLAY_NAMES = {
   claude: "Claude Code",
   cursor: "Cursor",
@@ -3834,31 +4047,31 @@ var CATEGORY_ORDER = ["existence", "quality", "coverage", "accuracy", "freshness
 function gradeColor(grade) {
   switch (grade) {
     case "A":
-      return chalk3.green;
+      return chalk4.green;
     case "B":
-      return chalk3.greenBright;
+      return chalk4.greenBright;
     case "C":
-      return chalk3.yellow;
+      return chalk4.yellow;
     case "D":
-      return chalk3.hex("#f97316");
+      return chalk4.hex("#f97316");
     case "F":
-      return chalk3.red;
+      return chalk4.red;
     default:
-      return chalk3.white;
+      return chalk4.white;
   }
 }
 function progressBar(score, max, width = 40) {
   const filled = Math.round(score / max * width);
   const empty = width - filled;
-  const bar = chalk3.hex("#f97316")("\u2593".repeat(filled)) + chalk3.gray("\u2591".repeat(empty));
+  const bar = chalk4.hex("#f97316")("\u2593".repeat(filled)) + chalk4.gray("\u2591".repeat(empty));
   return bar;
 }
 function formatCheck(check) {
-  const icon = check.passed ? chalk3.green("\u2713") : check.earnedPoints < 0 ? chalk3.red("\u2717") : chalk3.gray("\u2717");
-  const points = check.passed ? chalk3.green(`+${check.earnedPoints}`.padStart(4)) : check.earnedPoints < 0 ? chalk3.red(`${check.earnedPoints}`.padStart(4)) : chalk3.gray("  \u2014");
-  const name = check.passed ? chalk3.white(check.name) : chalk3.gray(check.name);
-  const detail = check.detail ? chalk3.gray(` (${check.detail})`) : "";
-  const suggestion = !check.passed && check.suggestion ? chalk3.gray(`
+  const icon = check.passed ? chalk4.green("\u2713") : check.earnedPoints < 0 ? chalk4.red("\u2717") : chalk4.gray("\u2717");
+  const points = check.passed ? chalk4.green(`+${check.earnedPoints}`.padStart(4)) : check.earnedPoints < 0 ? chalk4.red(`${check.earnedPoints}`.padStart(4)) : chalk4.gray("  \u2014");
+  const name = check.passed ? chalk4.white(check.name) : chalk4.gray(check.name);
+  const detail = check.detail ? chalk4.gray(` (${check.detail})`) : "";
+  const suggestion = !check.passed && check.suggestion ? chalk4.gray(`
        \u2192 ${check.suggestion}`) : "";
   return `  ${icon} ${name.padEnd(38)}${points}${detail}${suggestion}`;
 }
@@ -3866,19 +4079,19 @@ function displayScore(result) {
   const gc = gradeColor(result.grade);
   const agentLabel = result.targetAgent.map((a) => AGENT_DISPLAY_NAMES[a] || a).join(" + ");
   console.log("");
-  console.log(chalk3.gray("  \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500"));
+  console.log(chalk4.gray("  \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500"));
   console.log("");
-  console.log(`  ${chalk3.bold("Agent Config Score")}    ${gc(chalk3.bold(`${result.score} / ${result.maxScore}`))}    Grade ${gc(chalk3.bold(result.grade))}`);
+  console.log(`  ${chalk4.bold("Agent Config Score")}    ${gc(chalk4.bold(`${result.score} / ${result.maxScore}`))}    Grade ${gc(chalk4.bold(result.grade))}`);
   console.log(`  ${progressBar(result.score, result.maxScore)}`);
-  console.log(chalk3.dim(`  Target: ${agentLabel}`));
+  console.log(chalk4.dim(`  Target: ${agentLabel}`));
   console.log("");
-  console.log(chalk3.gray("  \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500"));
+  console.log(chalk4.gray("  \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500"));
   console.log("");
   for (const category of CATEGORY_ORDER) {
     const summary = result.categories[category];
     const categoryChecks = result.checks.filter((c) => c.category === category);
     console.log(
-      chalk3.gray(`  ${CATEGORY_LABELS[category]}`) + chalk3.gray(" ".repeat(Math.max(1, 45 - CATEGORY_LABELS[category].length))) + chalk3.white(`${summary.earned}`) + chalk3.gray(` / ${summary.max}`)
+      chalk4.gray(`  ${CATEGORY_LABELS[category]}`) + chalk4.gray(" ".repeat(Math.max(1, 45 - CATEGORY_LABELS[category].length))) + chalk4.white(`${summary.earned}`) + chalk4.gray(` / ${summary.max}`)
     );
     for (const check of categoryChecks) {
       console.log(formatCheck(check));
@@ -3891,48 +4104,48 @@ function displayScoreSummary(result) {
   const agentLabel = result.targetAgent.map((a) => AGENT_DISPLAY_NAMES[a] || a).join(" + ");
   console.log("");
   console.log(
-    chalk3.gray("  ") + gc(`${result.score}/${result.maxScore}`) + chalk3.gray(` (Grade ${result.grade})`) + chalk3.gray(`  \xB7  ${agentLabel}`) + chalk3.gray(`  \xB7  ${progressBar(result.score, result.maxScore, 20)}`)
+    chalk4.gray("  ") + gc(`${result.score}/${result.maxScore}`) + chalk4.gray(` (Grade ${result.grade})`) + chalk4.gray(`  \xB7  ${agentLabel}`) + chalk4.gray(`  \xB7  ${progressBar(result.score, result.maxScore, 20)}`)
   );
   const failing = result.checks.filter((c) => !c.passed);
   if (failing.length > 0) {
     const shown = failing.slice(0, 5);
     for (const check of shown) {
-      console.log(chalk3.gray(`  \u2717 ${check.name}`));
+      console.log(chalk4.gray(`  \u2717 ${check.name}`));
     }
     const remaining = failing.length - shown.length;
     const moreText = remaining > 0 ? ` (+${remaining} more)` : "";
-    console.log(chalk3.dim(`
-  Run ${chalk3.hex("#83D1EB")("caliber score")} for details.${moreText}`));
+    console.log(chalk4.dim(`
+  Run ${chalk4.hex("#83D1EB")("caliber score")} for details.${moreText}`));
   }
   console.log("");
 }
 function displayScoreDelta(before, after) {
   const delta = after.score - before.score;
   const deltaStr = delta >= 0 ? `+${delta}` : `${delta}`;
-  const deltaColor = delta >= 0 ? chalk3.green : chalk3.red;
+  const deltaColor = delta >= 0 ? chalk4.green : chalk4.red;
   const beforeGc = gradeColor(before.grade);
   const afterGc = gradeColor(after.grade);
   console.log("");
-  console.log(chalk3.gray("  \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500"));
+  console.log(chalk4.gray("  \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500"));
   console.log("");
   console.log(
-    `  Score: ${beforeGc(`${before.score}`)} ${chalk3.gray("\u2192")} ${afterGc(`${after.score}`)}    ${deltaColor(deltaStr + " pts")}    ${beforeGc(before.grade)} ${chalk3.gray("\u2192")} ${afterGc(after.grade)}`
+    `  Score: ${beforeGc(`${before.score}`)} ${chalk4.gray("\u2192")} ${afterGc(`${after.score}`)}    ${deltaColor(deltaStr + " pts")}    ${beforeGc(before.grade)} ${chalk4.gray("\u2192")} ${afterGc(after.grade)}`
   );
-  console.log(`  ${progressBar(before.score, before.maxScore, 19)} ${chalk3.gray("\u2192")} ${progressBar(after.score, after.maxScore, 19)}`);
+  console.log(`  ${progressBar(before.score, before.maxScore, 19)} ${chalk4.gray("\u2192")} ${progressBar(after.score, after.maxScore, 19)}`);
   console.log("");
-  console.log(chalk3.gray("  \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500"));
+  console.log(chalk4.gray("  \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500"));
   console.log("");
   const improved = after.checks.filter((ac) => {
     const bc = before.checks.find((b) => b.id === ac.id);
     return bc && ac.earnedPoints > bc.earnedPoints;
   });
   if (improved.length > 0) {
-    console.log(chalk3.gray("  What improved:"));
+    console.log(chalk4.gray("  What improved:"));
     for (const check of improved) {
       const bc = before.checks.find((b) => b.id === check.id);
       const gain = check.earnedPoints - bc.earnedPoints;
       console.log(
-        chalk3.green("  +") + chalk3.white(` ${check.name.padEnd(50)}`) + chalk3.green(`+${gain}`)
+        chalk4.green("  +") + chalk4.white(` ${check.name.padEnd(50)}`) + chalk4.green(`+${gain}`)
       );
     }
     console.log("");
@@ -3940,10 +4153,10 @@ function displayScoreDelta(before, after) {
 }
 
 // src/mcp/index.ts
-import chalk4 from "chalk";
+import chalk5 from "chalk";
 import ora from "ora";
 import readline3 from "readline";
-import fs19 from "fs";
+import fs20 from "fs";
 import path16 from "path";
 
 // src/mcp/search.ts
@@ -4218,38 +4431,38 @@ ${truncated}`,
 
 // src/mcp/index.ts
 async function discoverAndInstallMcps(targetAgent, fingerprint, dir) {
-  console.log(chalk4.hex("#6366f1").bold("\n  MCP Server Discovery\n"));
+  console.log(chalk5.hex("#6366f1").bold("\n  MCP Server Discovery\n"));
   const toolDeps = fingerprint.tools;
   if (toolDeps.length === 0) {
-    console.log(chalk4.dim("  No external tools or services detected \u2014 skipping MCP discovery"));
+    console.log(chalk5.dim("  No external tools or services detected \u2014 skipping MCP discovery"));
     return { installed: 0, names: [] };
   }
   const spinner = ora(`Searching MCP servers for ${toolDeps.length} detected tool${toolDeps.length === 1 ? "" : "s"}...`).start();
-  console.log(chalk4.dim(`  Detected: ${toolDeps.join(", ")}`));
+  console.log(chalk5.dim(`  Detected: ${toolDeps.join(", ")}`));
   const existingMcps = getExistingMcpNames(fingerprint, targetAgent);
   const filteredDeps = toolDeps.filter((d) => {
     const lower = d.toLowerCase();
     return !existingMcps.some((name) => name.includes(lower) || lower.includes(name));
   });
   if (filteredDeps.length === 0) {
-    spinner.succeed(chalk4.dim("All detected tools already have MCP servers configured"));
+    spinner.succeed(chalk5.dim("All detected tools already have MCP servers configured"));
     return { installed: 0, names: [] };
   }
   const candidates = await searchAllMcpSources(filteredDeps);
   if (candidates.length === 0) {
-    spinner.succeed(chalk4.dim("No MCP servers found for detected tools"));
+    spinner.succeed(chalk5.dim("No MCP servers found for detected tools"));
     return { installed: 0, names: [] };
   }
   spinner.succeed(`Found ${candidates.length} candidate${candidates.length === 1 ? "" : "s"} for ${filteredDeps.join(", ")}`);
   const scoreSpinner = ora("Scoring MCP candidates...").start();
   const scored = await validateAndScore(candidates, filteredDeps);
   if (scored.length === 0) {
-    scoreSpinner.succeed(chalk4.dim("No quality MCP servers passed validation"));
-    console.log(chalk4.dim(`  Candidates checked: ${candidates.map((c) => c.name).join(", ")}`));
+    scoreSpinner.succeed(chalk5.dim("No quality MCP servers passed validation"));
+    console.log(chalk5.dim(`  Candidates checked: ${candidates.map((c) => c.name).join(", ")}`));
     return { installed: 0, names: [] };
   }
   scoreSpinner.succeed(`${scored.length} quality MCP server${scored.length === 1 ? "" : "s"} found`);
-  console.log(chalk4.dim(`  Scored: ${scored.map((c) => `${c.name} (${c.score})`).join(", ")}`));
+  console.log(chalk5.dim(`  Scored: ${scored.map((c) => `${c.name} (${c.score})`).join(", ")}`));
   const selected = await interactiveSelect(scored);
   if (!selected || selected.length === 0) {
     return { installed: 0, names: [] };
@@ -4257,18 +4470,18 @@ async function discoverAndInstallMcps(targetAgent, fingerprint, dir) {
   const mcpServers = {};
   const installedNames = [];
   for (const mcp of selected) {
-    console.log(chalk4.bold(`
+    console.log(chalk5.bold(`
   Configuring ${mcp.name}...`));
     const readme = await fetchReadme(mcp.repoFullName);
     if (!readme) {
-      console.log(chalk4.yellow(`  Could not fetch README for ${mcp.repoFullName} \u2014 skipping`));
-      console.log(chalk4.dim(`  Manual setup: ${mcp.url}`));
+      console.log(chalk5.yellow(`  Could not fetch README for ${mcp.repoFullName} \u2014 skipping`));
+      console.log(chalk5.dim(`  Manual setup: ${mcp.url}`));
       continue;
     }
     const config = await extractMcpConfig(readme, mcp.name);
     if (!config || !config.command) {
-      console.log(chalk4.yellow(`  Could not extract config for ${mcp.name} \u2014 skipping`));
-      console.log(chalk4.dim(`  Manual setup: ${mcp.url}`));
+      console.log(chalk5.yellow(`  Could not extract config for ${mcp.name} \u2014 skipping`));
+      console.log(chalk5.dim(`  Manual setup: ${mcp.url}`));
       continue;
     }
     const env = {};
@@ -4286,7 +4499,7 @@ async function discoverAndInstallMcps(targetAgent, fingerprint, dir) {
     if (Object.keys(env).length > 0) serverConfig.env = env;
     mcpServers[mcp.name] = serverConfig;
     installedNames.push(mcp.name);
-    console.log(`  ${chalk4.green("\u2713")} ${mcp.name} configured`);
+    console.log(`  ${chalk5.green("\u2713")} ${mcp.name} configured`);
   }
   if (installedNames.length === 0) {
     return { installed: 0, names: [] };
@@ -4296,7 +4509,7 @@ async function discoverAndInstallMcps(targetAgent, fingerprint, dir) {
   }
   if (targetAgent.includes("cursor")) {
     const cursorDir = path16.join(dir, ".cursor");
-    if (!fs19.existsSync(cursorDir)) fs19.mkdirSync(cursorDir, { recursive: true });
+    if (!fs20.existsSync(cursorDir)) fs20.mkdirSync(cursorDir, { recursive: true });
     writeMcpJson(path16.join(cursorDir, "mcp.json"), mcpServers);
   }
   return { installed: installedNames.length, names: installedNames };
@@ -4304,14 +4517,14 @@ async function discoverAndInstallMcps(targetAgent, fingerprint, dir) {
 function writeMcpJson(filePath, mcpServers) {
   let existing = {};
   try {
-    if (fs19.existsSync(filePath)) {
-      const parsed = JSON.parse(fs19.readFileSync(filePath, "utf-8"));
+    if (fs20.existsSync(filePath)) {
+      const parsed = JSON.parse(fs20.readFileSync(filePath, "utf-8"));
       if (parsed.mcpServers) existing = parsed.mcpServers;
     }
   } catch {
   }
   const merged = { ...existing, ...mcpServers };
-  fs19.writeFileSync(filePath, JSON.stringify({ mcpServers: merged }, null, 2) + "\n");
+  fs20.writeFileSync(filePath, JSON.stringify({ mcpServers: merged }, null, 2) + "\n");
 }
 function getExistingMcpNames(fingerprint, targetAgent) {
   const names = [];
@@ -4330,7 +4543,7 @@ function getExistingMcpNames(fingerprint, targetAgent) {
 function promptInput2(question) {
   const rl = readline3.createInterface({ input: process.stdin, output: process.stdout });
   return new Promise((resolve2) => {
-    rl.question(chalk4.cyan(`${question}: `), (answer) => {
+    rl.question(chalk5.cyan(`${question}: `), (answer) => {
       rl.close();
       resolve2(answer.trim());
     });
@@ -4338,10 +4551,10 @@ function promptInput2(question) {
 }
 async function interactiveSelect(candidates) {
   if (!process.stdin.isTTY) {
-    console.log(chalk4.bold("\n  Available MCP servers:\n"));
+    console.log(chalk5.bold("\n  Available MCP servers:\n"));
     for (const c of candidates) {
-      const vendorTag = c.vendor ? chalk4.blue(" (vendor)") : "";
-      console.log(`  ${String(c.score).padStart(3)}  ${c.name}${vendorTag}  ${chalk4.dim(c.reason)}`);
+      const vendorTag = c.vendor ? chalk5.blue(" (vendor)") : "";
+      console.log(`  ${String(c.score).padStart(3)}  ${c.name}${vendorTag}  ${chalk5.dim(c.reason)}`);
     }
     console.log("");
     return null;
@@ -4352,18 +4565,18 @@ async function interactiveSelect(candidates) {
   let lineCount = 0;
   function render() {
     const lines = [];
-    lines.push(chalk4.bold("  Select MCP servers to install:"));
+    lines.push(chalk5.bold("  Select MCP servers to install:"));
     lines.push("");
     for (let i = 0; i < candidates.length; i++) {
       const c = candidates[i];
-      const check = selected.has(i) ? chalk4.green("[x]") : "[ ]";
-      const ptr = i === cursor ? chalk4.cyan(">") : " ";
-      const scoreColor = c.score >= 90 ? chalk4.green : c.score >= 70 ? chalk4.yellow : chalk4.dim;
-      const vendorTag = c.vendor ? chalk4.blue(" (vendor)") : "";
-      lines.push(`  ${ptr} ${check} ${scoreColor(String(c.score).padStart(3))}  ${c.name}${vendorTag}  ${chalk4.dim(c.reason.slice(0, 40))}`);
+      const check = selected.has(i) ? chalk5.green("[x]") : "[ ]";
+      const ptr = i === cursor ? chalk5.cyan(">") : " ";
+      const scoreColor = c.score >= 90 ? chalk5.green : c.score >= 70 ? chalk5.yellow : chalk5.dim;
+      const vendorTag = c.vendor ? chalk5.blue(" (vendor)") : "";
+      lines.push(`  ${ptr} ${check} ${scoreColor(String(c.score).padStart(3))}  ${c.name}${vendorTag}  ${chalk5.dim(c.reason.slice(0, 40))}`);
     }
     lines.push("");
-    lines.push(chalk4.dim("  \u2191\u2193 navigate  \u23B5 toggle  a all  n none  \u23CE install  q skip"));
+    lines.push(chalk5.dim("  \u2191\u2193 navigate  \u23B5 toggle  a all  n none  \u23CE install  q skip"));
     return lines.join("\n");
   }
   function draw(initial) {
@@ -4412,7 +4625,7 @@ async function interactiveSelect(candidates) {
         case "\n":
           cleanup();
           if (selected.size === 0) {
-            console.log(chalk4.dim("\n  No MCP servers selected.\n"));
+            console.log(chalk5.dim("\n  No MCP servers selected.\n"));
             resolve2(null);
           } else {
             resolve2(Array.from(selected).sort().map((i) => candidates[i]));
@@ -4422,7 +4635,7 @@ async function interactiveSelect(candidates) {
         case "\x1B":
         case "":
           cleanup();
-          console.log(chalk4.dim("\n  Skipped MCP server installation.\n"));
+          console.log(chalk5.dim("\n  Skipped MCP server installation.\n"));
           resolve2(null);
           break;
       }
@@ -4431,586 +4644,570 @@ async function interactiveSelect(candidates) {
   });
 }
 
-// src/commands/onboard.ts
-async function initCommand(options) {
-  const brand = chalk5.hex("#EB9D83");
-  const title = chalk5.hex("#83D1EB");
-  console.log(brand.bold(`
-   \u2588\u2588\u2588\u2588\u2588\u2588\u2557 \u2588\u2588\u2588\u2588\u2588\u2557 \u2588\u2588\u2557     \u2588\u2588\u2557\u2588\u2588\u2588\u2588\u2588\u2588\u2557 \u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2557\u2588\u2588\u2588\u2588\u2588\u2588\u2557
-  \u2588\u2588\u2554\u2550\u2550\u2550\u2550\u255D\u2588\u2588\u2554\u2550\u2550\u2588\u2588\u2557\u2588\u2588\u2551     \u2588\u2588\u2551\u2588\u2588\u2554\u2550\u2550\u2588\u2588\u2557\u2588\u2588\u2554\u2550\u2550\u2550\u2550\u255D\u2588\u2588\u2554\u2550\u2550\u2588\u2588\u2557
-  \u2588\u2588\u2551     \u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2551\u2588\u2588\u2551     \u2588\u2588\u2551\u2588\u2588\u2588\u2588\u2588\u2588\u2554\u255D\u2588\u2588\u2588\u2588\u2588\u2557  \u2588\u2588\u2588\u2588\u2588\u2588\u2554\u255D
-  \u2588\u2588\u2551     \u2588\u2588\u2554\u2550\u2550\u2588\u2588\u2551\u2588\u2588\u2551     \u2588\u2588\u2551\u2588\u2588\u2554\u2550\u2550\u2588\u2588\u2557\u2588\u2588\u2554\u2550\u2550\u255D  \u2588\u2588\u2554\u2550\u2550\u2588\u2588\u2557
-  \u255A\u2588\u2588\u2588\u2588\u2588\u2588\u2557\u2588\u2588\u2551  \u2588\u2588\u2551\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2557\u2588\u2588\u2551\u2588\u2588\u2588\u2588\u2588\u2588\u2554\u255D\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2557\u2588\u2588\u2551  \u2588\u2588\u2551
-   \u255A\u2550\u2550\u2550\u2550\u2550\u255D\u255A\u2550\u255D  \u255A\u2550\u255D\u255A\u2550\u2550\u2550\u2550\u2550\u2550\u255D\u255A\u2550\u255D\u255A\u2550\u2550\u2550\u2550\u2550\u255D \u255A\u2550\u2550\u2550\u2550\u2550\u2550\u255D\u255A\u2550\u255D  \u255A\u2550\u255D
-  `));
-  console.log(chalk5.dim("  Onboard your project for AI-assisted development\n"));
-  console.log(title.bold("  Welcome to Caliber\n"));
-  console.log(chalk5.dim("  Caliber analyzes your codebase and creates tailored config files"));
-  console.log(chalk5.dim("  so your AI coding agents understand your project from day one.\n"));
-  console.log(title.bold("  How onboarding works:\n"));
-  console.log(chalk5.dim("  1. Connect    Set up your LLM provider"));
-  console.log(chalk5.dim("  2. Discover   Analyze your code, dependencies, and structure"));
-  console.log(chalk5.dim("  3. Generate   Create config files tailored to your project"));
-  console.log(chalk5.dim("  4. Review     Preview, refine, and apply the changes"));
-  console.log(chalk5.dim("  5. Enhance    Discover MCP servers for your tools\n"));
-  console.log(title.bold("  Step 1/5 \u2014 Connect your LLM\n"));
-  let config = loadConfig();
-  if (!config) {
-    console.log(chalk5.dim("  No LLM provider set yet. Choose how to run Caliber:\n"));
-    try {
-      await runInteractiveProviderSetup({
-        selectMessage: "How do you want to use Caliber? (choose LLM provider)"
-      });
-    } catch (err) {
-      if (err.message === "__exit__") throw err;
-      throw err;
-    }
-    config = loadConfig();
-    if (!config) {
-      console.log(chalk5.red("  Setup was cancelled or failed.\n"));
-      throw new Error("__exit__");
-    }
-    console.log(chalk5.green("  \u2713 Provider saved. Let's continue.\n"));
-  }
-  const displayModel = config.model === "default" && config.provider === "claude-cli" ? process.env.ANTHROPIC_MODEL || "default (inherited from Claude Code)" : config.model;
-  const fastModel = getFastModel();
-  const modelLine = fastModel ? `  Provider: ${config.provider} | Model: ${displayModel} | Scan: ${fastModel}` : `  Provider: ${config.provider} | Model: ${displayModel}`;
-  console.log(chalk5.dim(modelLine + "\n"));
-  console.log(title.bold("  Step 2/5 \u2014 Discover your project\n"));
-  console.log(chalk5.dim("  Learning about your languages, dependencies, structure, and existing configs.\n"));
-  const spinner = ora2("Analyzing project...").start();
-  const fingerprint = collectFingerprint(process.cwd());
-  await enrichFingerprintWithLLM(fingerprint, process.cwd());
-  spinner.succeed("Project analyzed");
-  console.log(chalk5.dim(`  Languages: ${fingerprint.languages.join(", ") || "none detected"}`));
-  console.log(chalk5.dim(`  Files: ${fingerprint.fileTree.length} found
-`));
-  const targetAgent = options.agent || await promptAgent();
-  const preScore = computeLocalScore(process.cwd(), targetAgent);
-  const failingForDismissal = preScore.checks.filter((c) => !c.passed && c.maxPoints > 0);
-  if (failingForDismissal.length > 0) {
-    const newDismissals = await evaluateDismissals(failingForDismissal, fingerprint);
-    if (newDismissals.length > 0) {
-      const existing = readDismissedChecks();
-      const existingIds = new Set(existing.map((d) => d.id));
-      const merged = [...existing, ...newDismissals.filter((d) => !existingIds.has(d.id))];
-      writeDismissedChecks(merged);
-    }
-  }
-  const baselineScore = computeLocalScore(process.cwd(), targetAgent);
-  displayScoreSummary(baselineScore);
-  const hasExistingConfig = !!(fingerprint.existingConfigs.claudeMd || fingerprint.existingConfigs.claudeSettings || fingerprint.existingConfigs.claudeSkills?.length || fingerprint.existingConfigs.cursorrules || fingerprint.existingConfigs.cursorRules?.length || fingerprint.existingConfigs.agentsMd);
-  const NON_LLM_CHECKS = /* @__PURE__ */ new Set(["hooks_configured", "agents_md_exists", "permissions_configured", "mcp_servers"]);
-  if (hasExistingConfig && baselineScore.score === 100) {
-    console.log(chalk5.bold.green("  Your setup is already optimal \u2014 nothing to change.\n"));
-    console.log(chalk5.dim("  Run ") + chalk5.hex("#83D1EB")("caliber onboard --force") + chalk5.dim(" to regenerate anyway.\n"));
-    if (!options.force) return;
+// src/commands/recommend.ts
+import chalk6 from "chalk";
+import ora2 from "ora";
+import select3 from "@inquirer/select";
+import { mkdirSync, readFileSync as readFileSync7, readdirSync as readdirSync5, existsSync as existsSync9, writeFileSync } from "fs";
+import { join as join8, dirname as dirname2 } from "path";
+
+// src/scanner/index.ts
+import fs21 from "fs";
+import path17 from "path";
+import crypto2 from "crypto";
+function scanLocalState(dir) {
+  const items = [];
+  const claudeMdPath = path17.join(dir, "CLAUDE.md");
+  if (fs21.existsSync(claudeMdPath)) {
+    items.push({
+      type: "rule",
+      platform: "claude",
+      name: "CLAUDE.md",
+      contentHash: hashFile(claudeMdPath),
+      path: claudeMdPath
+    });
   }
-  const allFailingChecks = baselineScore.checks.filter((c) => !c.passed && c.maxPoints > 0);
-  const llmFixableChecks = allFailingChecks.filter((c) => !NON_LLM_CHECKS.has(c.id));
-  if (hasExistingConfig && llmFixableChecks.length === 0 && allFailingChecks.length > 0 && !options.force) {
-    console.log(chalk5.bold.green("\n  Your config is fully optimized for LLM generation.\n"));
-    console.log(chalk5.dim("  Remaining items need CLI actions:\n"));
-    for (const check of allFailingChecks) {
-      console.log(chalk5.dim(`    \u2022 ${check.name}`));
-      if (check.suggestion) {
-        console.log(`      ${chalk5.hex("#83D1EB")(check.suggestion)}`);
-      }
+  const skillsDir = path17.join(dir, ".claude", "skills");
+  if (fs21.existsSync(skillsDir)) {
+    for (const file of fs21.readdirSync(skillsDir).filter((f) => f.endsWith(".md"))) {
+      const filePath = path17.join(skillsDir, file);
+      items.push({
+        type: "skill",
+        platform: "claude",
+        name: file,
+        contentHash: hashFile(filePath),
+        path: filePath
+      });
     }
-    console.log("");
-    console.log(chalk5.dim("  Run ") + chalk5.hex("#83D1EB")("caliber onboard --force") + chalk5.dim(" to regenerate anyway.\n"));
-    return;
-  }
-  const isEmpty = fingerprint.fileTree.length < 3;
-  if (isEmpty) {
-    fingerprint.description = await promptInput3("What will you build in this project?");
   }
-  let failingChecks;
-  let passingChecks;
-  let currentScore;
-  if (hasExistingConfig && baselineScore.score >= 95 && !options.force) {
-    failingChecks = llmFixableChecks.map((c) => ({ name: c.name, suggestion: c.suggestion }));
-    passingChecks = baselineScore.checks.filter((c) => c.passed).map((c) => ({ name: c.name }));
-    currentScore = baselineScore.score;
-    if (failingChecks.length > 0) {
-      console.log(title.bold("  Step 3/5 \u2014 Fine-tuning\n"));
-      console.log(chalk5.dim(`  Your setup scores ${baselineScore.score}/100 \u2014 fixing ${failingChecks.length} remaining issue${failingChecks.length === 1 ? "" : "s"}:
-`));
-      for (const check of failingChecks) {
-        console.log(chalk5.dim(`    \u2022 ${check.name}`));
+  const mcpJsonPath = path17.join(dir, ".mcp.json");
+  if (fs21.existsSync(mcpJsonPath)) {
+    try {
+      const mcpJson = JSON.parse(fs21.readFileSync(mcpJsonPath, "utf-8"));
+      if (mcpJson.mcpServers) {
+        for (const name of Object.keys(mcpJson.mcpServers)) {
+          items.push({
+            type: "mcp",
+            platform: "claude",
+            name,
+            contentHash: hashJson(mcpJson.mcpServers[name]),
+            path: mcpJsonPath
+          });
+        }
       }
-      console.log("");
+    } catch {
     }
-  } else if (hasExistingConfig) {
-    console.log(title.bold("  Step 3/5 \u2014 Improve your setup\n"));
-    console.log(chalk5.dim("  Reviewing your existing configs against your codebase"));
-    console.log(chalk5.dim("  and preparing improvements.\n"));
-  } else {
-    console.log(title.bold("  Step 3/5 \u2014 Build your agent setup\n"));
-    console.log(chalk5.dim("  Creating config files tailored to your project.\n"));
   }
-  console.log(chalk5.dim("  This can take a couple of minutes depending on your model and provider.\n"));
-  const genStartTime = Date.now();
-  const genSpinner = ora2("Generating setup...").start();
-  const genMessages = new SpinnerMessages(genSpinner, GENERATION_MESSAGES, { showElapsedTime: true });
-  genMessages.start();
-  let generatedSetup = null;
-  let rawOutput;
-  try {
-    const result = await generateSetup(
-      fingerprint,
-      targetAgent,
-      fingerprint.description,
-      {
-        onStatus: (status) => {
-          genMessages.handleServerStatus(status);
-        },
-        onComplete: (setup) => {
-          generatedSetup = setup;
-        },
-        onError: (error) => {
-          genMessages.stop();
-          genSpinner.fail(`Generation error: ${error}`);
-        }
-      },
-      failingChecks,
-      currentScore,
-      passingChecks
-    );
-    if (!generatedSetup) {
-      generatedSetup = result.setup;
-      rawOutput = result.raw;
-    }
-  } catch (err) {
-    genMessages.stop();
-    const msg = err instanceof Error ? err.message : "Unknown error";
-    genSpinner.fail(`Generation failed: ${msg}`);
-    throw new Error("__exit__");
+  const agentsMdPath = path17.join(dir, "AGENTS.md");
+  if (fs21.existsSync(agentsMdPath)) {
+    items.push({
+      type: "rule",
+      platform: "codex",
+      name: "AGENTS.md",
+      contentHash: hashFile(agentsMdPath),
+      path: agentsMdPath
+    });
   }
-  genMessages.stop();
-  if (!generatedSetup) {
-    genSpinner.fail("Failed to generate setup.");
-    if (rawOutput) {
-      console.log(chalk5.dim("\nRaw LLM output (JSON parse failed):"));
-      console.log(chalk5.dim(rawOutput.slice(0, 500)));
+  const codexSkillsDir = path17.join(dir, ".agents", "skills");
+  if (fs21.existsSync(codexSkillsDir)) {
+    try {
+      for (const name of fs21.readdirSync(codexSkillsDir)) {
+        const skillFile = path17.join(codexSkillsDir, name, "SKILL.md");
+        if (fs21.existsSync(skillFile)) {
+          items.push({
+            type: "skill",
+            platform: "codex",
+            name: `${name}/SKILL.md`,
+            contentHash: hashFile(skillFile),
+            path: skillFile
+          });
+        }
+      }
+    } catch {
     }
-    throw new Error("__exit__");
   }
-  const elapsedMs = Date.now() - genStartTime;
-  const mins = Math.floor(elapsedMs / 6e4);
-  const secs = Math.floor(elapsedMs % 6e4 / 1e3);
-  const timeStr = mins > 0 ? `${mins}m ${secs}s` : `${secs}s`;
-  genSpinner.succeed(`Setup generated ${chalk5.dim(`in ${timeStr}`)}`);
-  printSetupSummary(generatedSetup);
-  const sessionHistory = [];
-  sessionHistory.push({
-    role: "assistant",
-    content: summarizeSetup("Initial generation", generatedSetup)
-  });
-  console.log(title.bold("  Step 4/5 \u2014 Review and apply\n"));
-  const setupFiles = collectSetupFiles(generatedSetup);
-  const staged = stageFiles(setupFiles, process.cwd());
-  const totalChanges = staged.newFiles + staged.modifiedFiles;
-  console.log(chalk5.dim(`  ${chalk5.green(`${staged.newFiles} new`)} / ${chalk5.yellow(`${staged.modifiedFiles} modified`)} file${totalChanges !== 1 ? "s" : ""}
-`));
-  let action;
-  if (totalChanges === 0) {
-    console.log(chalk5.dim("  No changes needed \u2014 your configs are already up to date.\n"));
-    cleanupStaging();
-    action = "accept";
-  } else {
-    const wantsReview = await promptWantsReview();
-    if (wantsReview) {
-      const reviewMethod = await promptReviewMethod();
-      await openReview(reviewMethod, staged.stagedFiles);
-    }
-    action = await promptReviewAction();
+  const cursorrulesPath = path17.join(dir, ".cursorrules");
+  if (fs21.existsSync(cursorrulesPath)) {
+    items.push({
+      type: "rule",
+      platform: "cursor",
+      name: ".cursorrules",
+      contentHash: hashFile(cursorrulesPath),
+      path: cursorrulesPath
+    });
   }
-  while (action === "refine") {
-    generatedSetup = await refineLoop(generatedSetup, targetAgent, sessionHistory);
-    if (!generatedSetup) {
-      cleanupStaging();
-      console.log(chalk5.dim("Refinement cancelled. No files were modified."));
-      return;
+  const cursorRulesDir = path17.join(dir, ".cursor", "rules");
+  if (fs21.existsSync(cursorRulesDir)) {
+    for (const file of fs21.readdirSync(cursorRulesDir).filter((f) => f.endsWith(".mdc"))) {
+      const filePath = path17.join(cursorRulesDir, file);
+      items.push({
+        type: "rule",
+        platform: "cursor",
+        name: file,
+        contentHash: hashFile(filePath),
+        path: filePath
+      });
     }
-    const updatedFiles = collectSetupFiles(generatedSetup);
-    const restaged = stageFiles(updatedFiles, process.cwd());
-    console.log(chalk5.dim(`  ${chalk5.green(`${restaged.newFiles} new`)} / ${chalk5.yellow(`${restaged.modifiedFiles} modified`)} file${restaged.newFiles + restaged.modifiedFiles !== 1 ? "s" : ""}
-`));
-    printSetupSummary(generatedSetup);
-    await openReview("terminal", restaged.stagedFiles);
-    action = await promptReviewAction();
-  }
-  cleanupStaging();
-  if (action === "decline") {
-    console.log(chalk5.dim("Setup declined. No files were modified."));
-    return;
-  }
-  if (options.dryRun) {
-    console.log(chalk5.yellow("\n[Dry run] Would write the following files:"));
-    console.log(JSON.stringify(generatedSetup, null, 2));
-    return;
   }
-  const writeSpinner = ora2("Writing config files...").start();
-  try {
-    const result = writeSetup(generatedSetup);
-    writeSpinner.succeed("Config files written");
-    console.log(chalk5.bold("\nFiles created/updated:"));
-    for (const file of result.written) {
-      console.log(`  ${chalk5.green("\u2713")} ${file}`);
-    }
-    if (result.deleted.length > 0) {
-      console.log(chalk5.bold("\nFiles removed:"));
-      for (const file of result.deleted) {
-        console.log(`  ${chalk5.red("\u2717")} ${file}`);
+  const cursorSkillsDir = path17.join(dir, ".cursor", "skills");
+  if (fs21.existsSync(cursorSkillsDir)) {
+    try {
+      for (const name of fs21.readdirSync(cursorSkillsDir)) {
+        const skillFile = path17.join(cursorSkillsDir, name, "SKILL.md");
+        if (fs21.existsSync(skillFile)) {
+          items.push({
+            type: "skill",
+            platform: "cursor",
+            name: `${name}/SKILL.md`,
+            contentHash: hashFile(skillFile),
+            path: skillFile
+          });
+        }
       }
+    } catch {
     }
-    if (result.backupDir) {
-      console.log(chalk5.dim(`
-  Backups saved to ${result.backupDir}`));
-    }
-  } catch (err) {
-    writeSpinner.fail("Failed to write files");
-    console.error(chalk5.red(err instanceof Error ? err.message : "Unknown error"));
-    throw new Error("__exit__");
   }
-  console.log(title.bold("\n  Step 5/5 \u2014 Enhance with MCP servers\n"));
-  console.log(chalk5.dim("  MCP servers connect your AI agents to external tools and services"));
-  console.log(chalk5.dim("  like databases, APIs, and platforms your project depends on.\n"));
-  if (fingerprint.tools.length > 0) {
+  const cursorMcpPath = path17.join(dir, ".cursor", "mcp.json");
+  if (fs21.existsSync(cursorMcpPath)) {
     try {
-      const mcpResult = await discoverAndInstallMcps(targetAgent, fingerprint, process.cwd());
-      if (mcpResult.installed > 0) {
-        console.log(chalk5.bold(`
-  ${mcpResult.installed} MCP server${mcpResult.installed > 1 ? "s" : ""} configured`));
-        for (const name of mcpResult.names) {
-          console.log(`  ${chalk5.green("\u2713")} ${name}`);
+      const mcpJson = JSON.parse(fs21.readFileSync(cursorMcpPath, "utf-8"));
+      if (mcpJson.mcpServers) {
+        for (const name of Object.keys(mcpJson.mcpServers)) {
+          items.push({
+            type: "mcp",
+            platform: "cursor",
+            name,
+            contentHash: hashJson(mcpJson.mcpServers[name]),
+            path: cursorMcpPath
+          });
         }
       }
-    } catch (err) {
-      console.log(chalk5.dim("  MCP discovery skipped: " + (err instanceof Error ? err.message : "unknown error")));
+    } catch {
     }
-  } else {
-    console.log(chalk5.dim("  No external tools or services detected \u2014 skipping MCP discovery.\n"));
   }
-  ensurePermissions();
-  const sha = getCurrentHeadSha();
-  writeState({
-    lastRefreshSha: sha ?? "",
-    lastRefreshTimestamp: (/* @__PURE__ */ new Date()).toISOString(),
-    targetAgent
-  });
-  console.log("");
-  console.log(title.bold("  Keep your configs fresh\n"));
-  console.log(chalk5.dim("  Caliber can automatically update your agent configs when your code changes.\n"));
-  const hookChoice = await promptHookType(targetAgent);
-  if (hookChoice === "claude" || hookChoice === "both") {
-    const hookResult = installHook();
-    if (hookResult.installed) {
-      console.log(`  ${chalk5.green("\u2713")} Claude Code hook installed \u2014 docs update on session end`);
-      console.log(chalk5.dim("    Run ") + chalk5.hex("#83D1EB")("caliber hooks --remove") + chalk5.dim(" to disable"));
-    } else if (hookResult.alreadyInstalled) {
-      console.log(chalk5.dim("  Claude Code hook already installed"));
-    }
-    const learnResult = installLearningHooks();
-    if (learnResult.installed) {
-      console.log(`  ${chalk5.green("\u2713")} Learning hooks installed \u2014 session insights captured automatically`);
-      console.log(chalk5.dim("    Run ") + chalk5.hex("#83D1EB")("caliber learn remove") + chalk5.dim(" to disable"));
-    } else if (learnResult.alreadyInstalled) {
-      console.log(chalk5.dim("  Learning hooks already installed"));
-    }
+  return items;
+}
+function hashFile(filePath) {
+  const text = fs21.readFileSync(filePath, "utf-8");
+  return crypto2.createHash("sha256").update(JSON.stringify({ text })).digest("hex");
+}
+function hashJson(obj) {
+  return crypto2.createHash("sha256").update(JSON.stringify(obj)).digest("hex");
+}
+
+// src/commands/recommend.ts
+function detectLocalPlatforms() {
+  const items = scanLocalState(process.cwd());
+  const platforms = /* @__PURE__ */ new Set();
+  for (const item of items) {
+    platforms.add(item.platform);
   }
-  if (hookChoice === "precommit" || hookChoice === "both") {
-    const precommitResult = installPreCommitHook();
-    if (precommitResult.installed) {
-      console.log(`  ${chalk5.green("\u2713")} Pre-commit hook installed \u2014 docs refresh before each commit`);
-      console.log(chalk5.dim("    Run ") + chalk5.hex("#83D1EB")("caliber hooks --remove") + chalk5.dim(" to disable"));
-    } else if (precommitResult.alreadyInstalled) {
-      console.log(chalk5.dim("  Pre-commit hook already installed"));
-    } else {
-      console.log(chalk5.yellow("  Could not install pre-commit hook (not a git repository?)"));
-    }
+  return platforms.size > 0 ? Array.from(platforms) : ["claude"];
+}
+function getSkillPath(platform, slug) {
+  if (platform === "cursor") {
+    return join8(".cursor", "skills", slug, "SKILL.md");
   }
-  if (hookChoice === "skip") {
-    console.log(chalk5.dim("  Skipped auto-refresh hooks. Run ") + chalk5.hex("#83D1EB")("caliber hooks --install") + chalk5.dim(" later to enable."));
+  if (platform === "codex") {
+    return join8(".agents", "skills", slug, "SKILL.md");
   }
-  const afterScore = computeLocalScore(process.cwd(), targetAgent);
-  if (afterScore.score < baselineScore.score) {
-    console.log("");
-    console.log(chalk5.yellow(`  Score would drop from ${baselineScore.score} to ${afterScore.score} \u2014 reverting changes.`));
+  return join8(".claude", "skills", slug, "SKILL.md");
+}
+function getInstalledSkills() {
+  const installed = /* @__PURE__ */ new Set();
+  const dirs = [
+    join8(process.cwd(), ".claude", "skills"),
+    join8(process.cwd(), ".cursor", "skills"),
+    join8(process.cwd(), ".agents", "skills")
+  ];
+  for (const dir of dirs) {
     try {
-      const { restored, removed } = undoSetup();
-      if (restored.length > 0 || removed.length > 0) {
-        console.log(chalk5.dim(`  Reverted ${restored.length + removed.length} file${restored.length + removed.length === 1 ? "" : "s"} from backup.`));
+      const entries = readdirSync5(dir, { withFileTypes: true });
+      for (const entry of entries) {
+        if (entry.isDirectory()) {
+          installed.add(entry.name.toLowerCase());
+        }
       }
     } catch {
     }
-    console.log(chalk5.dim("  Run ") + chalk5.hex("#83D1EB")("caliber onboard --force") + chalk5.dim(" to override.\n"));
-    return;
   }
-  displayScoreDelta(baselineScore, afterScore);
-  console.log(chalk5.bold.green("  Onboarding complete! Your project is ready for AI-assisted development."));
-  console.log(chalk5.dim("  Run ") + chalk5.hex("#83D1EB")("caliber undo") + chalk5.dim(" to revert changes.\n"));
-  console.log(chalk5.bold("  Next steps:\n"));
-  console.log(`    ${title("caliber score")}        See your full config breakdown`);
-  console.log(`    ${title("caliber recommend")}    Discover community skills for your stack`);
-  console.log(`    ${title("caliber undo")}         Revert all changes from this run`);
-  console.log("");
+  return installed;
 }
-async function refineLoop(currentSetup, _targetAgent, sessionHistory) {
-  while (true) {
-    const message = await promptInput3("\nWhat would you like to change?");
-    if (!message || message.toLowerCase() === "done" || message.toLowerCase() === "accept") {
-      return currentSetup;
-    }
-    if (message.toLowerCase() === "cancel") {
-      return null;
-    }
-    const isValid = await classifyRefineIntent(message);
-    if (!isValid) {
-      console.log(chalk5.dim("  This doesn't look like a config change request."));
-      console.log(chalk5.dim("  Describe what to add, remove, or modify in your configs."));
-      console.log(chalk5.dim('  Type "done" to accept the current setup.\n'));
+async function searchSkillsSh(technologies) {
+  const bestBySlug = /* @__PURE__ */ new Map();
+  for (const tech of technologies) {
+    try {
+      const resp = await fetch(`https://skills.sh/api/search?q=${encodeURIComponent(tech)}&limit=10`, {
+        signal: AbortSignal.timeout(1e4)
+      });
+      if (!resp.ok) continue;
+      const data = await resp.json();
+      if (!data.skills?.length) continue;
+      for (const skill of data.skills) {
+        const existing = bestBySlug.get(skill.skillId);
+        if (existing && existing.installs >= (skill.installs ?? 0)) continue;
+        bestBySlug.set(skill.skillId, {
+          name: skill.name,
+          slug: skill.skillId,
+          source_url: skill.source ? `https://github.com/${skill.source}` : "",
+          score: 0,
+          reason: skill.description || "",
+          detected_technology: tech,
+          item_type: "skill",
+          installs: skill.installs ?? 0
+        });
+      }
+    } catch {
       continue;
     }
-    const refineSpinner = ora2("Refining setup...").start();
-    const refineMessages = new SpinnerMessages(refineSpinner, REFINE_MESSAGES);
-    refineMessages.start();
-    const refined = await refineSetup(
-      currentSetup,
-      message,
-      sessionHistory
-    );
-    refineMessages.stop();
-    if (refined) {
-      currentSetup = refined;
-      sessionHistory.push({ role: "user", content: message });
-      sessionHistory.push({
-        role: "assistant",
-        content: summarizeSetup("Applied changes", refined)
+  }
+  return Array.from(bestBySlug.values());
+}
+async function searchTessl(technologies) {
+  const results = [];
+  const seen = /* @__PURE__ */ new Set();
+  for (const tech of technologies) {
+    try {
+      const resp = await fetch(`https://tessl.io/registry?q=${encodeURIComponent(tech)}`, {
+        signal: AbortSignal.timeout(1e4)
       });
-      refineSpinner.succeed("Setup updated");
-      printSetupSummary(refined);
-      console.log(chalk5.dim('Type "done" to accept, or describe more changes.'));
-    } else {
-      refineSpinner.fail("Refinement failed \u2014 could not parse AI response.");
-      console.log(chalk5.dim('Try rephrasing your request, or type "done" to keep the current setup.'));
+      if (!resp.ok) continue;
+      const html = await resp.text();
+      const linkMatches = html.matchAll(/\/registry\/skills\/github\/([^/]+)\/([^/]+)\/([^/"]+)/g);
+      for (const match of linkMatches) {
+        const [, org, repo, skillName] = match;
+        const slug = `${org}-${repo}-${skillName}`.toLowerCase();
+        if (seen.has(slug)) continue;
+        seen.add(slug);
+        results.push({
+          name: skillName,
+          slug,
+          source_url: `https://github.com/${org}/${repo}`,
+          score: 0,
+          reason: `Skill from ${org}/${repo}`,
+          detected_technology: tech,
+          item_type: "skill"
+        });
+      }
+    } catch {
+      continue;
     }
   }
+  return results;
 }
-function summarizeSetup(action, setup) {
-  const descriptions = setup.fileDescriptions;
-  const files = descriptions ? Object.entries(descriptions).map(([path24, desc]) => `  ${path24}: ${desc}`).join("\n") : Object.keys(setup).filter((k) => k !== "targetAgent" && k !== "fileDescriptions").join(", ");
-  return `${action}. Files:
-${files}`;
-}
-async function classifyRefineIntent(message) {
-  const fastModel = getFastModel();
+var AWESOME_CLAUDE_CODE_URL = "https://raw.githubusercontent.com/hesreallyhim/awesome-claude-code/main/README.md";
+async function searchAwesomeClaudeCode(technologies) {
   try {
-    const result = await llmJsonCall({
-      system: `You classify whether a user message is a valid request to modify AI agent config files (CLAUDE.md, .cursorrules, skills).
-Valid: requests to add, remove, change, or restructure config content. Examples: "add testing commands", "remove the terraform section", "make CLAUDE.md shorter".
-Invalid: questions, requests to show/display something, general chat, or anything that isn't a concrete config change.
-Return {"valid": true} or {"valid": false}. Nothing else.`,
-      prompt: message,
-      maxTokens: 20,
-      ...fastModel ? { model: fastModel } : {}
+    const resp = await fetch(AWESOME_CLAUDE_CODE_URL, {
+      signal: AbortSignal.timeout(1e4)
     });
-    return result.valid === true;
-  } catch {
-    return true;
-  }
-}
-async function evaluateDismissals(failingChecks, fingerprint) {
-  const fastModel = getFastModel();
-  const checkList = failingChecks.map((c) => ({
-    id: c.id,
-    name: c.name,
-    suggestion: c.suggestion
-  }));
-  try {
-    const result = await llmJsonCall({
-      system: `You evaluate whether scoring checks are applicable to a project.
-Given the project's languages/frameworks and a list of failing checks, return which checks are NOT applicable.
-
-Only dismiss checks that truly don't apply \u2014 e.g. "Build/test/lint commands" for a pure Terraform/HCL repo with no build system.
-Do NOT dismiss checks that could reasonably apply even if the project doesn't use them yet.
-
-Return {"dismissed": [{"id": "check_id", "reason": "brief reason"}]} or {"dismissed": []} if all apply.`,
-      prompt: `Languages: ${fingerprint.languages.join(", ") || "none"}
-Frameworks: ${fingerprint.frameworks.join(", ") || "none"}
-
-Failing checks:
-${JSON.stringify(checkList, null, 2)}`,
-      maxTokens: 200,
-      ...fastModel ? { model: fastModel } : {}
+    if (!resp.ok) return [];
+    const markdown = await resp.text();
+    const items = [];
+    const itemPattern = /^[-*]\s+\[([^\]]+)\]\(([^)]+)\)(?:\s+by\s+\[[^\]]*\]\([^)]*\))?\s*[-–—:]\s*(.*)/gm;
+    let match;
+    while ((match = itemPattern.exec(markdown)) !== null) {
+      const [, name, url, description] = match;
+      if (url.startsWith("#")) continue;
+      const slug = name.toLowerCase().replace(/[^a-z0-9]+/g, "-").replace(/^-|-$/g, "");
+      items.push({
+        name: name.trim(),
+        slug,
+        source_url: url.trim(),
+        score: 0,
+        reason: description.trim().slice(0, 150),
+        detected_technology: "claude-code",
+        item_type: "skill"
+      });
+    }
+    const techLower = technologies.map((t) => t.toLowerCase());
+    return items.filter((item) => {
+      const text = `${item.name} ${item.reason}`.toLowerCase();
+      return techLower.some((t) => text.includes(t));
     });
-    if (!Array.isArray(result.dismissed)) return [];
-    return result.dismissed.filter((d) => d.id && d.reason && failingChecks.some((c) => c.id === d.id)).map((d) => ({ id: d.id, reason: d.reason, dismissedAt: (/* @__PURE__ */ new Date()).toISOString() }));
   } catch {
     return [];
   }
 }
-function promptInput3(question) {
-  const rl = readline4.createInterface({ input: process.stdin, output: process.stdout });
-  return new Promise((resolve2) => {
-    rl.question(chalk5.cyan(`${question} `), (answer) => {
-      rl.close();
-      resolve2(answer.trim());
-    });
-  });
+async function searchAllProviders(technologies, platform) {
+  const searches = [
+    searchSkillsSh(technologies),
+    searchTessl(technologies)
+  ];
+  if (platform === "claude" || !platform) {
+    searches.push(searchAwesomeClaudeCode(technologies));
+  }
+  const results = await Promise.all(searches);
+  const seen = /* @__PURE__ */ new Set();
+  const combined = [];
+  for (const batch of results) {
+    for (const result of batch) {
+      const key = result.name.toLowerCase().replace(/[-_]/g, "");
+      if (seen.has(key)) continue;
+      seen.add(key);
+      combined.push(result);
+    }
+  }
+  return combined;
 }
-async function promptAgent() {
-  const selected = await checkbox({
-    message: "Which coding agents do you use? (toggle with space)",
-    choices: [
-      { name: "Claude Code", value: "claude" },
-      { name: "Cursor", value: "cursor" },
-      { name: "Codex (OpenAI)", value: "codex" }
-    ],
-    validate: (items) => {
-      if (items.length === 0) return "At least one agent must be selected";
-      return true;
-    }
+async function scoreWithLLM2(candidates, projectContext, technologies) {
+  const candidateList = candidates.map((c, i) => `${i}. "${c.name}" \u2014 ${c.reason || "no description"}`).join("\n");
+  const scored = await llmJsonCall({
+    system: `You evaluate whether AI agent skills and tools are relevant to a specific software project.
+Given a project context and a list of candidates, score each one's relevance from 0-100 and provide a brief reason (max 80 chars).
+
+Return a JSON array where each element has:
+- "index": the candidate's index number
+- "score": relevance score 0-100
+- "reason": one-liner explaining why it fits or doesn't
+
+Scoring guidelines:
+- 90-100: Directly matches a core technology or workflow in the project
+- 70-89: Relevant to the project's stack, patterns, or development workflow
+- 50-69: Tangentially related or generic but useful
+- 0-49: Not relevant to this project
+
+Be selective. Prefer specific, high-quality matches over generic ones.
+A skill for "React testing" is only relevant if the project uses React.
+A generic "TypeScript best practices" skill is less valuable than one targeting the project's actual framework.
+Return ONLY the JSON array.`,
+    prompt: `PROJECT CONTEXT:
+${projectContext}
+
+DETECTED TECHNOLOGIES:
+${technologies.join(", ")}
+
+CANDIDATES:
+${candidateList}`,
+    maxTokens: 8e3
   });
-  return selected;
+  if (!Array.isArray(scored)) return [];
+  return scored.filter((s) => s.score >= 60 && s.index >= 0 && s.index < candidates.length).sort((a, b) => b.score - a.score).slice(0, 20).map((s) => ({
+    ...candidates[s.index],
+    score: s.score,
+    reason: s.reason || candidates[s.index].reason
+  }));
 }
-async function promptHookType(targetAgent) {
-  const choices = [];
-  const hasClaude = targetAgent.includes("claude");
-  if (hasClaude) {
-    choices.push({ name: "Claude Code hook (auto-refresh on session end)", value: "claude" });
+function buildProjectContext(dir) {
+  const parts = [];
+  const fingerprint = collectFingerprint(dir);
+  if (fingerprint.packageName) parts.push(`Package: ${fingerprint.packageName}`);
+  if (fingerprint.languages.length > 0) parts.push(`Languages: ${fingerprint.languages.join(", ")}`);
+  if (fingerprint.frameworks.length > 0) parts.push(`Frameworks: ${fingerprint.frameworks.join(", ")}`);
+  if (fingerprint.description) parts.push(`Description: ${fingerprint.description}`);
+  if (fingerprint.fileTree.length > 0) {
+    parts.push(`
+File tree (${fingerprint.fileTree.length} files):
+${fingerprint.fileTree.slice(0, 50).join("\n")}`);
   }
-  choices.push({ name: "Git pre-commit hook (refresh before each commit)", value: "precommit" });
-  if (hasClaude) {
-    choices.push({ name: "Both (Claude Code + pre-commit)", value: "both" });
+  if (fingerprint.existingConfigs.claudeMd) {
+    parts.push(`
+Existing CLAUDE.md (first 500 chars):
+${fingerprint.existingConfigs.claudeMd.slice(0, 500)}`);
   }
-  choices.push({ name: "Skip for now", value: "skip" });
-  return select2({
-    message: "How would you like to auto-refresh your docs?",
-    choices
-  });
+  const deps = extractTopDeps();
+  if (deps.length > 0) {
+    parts.push(`
+Dependencies: ${deps.slice(0, 30).join(", ")}`);
+  }
+  const installed = getInstalledSkills();
+  if (installed.size > 0) {
+    parts.push(`
+Already installed skills: ${Array.from(installed).join(", ")}`);
+  }
+  return parts.join("\n");
 }
-async function promptWantsReview() {
-  const answer = await select2({
-    message: "Would you like to review the diffs before deciding?",
+function extractTopDeps() {
+  const pkgPath = join8(process.cwd(), "package.json");
+  if (!existsSync9(pkgPath)) return [];
+  try {
+    const pkg3 = JSON.parse(readFileSync7(pkgPath, "utf-8"));
+    const deps = Object.keys(pkg3.dependencies ?? {});
+    const trivial = /* @__PURE__ */ new Set([
+      "typescript",
+      "tslib",
+      "ts-node",
+      "tsx",
+      "prettier",
+      "eslint",
+      "@eslint/js",
+      "rimraf",
+      "cross-env",
+      "dotenv",
+      "nodemon",
+      "husky",
+      "lint-staged",
+      "commitlint",
+      "chalk",
+      "ora",
+      "commander",
+      "yargs",
+      "meow",
+      "inquirer",
+      "@inquirer/confirm",
+      "@inquirer/select",
+      "@inquirer/prompts",
+      "glob",
+      "minimatch",
+      "micromatch",
+      "diff",
+      "semver",
+      "uuid",
+      "nanoid",
+      "debug",
+      "ms",
+      "lodash",
+      "underscore",
+      "tsup",
+      "esbuild",
+      "rollup",
+      "webpack",
+      "vite",
+      "vitest",
+      "jest",
+      "mocha",
+      "chai",
+      "ava",
+      "fs-extra",
+      "mkdirp",
+      "del",
+      "rimraf",
+      "path-to-regexp",
+      "strip-ansi",
+      "ansi-colors"
+    ]);
+    const trivialPatterns = [
+      /^@types\//,
+      /^@rely-ai\//,
+      /^@caliber-ai\//,
+      /^eslint-/,
+      /^@eslint\//,
+      /^prettier-/,
+      /^@typescript-eslint\//,
+      /^@commitlint\//
+    ];
+    return deps.filter(
+      (d) => !trivial.has(d) && !trivialPatterns.some((p) => p.test(d))
+    );
+  } catch {
+    return [];
+  }
+}
+async function recommendCommand() {
+  const proceed = await select3({
+    message: "Search public repos for relevant skills to add to this project?",
     choices: [
-      { name: "Yes, show me the diffs", value: true },
-      { name: "No, continue", value: false }
+      { name: "Yes, find skills for my project", value: true },
+      { name: "No, cancel", value: false }
     ]
   });
-  return answer;
-}
-async function promptReviewMethod() {
-  const available = detectAvailableEditors();
-  if (available.length === 1) return "terminal";
-  const choices = available.map((method) => {
-    switch (method) {
-      case "cursor":
-        return { name: "Cursor (diff view)", value: "cursor" };
-      case "vscode":
-        return { name: "VS Code (diff view)", value: "vscode" };
-      case "terminal":
-        return { name: "Terminal", value: "terminal" };
-    }
-  });
-  return select2({ message: "How would you like to review the changes?", choices });
-}
-async function openReview(method, stagedFiles) {
-  if (method === "cursor" || method === "vscode") {
-    openDiffsInEditor(method, stagedFiles.map((f) => ({
-      originalPath: f.originalPath,
-      proposedPath: f.proposedPath
-    })));
-    console.log(chalk5.dim("  Diffs opened in your editor.\n"));
+  if (!proceed) {
+    console.log(chalk6.dim("  Cancelled.\n"));
     return;
   }
-  const fileInfos = stagedFiles.map((file) => {
-    const proposed = fs20.readFileSync(file.proposedPath, "utf-8");
-    const current = file.currentPath ? fs20.readFileSync(file.currentPath, "utf-8") : "";
-    const patch = createTwoFilesPatch(
-      file.isNew ? "/dev/null" : file.relativePath,
-      file.relativePath,
-      current,
-      proposed
-    );
-    let added = 0, removed = 0;
-    for (const line of patch.split("\n")) {
-      if (line.startsWith("+") && !line.startsWith("+++")) added++;
-      if (line.startsWith("-") && !line.startsWith("---")) removed++;
-    }
-    return {
-      relativePath: file.relativePath,
-      isNew: file.isNew,
-      added,
-      removed,
-      lines: proposed.split("\n").length,
-      patch
-    };
-  });
-  await interactiveDiffExplorer(fileInfos);
+  await searchAndInstallSkills();
 }
-async function interactiveDiffExplorer(files) {
-  if (!process.stdin.isTTY) {
-    for (const f of files) {
-      const icon = f.isNew ? chalk5.green("+") : chalk5.yellow("~");
-      const stats = f.isNew ? chalk5.dim(`${f.lines} lines`) : `${chalk5.green(`+${f.added}`)} ${chalk5.red(`-${f.removed}`)}`;
-      console.log(`    ${icon} ${f.relativePath}  ${stats}`);
-    }
-    console.log("");
-    return;
+async function searchAndInstallSkills() {
+  const fingerprint = collectFingerprint(process.cwd());
+  const platforms = detectLocalPlatforms();
+  const installedSkills = getInstalledSkills();
+  const technologies = [...new Set([
+    ...fingerprint.languages,
+    ...fingerprint.frameworks,
+    ...extractTopDeps()
+  ].filter(Boolean))];
+  if (technologies.length === 0) {
+    console.log(chalk6.yellow("Could not detect any languages or dependencies. Try running from a project root."));
+    throw new Error("__exit__");
   }
-  const { stdin, stdout } = process;
-  let cursor = 0;
-  let viewing = null;
-  let scrollOffset = 0;
-  let lineCount = 0;
-  function getTermHeight() {
-    return (stdout.rows || 24) - 4;
+  const primaryPlatform = platforms.includes("claude") ? "claude" : platforms[0];
+  const searchSpinner = ora2("Searching skill registries...").start();
+  const allCandidates = await searchAllProviders(technologies, primaryPlatform);
+  if (!allCandidates.length) {
+    searchSpinner.succeed("No skills found matching your tech stack.");
+    return;
   }
-  function renderFileList() {
-    const lines = [];
-    lines.push(chalk5.bold("  Review changes"));
-    lines.push("");
-    for (let i = 0; i < files.length; i++) {
-      const f = files[i];
-      const ptr = i === cursor ? chalk5.cyan(">") : " ";
-      const icon = f.isNew ? chalk5.green("+") : chalk5.yellow("~");
-      const stats = f.isNew ? chalk5.dim(`${f.lines} lines`) : `${chalk5.green(`+${f.added}`)} ${chalk5.red(`-${f.removed}`)}`;
-      lines.push(`  ${ptr} ${icon} ${f.relativePath}  ${stats}`);
-    }
-    lines.push("");
-    lines.push(chalk5.dim("  \u2191\u2193 navigate  \u23CE view diff  q done"));
-    return lines.join("\n");
+  const newCandidates = allCandidates.filter((c) => !installedSkills.has(c.slug.toLowerCase()));
+  const filteredCount = allCandidates.length - newCandidates.length;
+  if (!newCandidates.length) {
+    searchSpinner.succeed(`Found ${allCandidates.length} skills \u2014 all already installed.`);
+    return;
   }
-  function renderDiff(index) {
-    const f = files[index];
+  searchSpinner.succeed(
+    `Found ${allCandidates.length} skills` + (filteredCount > 0 ? chalk6.dim(` (${filteredCount} already installed)`) : "")
+  );
+  let results;
+  const config = loadConfig();
+  if (config) {
+    const scoreSpinner = ora2("Scoring relevance for your project...").start();
+    try {
+      const projectContext = buildProjectContext(process.cwd());
+      results = await scoreWithLLM2(newCandidates, projectContext, technologies);
+      if (results.length === 0) {
+        scoreSpinner.succeed("No highly relevant skills found for your specific project.");
+        return;
+      }
+      scoreSpinner.succeed(`${results.length} relevant skill${results.length > 1 ? "s" : ""} for your project`);
+    } catch {
+      scoreSpinner.warn("Could not score relevance \u2014 showing top results");
+      results = newCandidates.slice(0, 20);
+    }
+  } else {
+    results = newCandidates.slice(0, 20);
+  }
+  const fetchSpinner = ora2("Verifying skill availability...").start();
+  const contentMap = /* @__PURE__ */ new Map();
+  await Promise.all(results.map(async (rec) => {
+    const content = await fetchSkillContent(rec);
+    if (content) contentMap.set(rec.slug, content);
+  }));
+  const available = results.filter((r) => contentMap.has(r.slug));
+  if (!available.length) {
+    fetchSpinner.fail("No installable skills found \u2014 content could not be fetched.");
+    return;
+  }
+  const unavailableCount = results.length - available.length;
+  fetchSpinner.succeed(
+    `${available.length} installable skill${available.length > 1 ? "s" : ""}` + (unavailableCount > 0 ? chalk6.dim(` (${unavailableCount} unavailable)`) : "")
+  );
+  const selected = await interactiveSelect2(available);
+  if (selected?.length) {
+    await installSkills(selected, platforms, contentMap);
+  }
+}
+async function interactiveSelect2(recs) {
+  if (!process.stdin.isTTY) {
+    printSkills(recs);
+    return null;
+  }
+  const selected = /* @__PURE__ */ new Set();
+  let cursor = 0;
+  const { stdin, stdout } = process;
+  let lineCount = 0;
+  const hasScores = recs.some((r) => r.score > 0);
+  function render() {
     const lines = [];
-    const header = f.isNew ? `  ${chalk5.green("+")} ${f.relativePath} ${chalk5.dim("(new file)")}` : `  ${chalk5.yellow("~")} ${f.relativePath} ${chalk5.green(`+${f.added}`)} ${chalk5.red(`-${f.removed}`)}`;
-    lines.push(header);
-    lines.push(chalk5.dim("  " + "\u2500".repeat(60)));
-    const patchLines = f.patch.split("\n");
-    const bodyLines = patchLines.slice(4);
-    const maxVisible = getTermHeight() - 4;
-    const visibleLines = bodyLines.slice(scrollOffset, scrollOffset + maxVisible);
-    for (const line of visibleLines) {
-      if (line.startsWith("+")) {
-        lines.push(chalk5.green("  " + line));
-      } else if (line.startsWith("-")) {
-        lines.push(chalk5.red("  " + line));
-      } else if (line.startsWith("@@")) {
-        lines.push(chalk5.cyan("  " + line));
+    lines.push(chalk6.bold("  Skills"));
+    lines.push("");
+    if (hasScores) {
+      lines.push(`  ${chalk6.dim("Score".padEnd(7))} ${chalk6.dim("Name".padEnd(28))} ${chalk6.dim("Why")}`);
+    } else {
+      lines.push(`  ${chalk6.dim("Name".padEnd(30))} ${chalk6.dim("Technology".padEnd(18))} ${chalk6.dim("Source")}`);
+    }
+    lines.push(chalk6.dim("  " + "\u2500".repeat(70)));
+    for (let i = 0; i < recs.length; i++) {
+      const rec = recs[i];
+      const check = selected.has(i) ? chalk6.green("[x]") : "[ ]";
+      const ptr = i === cursor ? chalk6.cyan(">") : " ";
+      if (hasScores) {
+        const scoreColor = rec.score >= 90 ? chalk6.green : rec.score >= 70 ? chalk6.yellow : chalk6.dim;
+        lines.push(`  ${ptr} ${check} ${scoreColor(String(rec.score).padStart(3))}   ${rec.name.padEnd(26)} ${chalk6.dim(rec.reason.slice(0, 40))}`);
       } else {
-        lines.push(chalk5.dim("  " + line));
+        lines.push(`  ${ptr} ${check} ${rec.name.padEnd(28)} ${rec.detected_technology.padEnd(16)} ${chalk6.dim(rec.source_url || "")}`);
       }
     }
-    const totalBody = bodyLines.length;
-    if (totalBody > maxVisible) {
-      const pct = Math.round((scrollOffset + maxVisible) / totalBody * 100);
-      lines.push(chalk5.dim(`  \u2500\u2500 ${Math.min(pct, 100)}% \u2500\u2500`));
-    }
     lines.push("");
-    lines.push(chalk5.dim("  \u2191\u2193 scroll  \u23B5/esc back to file list"));
+    lines.push(chalk6.dim("  \u2191\u2193 navigate  \u23B5 toggle  a all  n none  \u23CE install  q cancel"));
     return lines.join("\n");
   }
   function draw(initial) {
@@ -5018,7 +5215,7 @@ async function interactiveDiffExplorer(files) {
       stdout.write(`\x1B[${lineCount}A`);
     }
     stdout.write("\x1B[0J");
-    const output = viewing !== null ? renderDiff(viewing) : renderFileList();
+    const output = render();
     stdout.write(output + "\n");
     lineCount = output.split("\n").length;
   }
@@ -5034,292 +5231,261 @@ async function interactiveDiffExplorer(files) {
       stdin.pause();
     }
     function onData(key) {
-      if (viewing !== null) {
-        const f = files[viewing];
-        const totalBody = f.patch.split("\n").length - 4;
-        const maxVisible = getTermHeight() - 4;
-        switch (key) {
-          case "\x1B[A":
-            scrollOffset = Math.max(0, scrollOffset - 1);
-            draw(false);
-            break;
-          case "\x1B[B":
-            scrollOffset = Math.min(Math.max(0, totalBody - maxVisible), scrollOffset + 1);
-            draw(false);
-            break;
-          case " ":
-          case "\x1B":
-            viewing = null;
-            scrollOffset = 0;
-            draw(false);
-            break;
-          case "q":
-          case "":
-            cleanup();
-            console.log("");
-            resolve2();
-            break;
-        }
-      } else {
-        switch (key) {
-          case "\x1B[A":
-            cursor = (cursor - 1 + files.length) % files.length;
-            draw(false);
-            break;
-          case "\x1B[B":
-            cursor = (cursor + 1) % files.length;
-            draw(false);
-            break;
-          case "\r":
-          case "\n":
-            viewing = cursor;
-            scrollOffset = 0;
-            draw(false);
-            break;
-          case "q":
-          case "":
-            cleanup();
-            console.log("");
-            resolve2();
-            break;
-        }
+      switch (key) {
+        case "\x1B[A":
+          cursor = (cursor - 1 + recs.length) % recs.length;
+          draw(false);
+          break;
+        case "\x1B[B":
+          cursor = (cursor + 1) % recs.length;
+          draw(false);
+          break;
+        case " ":
+          selected.has(cursor) ? selected.delete(cursor) : selected.add(cursor);
+          draw(false);
+          break;
+        case "a":
+          recs.forEach((_, i) => selected.add(i));
+          draw(false);
+          break;
+        case "n":
+          selected.clear();
+          draw(false);
+          break;
+        case "\r":
+        case "\n":
+          cleanup();
+          if (selected.size === 0) {
+            console.log(chalk6.dim("\n  No skills selected.\n"));
+            resolve2(null);
+          } else {
+            resolve2(Array.from(selected).sort().map((i) => recs[i]));
+          }
+          break;
+        case "q":
+        case "\x1B":
+        case "":
+          cleanup();
+          console.log(chalk6.dim("\n  Cancelled.\n"));
+          resolve2(null);
+          break;
       }
     }
     stdin.on("data", onData);
   });
 }
-async function promptReviewAction() {
-  return select2({
-    message: "What would you like to do?",
-    choices: [
-      { name: "Accept and apply", value: "accept" },
-      { name: "Refine via chat", value: "refine" },
-      { name: "Decline", value: "decline" }
-    ]
-  });
-}
-function printSetupSummary(setup) {
-  const claude = setup.claude;
-  const cursor = setup.cursor;
-  const fileDescriptions = setup.fileDescriptions;
-  const deletions = setup.deletions;
-  console.log("");
-  console.log(chalk5.bold("  Proposed changes:\n"));
-  const getDescription = (filePath) => {
-    return fileDescriptions?.[filePath];
-  };
-  if (claude) {
-    if (claude.claudeMd) {
-      const icon = fs20.existsSync("CLAUDE.md") ? chalk5.yellow("~") : chalk5.green("+");
-      const desc = getDescription("CLAUDE.md");
-      console.log(`  ${icon} ${chalk5.bold("CLAUDE.md")}`);
-      if (desc) console.log(chalk5.dim(`    ${desc}`));
-      console.log("");
-    }
-    const skills = claude.skills;
-    if (Array.isArray(skills) && skills.length > 0) {
-      for (const skill of skills) {
-        const skillPath = `.claude/skills/${skill.name}/SKILL.md`;
-        const icon = fs20.existsSync(skillPath) ? chalk5.yellow("~") : chalk5.green("+");
-        const desc = getDescription(skillPath);
-        console.log(`  ${icon} ${chalk5.bold(skillPath)}`);
-        console.log(chalk5.dim(`    ${desc || skill.description || skill.name}`));
-        console.log("");
+async function fetchSkillContent(rec) {
+  if (!rec.source_url) return null;
+  const repoPath = rec.source_url.replace("https://github.com/", "");
+  const candidates = [
+    `https://raw.githubusercontent.com/${repoPath}/HEAD/skills/${rec.slug}/SKILL.md`,
+    `https://raw.githubusercontent.com/${repoPath}/HEAD/${rec.slug}/SKILL.md`,
+    `https://raw.githubusercontent.com/${repoPath}/HEAD/.claude/skills/${rec.slug}/SKILL.md`,
+    `https://raw.githubusercontent.com/${repoPath}/HEAD/.agents/skills/${rec.slug}/SKILL.md`
+  ];
+  for (const url of candidates) {
+    try {
+      const resp = await fetch(url, { signal: AbortSignal.timeout(1e4) });
+      if (resp.ok) {
+        const text = await resp.text();
+        if (text.length > 20) return text;
       }
+    } catch {
     }
   }
-  const codex = setup.codex;
-  if (codex) {
-    if (codex.agentsMd) {
-      const icon = fs20.existsSync("AGENTS.md") ? chalk5.yellow("~") : chalk5.green("+");
-      const desc = getDescription("AGENTS.md");
-      console.log(`  ${icon} ${chalk5.bold("AGENTS.md")}`);
-      if (desc) console.log(chalk5.dim(`    ${desc}`));
-      console.log("");
-    }
-    const codexSkills = codex.skills;
-    if (Array.isArray(codexSkills) && codexSkills.length > 0) {
-      for (const skill of codexSkills) {
-        const skillPath = `.agents/skills/${skill.name}/SKILL.md`;
-        const icon = fs20.existsSync(skillPath) ? chalk5.yellow("~") : chalk5.green("+");
-        const desc = getDescription(skillPath);
-        console.log(`  ${icon} ${chalk5.bold(skillPath)}`);
-        console.log(chalk5.dim(`    ${desc || skill.description || skill.name}`));
-        console.log("");
+  try {
+    const resp = await fetch(
+      `https://api.github.com/repos/${repoPath}/git/trees/HEAD?recursive=1`,
+      { signal: AbortSignal.timeout(1e4) }
+    );
+    if (resp.ok) {
+      const tree = await resp.json();
+      const needle = `${rec.slug}/SKILL.md`;
+      const match = tree.tree?.find((f) => f.path.endsWith(needle));
+      if (match) {
+        const rawUrl = `https://raw.githubusercontent.com/${repoPath}/HEAD/${match.path}`;
+        const contentResp = await fetch(rawUrl, { signal: AbortSignal.timeout(1e4) });
+        if (contentResp.ok) return await contentResp.text();
       }
     }
+  } catch {
   }
-  if (cursor) {
-    if (cursor.cursorrules) {
-      const icon = fs20.existsSync(".cursorrules") ? chalk5.yellow("~") : chalk5.green("+");
-      const desc = getDescription(".cursorrules");
-      console.log(`  ${icon} ${chalk5.bold(".cursorrules")}`);
-      if (desc) console.log(chalk5.dim(`    ${desc}`));
-      console.log("");
+  return null;
+}
+async function installSkills(recs, platforms, contentMap) {
+  const spinner = ora2(`Installing ${recs.length} skill${recs.length > 1 ? "s" : ""}...`).start();
+  const installed = [];
+  for (const rec of recs) {
+    const content = contentMap.get(rec.slug);
+    if (!content) continue;
+    for (const platform of platforms) {
+      const skillPath = getSkillPath(platform, rec.slug);
+      const fullPath = join8(process.cwd(), skillPath);
+      mkdirSync(dirname2(fullPath), { recursive: true });
+      writeFileSync(fullPath, content, "utf-8");
+      installed.push(`[${platform}] ${skillPath}`);
     }
-    const cursorSkills = cursor.skills;
-    if (Array.isArray(cursorSkills) && cursorSkills.length > 0) {
-      for (const skill of cursorSkills) {
-        const skillPath = `.cursor/skills/${skill.name}/SKILL.md`;
-        const icon = fs20.existsSync(skillPath) ? chalk5.yellow("~") : chalk5.green("+");
-        const desc = getDescription(skillPath);
-        console.log(`  ${icon} ${chalk5.bold(skillPath)}`);
-        console.log(chalk5.dim(`    ${desc || skill.description || skill.name}`));
-        console.log("");
-      }
-    }
-    const rules = cursor.rules;
-    if (Array.isArray(rules) && rules.length > 0) {
-      for (const rule of rules) {
-        const rulePath = `.cursor/rules/${rule.filename}`;
-        const icon = fs20.existsSync(rulePath) ? chalk5.yellow("~") : chalk5.green("+");
-        const desc = getDescription(rulePath);
-        console.log(`  ${icon} ${chalk5.bold(rulePath)}`);
-        if (desc) {
-          console.log(chalk5.dim(`    ${desc}`));
-        } else {
-          const firstLine = rule.content.split("\n").filter((l) => l.trim() && !l.trim().startsWith("#"))[0];
-          if (firstLine) console.log(chalk5.dim(`    ${firstLine.trim().slice(0, 80)}`));
-        }
-        console.log("");
-      }
-    }
-  }
-  if (!codex && !fs20.existsSync("AGENTS.md")) {
-    console.log(`  ${chalk5.green("+")} ${chalk5.bold("AGENTS.md")}`);
-    console.log(chalk5.dim("    Cross-agent coordination file"));
-    console.log("");
-  }
-  if (Array.isArray(deletions) && deletions.length > 0) {
-    for (const del of deletions) {
-      console.log(`  ${chalk5.red("-")} ${chalk5.bold(del.filePath)}`);
-      console.log(chalk5.dim(`    ${del.reason}`));
-      console.log("");
+  }
+  if (installed.length > 0) {
+    spinner.succeed(`Installed ${installed.length} file${installed.length > 1 ? "s" : ""}`);
+    for (const p of installed) {
+      console.log(chalk6.green(`  \u2713 ${p}`));
     }
+  } else {
+    spinner.fail("No skills were installed");
   }
-  console.log(`  ${chalk5.green("+")} ${chalk5.dim("new")}  ${chalk5.yellow("~")} ${chalk5.dim("modified")}  ${chalk5.red("-")} ${chalk5.dim("removed")}`);
   console.log("");
 }
-function ensurePermissions() {
-  const settingsPath = ".claude/settings.json";
-  let settings = {};
-  try {
-    if (fs20.existsSync(settingsPath)) {
-      settings = JSON.parse(fs20.readFileSync(settingsPath, "utf-8"));
-    }
-  } catch {
-  }
-  const permissions = settings.permissions ?? {};
-  const allow = permissions.allow;
-  if (Array.isArray(allow) && allow.length > 0) return;
-  permissions.allow = [
-    "Bash(npm run *)",
-    "Bash(npx vitest *)",
-    "Bash(npx tsc *)",
-    "Bash(git *)"
-  ];
-  settings.permissions = permissions;
-  if (!fs20.existsSync(".claude")) fs20.mkdirSync(".claude", { recursive: true });
-  fs20.writeFileSync(settingsPath, JSON.stringify(settings, null, 2) + "\n");
-}
-
-// src/commands/undo.ts
-import chalk6 from "chalk";
-import ora3 from "ora";
-function undoCommand() {
-  const spinner = ora3("Reverting setup...").start();
-  try {
-    const { restored, removed } = undoSetup();
-    if (restored.length === 0 && removed.length === 0) {
-      spinner.info("Nothing to undo.");
-      return;
-    }
-    spinner.succeed("Setup reverted successfully.\n");
-    if (restored.length > 0) {
-      console.log(chalk6.cyan("  Restored from backup:"));
-      for (const file of restored) {
-        console.log(`    ${chalk6.green("\u21A9")} ${file}`);
-      }
-    }
-    if (removed.length > 0) {
-      console.log(chalk6.cyan("  Removed:"));
-      for (const file of removed) {
-        console.log(`    ${chalk6.red("\u2717")} ${file}`);
-      }
-    }
-    console.log("");
-  } catch (err) {
-    spinner.fail(chalk6.red(err instanceof Error ? err.message : "Undo failed"));
-    throw new Error("__exit__");
-  }
-}
-
-// src/commands/status.ts
-import chalk7 from "chalk";
-import fs21 from "fs";
-async function statusCommand(options) {
-  const config = loadConfig();
-  const manifest = readManifest();
-  if (options.json) {
-    console.log(JSON.stringify({
-      configured: !!config,
-      provider: config?.provider,
-      model: config?.model,
-      manifest
-    }, null, 2));
-    return;
-  }
-  console.log(chalk7.bold("\nCaliber Status\n"));
-  if (config) {
-    console.log(`  LLM: ${chalk7.green(config.provider)} (${config.model})`);
+function printSkills(recs) {
+  const hasScores = recs.some((r) => r.score > 0);
+  console.log(chalk6.bold("\n  Skills\n"));
+  if (hasScores) {
+    console.log(`  ${chalk6.dim("Score".padEnd(7))} ${chalk6.dim("Name".padEnd(28))} ${chalk6.dim("Why")}`);
   } else {
-    console.log(`  LLM: ${chalk7.yellow("Not configured")} \u2014 run ${chalk7.hex("#83D1EB")("caliber config")}`);
-  }
-  if (!manifest) {
-    console.log(`  Setup: ${chalk7.dim("No setup applied")}`);
-    console.log(chalk7.dim("\n  Run ") + chalk7.hex("#83D1EB")("caliber onboard") + chalk7.dim(" to get started.\n"));
-    return;
+    console.log(`  ${chalk6.dim("Name".padEnd(30))} ${chalk6.dim("Technology".padEnd(18))} ${chalk6.dim("Source")}`);
   }
-  console.log(`  Files managed: ${chalk7.cyan(manifest.entries.length.toString())}`);
-  for (const entry of manifest.entries) {
-    const exists = fs21.existsSync(entry.path);
-    const icon = exists ? chalk7.green("\u2713") : chalk7.red("\u2717");
-    console.log(`    ${icon} ${entry.path} (${entry.action})`);
+  console.log(chalk6.dim("  " + "\u2500".repeat(70)));
+  for (const rec of recs) {
+    if (hasScores) {
+      console.log(`  ${String(rec.score).padStart(3)}   ${rec.name.padEnd(26)} ${chalk6.dim(rec.reason.slice(0, 50))}`);
+    } else {
+      console.log(`  ${rec.name.padEnd(28)} ${rec.detected_technology.padEnd(16)} ${chalk6.dim(rec.source_url || "")}`);
+    }
   }
   console.log("");
 }
 
-// src/commands/regenerate.ts
-import chalk8 from "chalk";
-import ora4 from "ora";
-import select3 from "@inquirer/select";
-async function regenerateCommand(options) {
-  const config = loadConfig();
+// src/commands/onboard.ts
+async function initCommand(options) {
+  const brand = chalk7.hex("#EB9D83");
+  const title = chalk7.hex("#83D1EB");
+  console.log(brand.bold(`
+   \u2588\u2588\u2588\u2588\u2588\u2588\u2557 \u2588\u2588\u2588\u2588\u2588\u2557 \u2588\u2588\u2557     \u2588\u2588\u2557\u2588\u2588\u2588\u2588\u2588\u2588\u2557 \u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2557\u2588\u2588\u2588\u2588\u2588\u2588\u2557
+  \u2588\u2588\u2554\u2550\u2550\u2550\u2550\u255D\u2588\u2588\u2554\u2550\u2550\u2588\u2588\u2557\u2588\u2588\u2551     \u2588\u2588\u2551\u2588\u2588\u2554\u2550\u2550\u2588\u2588\u2557\u2588\u2588\u2554\u2550\u2550\u2550\u2550\u255D\u2588\u2588\u2554\u2550\u2550\u2588\u2588\u2557
+  \u2588\u2588\u2551     \u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2551\u2588\u2588\u2551     \u2588\u2588\u2551\u2588\u2588\u2588\u2588\u2588\u2588\u2554\u255D\u2588\u2588\u2588\u2588\u2588\u2557  \u2588\u2588\u2588\u2588\u2588\u2588\u2554\u255D
+  \u2588\u2588\u2551     \u2588\u2588\u2554\u2550\u2550\u2588\u2588\u2551\u2588\u2588\u2551     \u2588\u2588\u2551\u2588\u2588\u2554\u2550\u2550\u2588\u2588\u2557\u2588\u2588\u2554\u2550\u2550\u255D  \u2588\u2588\u2554\u2550\u2550\u2588\u2588\u2557
+  \u255A\u2588\u2588\u2588\u2588\u2588\u2588\u2557\u2588\u2588\u2551  \u2588\u2588\u2551\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2557\u2588\u2588\u2551\u2588\u2588\u2588\u2588\u2588\u2588\u2554\u255D\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2557\u2588\u2588\u2551  \u2588\u2588\u2551
+   \u255A\u2550\u2550\u2550\u2550\u2550\u255D\u255A\u2550\u255D  \u255A\u2550\u255D\u255A\u2550\u2550\u2550\u2550\u2550\u2550\u255D\u255A\u2550\u255D\u255A\u2550\u2550\u2550\u2550\u2550\u255D \u255A\u2550\u2550\u2550\u2550\u2550\u2550\u255D\u255A\u2550\u255D  \u255A\u2550\u255D
+  `));
+  console.log(chalk7.dim("  Onboard your project for AI-assisted development\n"));
+  console.log(title.bold("  Welcome to Caliber\n"));
+  console.log(chalk7.dim("  Caliber analyzes your codebase and creates tailored config files"));
+  console.log(chalk7.dim("  so your AI coding agents understand your project from day one.\n"));
+  console.log(title.bold("  How onboarding works:\n"));
+  console.log(chalk7.dim("  1. Connect    Set up your LLM provider"));
+  console.log(chalk7.dim("  2. Discover   Analyze your code, dependencies, and structure"));
+  console.log(chalk7.dim("  3. Generate   Create config files tailored to your project"));
+  console.log(chalk7.dim("  4. Review     Preview, refine, and apply the changes"));
+  console.log(chalk7.dim("  5. Enhance    Discover MCP servers for your tools"));
+  console.log(chalk7.dim("  6. Skills     Browse community skills for your stack\n"));
+  console.log(title.bold("  Step 1/6 \u2014 Connect your LLM\n"));
+  let config = loadConfig();
   if (!config) {
-    console.log(chalk8.red("No LLM provider configured. Run ") + chalk8.hex("#83D1EB")("caliber config") + chalk8.red(" first."));
-    throw new Error("__exit__");
-  }
-  const manifest = readManifest();
-  if (!manifest) {
-    console.log(chalk8.yellow("No existing setup found. Run ") + chalk8.hex("#83D1EB")("caliber onboard") + chalk8.yellow(" first."));
-    throw new Error("__exit__");
+    console.log(chalk7.dim("  No LLM provider set yet. Choose how to run Caliber:\n"));
+    try {
+      await runInteractiveProviderSetup({
+        selectMessage: "How do you want to use Caliber? (choose LLM provider)"
+      });
+    } catch (err) {
+      if (err.message === "__exit__") throw err;
+      throw err;
+    }
+    config = loadConfig();
+    if (!config) {
+      console.log(chalk7.red("  Setup was cancelled or failed.\n"));
+      throw new Error("__exit__");
+    }
+    console.log(chalk7.green("  \u2713 Provider saved. Let's continue.\n"));
   }
-  const targetAgent = readState()?.targetAgent ?? ["claude", "cursor"];
-  const spinner = ora4("Analyzing project...").start();
+  const displayModel = config.model === "default" && config.provider === "claude-cli" ? process.env.ANTHROPIC_MODEL || "default (inherited from Claude Code)" : config.model;
+  const fastModel = getFastModel();
+  const modelLine = fastModel ? `  Provider: ${config.provider} | Model: ${displayModel} | Scan: ${fastModel}` : `  Provider: ${config.provider} | Model: ${displayModel}`;
+  console.log(chalk7.dim(modelLine + "\n"));
+  console.log(title.bold("  Step 2/6 \u2014 Discover your project\n"));
+  console.log(chalk7.dim("  Learning about your languages, dependencies, structure, and existing configs.\n"));
+  const spinner = ora3("Analyzing project...").start();
   const fingerprint = collectFingerprint(process.cwd());
   await enrichFingerprintWithLLM(fingerprint, process.cwd());
   spinner.succeed("Project analyzed");
+  console.log(chalk7.dim(`  Languages: ${fingerprint.languages.join(", ") || "none detected"}`));
+  console.log(chalk7.dim(`  Files: ${fingerprint.fileTree.length} found
+`));
+  const targetAgent = options.agent || await promptAgent();
+  const preScore = computeLocalScore(process.cwd(), targetAgent);
+  const failingForDismissal = preScore.checks.filter((c) => !c.passed && c.maxPoints > 0);
+  if (failingForDismissal.length > 0) {
+    const newDismissals = await evaluateDismissals(failingForDismissal, fingerprint);
+    if (newDismissals.length > 0) {
+      const existing = readDismissedChecks();
+      const existingIds = new Set(existing.map((d) => d.id));
+      const merged = [...existing, ...newDismissals.filter((d) => !existingIds.has(d.id))];
+      writeDismissedChecks(merged);
+    }
+  }
   const baselineScore = computeLocalScore(process.cwd(), targetAgent);
   displayScoreSummary(baselineScore);
-  const genSpinner = ora4("Regenerating setup...").start();
+  const hasExistingConfig = !!(fingerprint.existingConfigs.claudeMd || fingerprint.existingConfigs.claudeSettings || fingerprint.existingConfigs.claudeSkills?.length || fingerprint.existingConfigs.cursorrules || fingerprint.existingConfigs.cursorRules?.length || fingerprint.existingConfigs.agentsMd);
+  const NON_LLM_CHECKS = /* @__PURE__ */ new Set(["hooks_configured", "agents_md_exists", "permissions_configured", "mcp_servers"]);
+  if (hasExistingConfig && baselineScore.score === 100) {
+    console.log(chalk7.bold.green("  Your setup is already optimal \u2014 nothing to change.\n"));
+    console.log(chalk7.dim("  Run ") + chalk7.hex("#83D1EB")("caliber onboard --force") + chalk7.dim(" to regenerate anyway.\n"));
+    if (!options.force) return;
+  }
+  const allFailingChecks = baselineScore.checks.filter((c) => !c.passed && c.maxPoints > 0);
+  const llmFixableChecks = allFailingChecks.filter((c) => !NON_LLM_CHECKS.has(c.id));
+  if (hasExistingConfig && llmFixableChecks.length === 0 && allFailingChecks.length > 0 && !options.force) {
+    console.log(chalk7.bold.green("\n  Your config is fully optimized for LLM generation.\n"));
+    console.log(chalk7.dim("  Remaining items need CLI actions:\n"));
+    for (const check of allFailingChecks) {
+      console.log(chalk7.dim(`    \u2022 ${check.name}`));
+      if (check.suggestion) {
+        console.log(`      ${chalk7.hex("#83D1EB")(check.suggestion)}`);
+      }
+    }
+    console.log("");
+    console.log(chalk7.dim("  Run ") + chalk7.hex("#83D1EB")("caliber onboard --force") + chalk7.dim(" to regenerate anyway.\n"));
+    return;
+  }
+  const isEmpty = fingerprint.fileTree.length < 3;
+  if (isEmpty) {
+    fingerprint.description = await promptInput3("What will you build in this project?");
+  }
+  let failingChecks;
+  let passingChecks;
+  let currentScore;
+  if (hasExistingConfig && baselineScore.score >= 95 && !options.force) {
+    failingChecks = llmFixableChecks.map((c) => ({ name: c.name, suggestion: c.suggestion }));
+    passingChecks = baselineScore.checks.filter((c) => c.passed).map((c) => ({ name: c.name }));
+    currentScore = baselineScore.score;
+    if (failingChecks.length > 0) {
+      console.log(title.bold("  Step 3/6 \u2014 Fine-tuning\n"));
+      console.log(chalk7.dim(`  Your setup scores ${baselineScore.score}/100 \u2014 fixing ${failingChecks.length} remaining issue${failingChecks.length === 1 ? "" : "s"}:
+`));
+      for (const check of failingChecks) {
+        console.log(chalk7.dim(`    \u2022 ${check.name}`));
+      }
+      console.log("");
+    }
+  } else if (hasExistingConfig) {
+    console.log(title.bold("  Step 3/6 \u2014 Improve your setup\n"));
+    console.log(chalk7.dim("  Reviewing your existing configs against your codebase"));
+    console.log(chalk7.dim("  and preparing improvements.\n"));
+  } else {
+    console.log(title.bold("  Step 3/6 \u2014 Build your agent setup\n"));
+    console.log(chalk7.dim("  Creating config files tailored to your project.\n"));
+  }
+  console.log(chalk7.dim("  This can take a couple of minutes depending on your model and provider.\n"));
+  const genStartTime = Date.now();
+  const genSpinner = ora3("Generating setup...").start();
   const genMessages = new SpinnerMessages(genSpinner, GENERATION_MESSAGES, { showElapsedTime: true });
   genMessages.start();
   let generatedSetup = null;
+  let rawOutput;
   try {
     const result = await generateSetup(
       fingerprint,
       targetAgent,
-      void 0,
+      fingerprint.description,
       {
         onStatus: (status) => {
           genMessages.handleServerStatus(status);
@@ -5331,796 +5497,692 @@ async function regenerateCommand(options) {
           genMessages.stop();
           genSpinner.fail(`Generation error: ${error}`);
         }
-      }
+      },
+      failingChecks,
+      currentScore,
+      passingChecks
     );
-    if (!generatedSetup) generatedSetup = result.setup;
+    if (!generatedSetup) {
+      generatedSetup = result.setup;
+      rawOutput = result.raw;
+    }
   } catch (err) {
     genMessages.stop();
     const msg = err instanceof Error ? err.message : "Unknown error";
-    genSpinner.fail(`Regeneration failed: ${msg}`);
+    genSpinner.fail(`Generation failed: ${msg}`);
     throw new Error("__exit__");
   }
   genMessages.stop();
   if (!generatedSetup) {
-    genSpinner.fail("Failed to regenerate setup.");
+    genSpinner.fail("Failed to generate setup.");
+    if (rawOutput) {
+      console.log(chalk7.dim("\nRaw LLM output (JSON parse failed):"));
+      console.log(chalk7.dim(rawOutput.slice(0, 500)));
+    }
     throw new Error("__exit__");
   }
-  genSpinner.succeed("Setup regenerated");
+  const elapsedMs = Date.now() - genStartTime;
+  const mins = Math.floor(elapsedMs / 6e4);
+  const secs = Math.floor(elapsedMs % 6e4 / 1e3);
+  const timeStr = mins > 0 ? `${mins}m ${secs}s` : `${secs}s`;
+  genSpinner.succeed(`Setup generated ${chalk7.dim(`in ${timeStr}`)}`);
+  printSetupSummary(generatedSetup);
+  const sessionHistory = [];
+  sessionHistory.push({
+    role: "assistant",
+    content: summarizeSetup("Initial generation", generatedSetup)
+  });
+  console.log(title.bold("  Step 4/6 \u2014 Review and apply\n"));
   const setupFiles = collectSetupFiles(generatedSetup);
   const staged = stageFiles(setupFiles, process.cwd());
   const totalChanges = staged.newFiles + staged.modifiedFiles;
-  console.log(chalk8.dim(`
-  ${chalk8.green(`${staged.newFiles} new`)} / ${chalk8.yellow(`${staged.modifiedFiles} modified`)} file${totalChanges !== 1 ? "s" : ""}
+  console.log(chalk7.dim(`  ${chalk7.green(`${staged.newFiles} new`)} / ${chalk7.yellow(`${staged.modifiedFiles} modified`)} file${totalChanges !== 1 ? "s" : ""}
 `));
+  let action;
   if (totalChanges === 0) {
-    console.log(chalk8.dim("  No changes needed \u2014 your configs are already up to date.\n"));
+    console.log(chalk7.dim("  No changes needed \u2014 your configs are already up to date.\n"));
     cleanupStaging();
-    return;
+    action = "accept";
+  } else {
+    const wantsReview = await promptWantsReview();
+    if (wantsReview) {
+      const reviewMethod = await promptReviewMethod();
+      await openReview(reviewMethod, staged.stagedFiles);
+    }
+    action = await promptReviewAction();
   }
-  if (options.dryRun) {
-    console.log(chalk8.yellow("[Dry run] Would write:"));
-    for (const f of staged.stagedFiles) {
-      console.log(`  ${f.isNew ? chalk8.green("+") : chalk8.yellow("~")} ${f.relativePath}`);
+  while (action === "refine") {
+    generatedSetup = await refineLoop(generatedSetup, targetAgent, sessionHistory);
+    if (!generatedSetup) {
+      cleanupStaging();
+      console.log(chalk7.dim("Refinement cancelled. No files were modified."));
+      return;
     }
-    cleanupStaging();
-    return;
+    const updatedFiles = collectSetupFiles(generatedSetup);
+    const restaged = stageFiles(updatedFiles, process.cwd());
+    console.log(chalk7.dim(`  ${chalk7.green(`${restaged.newFiles} new`)} / ${chalk7.yellow(`${restaged.modifiedFiles} modified`)} file${restaged.newFiles + restaged.modifiedFiles !== 1 ? "s" : ""}
+`));
+    printSetupSummary(generatedSetup);
+    await openReview("terminal", restaged.stagedFiles);
+    action = await promptReviewAction();
   }
-  const action = await select3({
-    message: "Apply regenerated setup?",
-    choices: [
-      { name: "Accept and apply", value: "accept" },
-      { name: "Decline", value: "decline" }
-    ]
-  });
   cleanupStaging();
   if (action === "decline") {
-    console.log(chalk8.dim("Regeneration cancelled. No files were modified."));
+    console.log(chalk7.dim("Setup declined. No files were modified."));
     return;
   }
-  const writeSpinner = ora4("Writing config files...").start();
+  if (options.dryRun) {
+    console.log(chalk7.yellow("\n[Dry run] Would write the following files:"));
+    console.log(JSON.stringify(generatedSetup, null, 2));
+    return;
+  }
+  const writeSpinner = ora3("Writing config files...").start();
   try {
     const result = writeSetup(generatedSetup);
     writeSpinner.succeed("Config files written");
+    console.log(chalk7.bold("\nFiles created/updated:"));
     for (const file of result.written) {
-      console.log(`  ${chalk8.green("\u2713")} ${file}`);
+      console.log(`  ${chalk7.green("\u2713")} ${file}`);
     }
     if (result.deleted.length > 0) {
+      console.log(chalk7.bold("\nFiles removed:"));
       for (const file of result.deleted) {
-        console.log(`  ${chalk8.red("\u2717")} ${file}`);
+        console.log(`  ${chalk7.red("\u2717")} ${file}`);
       }
     }
     if (result.backupDir) {
-      console.log(chalk8.dim(`
+      console.log(chalk7.dim(`
   Backups saved to ${result.backupDir}`));
     }
   } catch (err) {
     writeSpinner.fail("Failed to write files");
-    console.error(chalk8.red(err instanceof Error ? err.message : "Unknown error"));
+    console.error(chalk7.red(err instanceof Error ? err.message : "Unknown error"));
     throw new Error("__exit__");
   }
-  const sha = getCurrentHeadSha();
-  writeState({
-    lastRefreshSha: sha ?? "",
-    lastRefreshTimestamp: (/* @__PURE__ */ new Date()).toISOString(),
-    targetAgent
-  });
-  const afterScore = computeLocalScore(process.cwd(), targetAgent);
-  if (afterScore.score < baselineScore.score) {
-    console.log("");
-    console.log(chalk8.yellow(`  Score would drop from ${baselineScore.score} to ${afterScore.score} \u2014 reverting changes.`));
+  console.log(title.bold("\n  Step 5/6 \u2014 Enhance with MCP servers\n"));
+  console.log(chalk7.dim("  MCP servers connect your AI agents to external tools and services"));
+  console.log(chalk7.dim("  like databases, APIs, and platforms your project depends on.\n"));
+  if (fingerprint.tools.length > 0) {
     try {
-      const { restored, removed } = undoSetup();
-      if (restored.length > 0 || removed.length > 0) {
-        console.log(chalk8.dim(`  Reverted ${restored.length + removed.length} file${restored.length + removed.length === 1 ? "" : "s"} from backup.`));
+      const mcpResult = await discoverAndInstallMcps(targetAgent, fingerprint, process.cwd());
+      if (mcpResult.installed > 0) {
+        console.log(chalk7.bold(`
+  ${mcpResult.installed} MCP server${mcpResult.installed > 1 ? "s" : ""} configured`));
+        for (const name of mcpResult.names) {
+          console.log(`  ${chalk7.green("\u2713")} ${name}`);
+        }
       }
-    } catch {
+    } catch (err) {
+      console.log(chalk7.dim("  MCP discovery skipped: " + (err instanceof Error ? err.message : "unknown error")));
     }
-    console.log(chalk8.dim("  Run ") + chalk8.hex("#83D1EB")("caliber onboard --force") + chalk8.dim(" to override.\n"));
-    return;
-  }
-  displayScoreDelta(baselineScore, afterScore);
-  console.log(chalk8.bold.green("  Regeneration complete!"));
-  console.log(chalk8.dim("  Run ") + chalk8.hex("#83D1EB")("caliber undo") + chalk8.dim(" to revert changes.\n"));
-}
-
-// src/commands/recommend.ts
-import chalk9 from "chalk";
-import ora5 from "ora";
-import { mkdirSync, readFileSync as readFileSync7, readdirSync as readdirSync5, existsSync as existsSync9, writeFileSync } from "fs";
-import { join as join8, dirname as dirname2 } from "path";
-
-// src/scanner/index.ts
-import fs22 from "fs";
-import path17 from "path";
-import crypto2 from "crypto";
-function scanLocalState(dir) {
-  const items = [];
-  const claudeMdPath = path17.join(dir, "CLAUDE.md");
-  if (fs22.existsSync(claudeMdPath)) {
-    items.push({
-      type: "rule",
-      platform: "claude",
-      name: "CLAUDE.md",
-      contentHash: hashFile(claudeMdPath),
-      path: claudeMdPath
-    });
+  } else {
+    console.log(chalk7.dim("  No external tools or services detected \u2014 skipping MCP discovery.\n"));
   }
-  const skillsDir = path17.join(dir, ".claude", "skills");
-  if (fs22.existsSync(skillsDir)) {
-    for (const file of fs22.readdirSync(skillsDir).filter((f) => f.endsWith(".md"))) {
-      const filePath = path17.join(skillsDir, file);
-      items.push({
-        type: "skill",
-        platform: "claude",
-        name: file,
-        contentHash: hashFile(filePath),
-        path: filePath
-      });
+  ensurePermissions();
+  const sha = getCurrentHeadSha();
+  writeState({
+    lastRefreshSha: sha ?? "",
+    lastRefreshTimestamp: (/* @__PURE__ */ new Date()).toISOString(),
+    targetAgent
+  });
+  console.log("");
+  console.log(title.bold("  Keep your configs fresh\n"));
+  console.log(chalk7.dim("  Caliber can automatically update your agent configs when your code changes.\n"));
+  const hookChoice = await promptHookType(targetAgent);
+  if (hookChoice === "claude" || hookChoice === "both") {
+    const hookResult = installHook();
+    if (hookResult.installed) {
+      console.log(`  ${chalk7.green("\u2713")} Claude Code hook installed \u2014 docs update on session end`);
+      console.log(chalk7.dim("    Run ") + chalk7.hex("#83D1EB")("caliber hooks --remove") + chalk7.dim(" to disable"));
+    } else if (hookResult.alreadyInstalled) {
+      console.log(chalk7.dim("  Claude Code hook already installed"));
+    }
+    const learnResult = installLearningHooks();
+    if (learnResult.installed) {
+      console.log(`  ${chalk7.green("\u2713")} Learning hooks installed \u2014 session insights captured automatically`);
+      console.log(chalk7.dim("    Run ") + chalk7.hex("#83D1EB")("caliber learn remove") + chalk7.dim(" to disable"));
+    } else if (learnResult.alreadyInstalled) {
+      console.log(chalk7.dim("  Learning hooks already installed"));
     }
   }
-  const mcpJsonPath = path17.join(dir, ".mcp.json");
-  if (fs22.existsSync(mcpJsonPath)) {
-    try {
-      const mcpJson = JSON.parse(fs22.readFileSync(mcpJsonPath, "utf-8"));
-      if (mcpJson.mcpServers) {
-        for (const name of Object.keys(mcpJson.mcpServers)) {
-          items.push({
-            type: "mcp",
-            platform: "claude",
-            name,
-            contentHash: hashJson(mcpJson.mcpServers[name]),
-            path: mcpJsonPath
-          });
-        }
-      }
-    } catch {
+  if (hookChoice === "precommit" || hookChoice === "both") {
+    const precommitResult = installPreCommitHook();
+    if (precommitResult.installed) {
+      console.log(`  ${chalk7.green("\u2713")} Pre-commit hook installed \u2014 docs refresh before each commit`);
+      console.log(chalk7.dim("    Run ") + chalk7.hex("#83D1EB")("caliber hooks --remove") + chalk7.dim(" to disable"));
+    } else if (precommitResult.alreadyInstalled) {
+      console.log(chalk7.dim("  Pre-commit hook already installed"));
+    } else {
+      console.log(chalk7.yellow("  Could not install pre-commit hook (not a git repository?)"));
     }
   }
-  const agentsMdPath = path17.join(dir, "AGENTS.md");
-  if (fs22.existsSync(agentsMdPath)) {
-    items.push({
-      type: "rule",
-      platform: "codex",
-      name: "AGENTS.md",
-      contentHash: hashFile(agentsMdPath),
-      path: agentsMdPath
-    });
+  if (hookChoice === "skip") {
+    console.log(chalk7.dim("  Skipped auto-refresh hooks. Run ") + chalk7.hex("#83D1EB")("caliber hooks --install") + chalk7.dim(" later to enable."));
   }
-  const codexSkillsDir = path17.join(dir, ".agents", "skills");
-  if (fs22.existsSync(codexSkillsDir)) {
+  const afterScore = computeLocalScore(process.cwd(), targetAgent);
+  if (afterScore.score < baselineScore.score) {
+    console.log("");
+    console.log(chalk7.yellow(`  Score would drop from ${baselineScore.score} to ${afterScore.score} \u2014 reverting changes.`));
     try {
-      for (const name of fs22.readdirSync(codexSkillsDir)) {
-        const skillFile = path17.join(codexSkillsDir, name, "SKILL.md");
-        if (fs22.existsSync(skillFile)) {
-          items.push({
-            type: "skill",
-            platform: "codex",
-            name: `${name}/SKILL.md`,
-            contentHash: hashFile(skillFile),
-            path: skillFile
-          });
-        }
+      const { restored, removed } = undoSetup();
+      if (restored.length > 0 || removed.length > 0) {
+        console.log(chalk7.dim(`  Reverted ${restored.length + removed.length} file${restored.length + removed.length === 1 ? "" : "s"} from backup.`));
       }
     } catch {
     }
+    console.log(chalk7.dim("  Run ") + chalk7.hex("#83D1EB")("caliber onboard --force") + chalk7.dim(" to override.\n"));
+    return;
   }
-  const cursorrulesPath = path17.join(dir, ".cursorrules");
-  if (fs22.existsSync(cursorrulesPath)) {
-    items.push({
-      type: "rule",
-      platform: "cursor",
-      name: ".cursorrules",
-      contentHash: hashFile(cursorrulesPath),
-      path: cursorrulesPath
-    });
-  }
-  const cursorRulesDir = path17.join(dir, ".cursor", "rules");
-  if (fs22.existsSync(cursorRulesDir)) {
-    for (const file of fs22.readdirSync(cursorRulesDir).filter((f) => f.endsWith(".mdc"))) {
-      const filePath = path17.join(cursorRulesDir, file);
-      items.push({
-        type: "rule",
-        platform: "cursor",
-        name: file,
-        contentHash: hashFile(filePath),
-        path: filePath
-      });
-    }
-  }
-  const cursorSkillsDir = path17.join(dir, ".cursor", "skills");
-  if (fs22.existsSync(cursorSkillsDir)) {
+  displayScoreDelta(baselineScore, afterScore);
+  console.log(title.bold("\n  Step 6/6 \u2014 Community skills\n"));
+  console.log(chalk7.dim("  Search public skill registries for skills that match your tech stack.\n"));
+  const wantsSkills = await select4({
+    message: "Search public repos for relevant skills to add to this project?",
+    choices: [
+      { name: "Yes, find skills for my project", value: true },
+      { name: "Skip for now", value: false }
+    ]
+  });
+  if (wantsSkills) {
     try {
-      for (const name of fs22.readdirSync(cursorSkillsDir)) {
-        const skillFile = path17.join(cursorSkillsDir, name, "SKILL.md");
-        if (fs22.existsSync(skillFile)) {
-          items.push({
-            type: "skill",
-            platform: "cursor",
-            name: `${name}/SKILL.md`,
-            contentHash: hashFile(skillFile),
-            path: skillFile
-          });
-        }
+      await searchAndInstallSkills();
+    } catch (err) {
+      if (err.message !== "__exit__") {
+        console.log(chalk7.dim("  Skills search failed: " + (err.message || "unknown error")));
       }
-    } catch {
+      console.log(chalk7.dim("  Run ") + chalk7.hex("#83D1EB")("caliber skills") + chalk7.dim(" later to try again.\n"));
     }
+  } else {
+    console.log(chalk7.dim("  Skipped. Run ") + chalk7.hex("#83D1EB")("caliber skills") + chalk7.dim(" later to browse.\n"));
   }
-  const cursorMcpPath = path17.join(dir, ".cursor", "mcp.json");
-  if (fs22.existsSync(cursorMcpPath)) {
-    try {
-      const mcpJson = JSON.parse(fs22.readFileSync(cursorMcpPath, "utf-8"));
-      if (mcpJson.mcpServers) {
-        for (const name of Object.keys(mcpJson.mcpServers)) {
-          items.push({
-            type: "mcp",
-            platform: "cursor",
-            name,
-            contentHash: hashJson(mcpJson.mcpServers[name]),
-            path: cursorMcpPath
-          });
-        }
-      }
-    } catch {
+  console.log(chalk7.bold.green("  Onboarding complete! Your project is ready for AI-assisted development."));
+  console.log(chalk7.dim("  Run ") + chalk7.hex("#83D1EB")("caliber undo") + chalk7.dim(" to revert changes.\n"));
+  console.log(chalk7.bold("  Next steps:\n"));
+  console.log(`    ${title("caliber score")}        See your full config breakdown`);
+  console.log(`    ${title("caliber skills")}         Discover community skills for your stack`);
+  console.log(`    ${title("caliber undo")}         Revert all changes from this run`);
+  console.log("");
+}
+async function refineLoop(currentSetup, _targetAgent, sessionHistory) {
+  while (true) {
+    const message = await promptInput3("\nWhat would you like to change?");
+    if (!message || message.toLowerCase() === "done" || message.toLowerCase() === "accept") {
+      return currentSetup;
+    }
+    if (message.toLowerCase() === "cancel") {
+      return null;
+    }
+    const isValid = await classifyRefineIntent(message);
+    if (!isValid) {
+      console.log(chalk7.dim("  This doesn't look like a config change request."));
+      console.log(chalk7.dim("  Describe what to add, remove, or modify in your configs."));
+      console.log(chalk7.dim('  Type "done" to accept the current setup.\n'));
+      continue;
+    }
+    const refineSpinner = ora3("Refining setup...").start();
+    const refineMessages = new SpinnerMessages(refineSpinner, REFINE_MESSAGES);
+    refineMessages.start();
+    const refined = await refineSetup(
+      currentSetup,
+      message,
+      sessionHistory
+    );
+    refineMessages.stop();
+    if (refined) {
+      currentSetup = refined;
+      sessionHistory.push({ role: "user", content: message });
+      sessionHistory.push({
+        role: "assistant",
+        content: summarizeSetup("Applied changes", refined)
+      });
+      refineSpinner.succeed("Setup updated");
+      printSetupSummary(refined);
+      console.log(chalk7.dim('Type "done" to accept, or describe more changes.'));
+    } else {
+      refineSpinner.fail("Refinement failed \u2014 could not parse AI response.");
+      console.log(chalk7.dim('Try rephrasing your request, or type "done" to keep the current setup.'));
     }
   }
-  return items;
 }
-function hashFile(filePath) {
-  const text = fs22.readFileSync(filePath, "utf-8");
-  return crypto2.createHash("sha256").update(JSON.stringify({ text })).digest("hex");
+function summarizeSetup(action, setup) {
+  const descriptions = setup.fileDescriptions;
+  const files = descriptions ? Object.entries(descriptions).map(([path24, desc]) => `  ${path24}: ${desc}`).join("\n") : Object.keys(setup).filter((k) => k !== "targetAgent" && k !== "fileDescriptions").join(", ");
+  return `${action}. Files:
+${files}`;
 }
-function hashJson(obj) {
-  return crypto2.createHash("sha256").update(JSON.stringify(obj)).digest("hex");
+async function classifyRefineIntent(message) {
+  const fastModel = getFastModel();
+  try {
+    const result = await llmJsonCall({
+      system: `You classify whether a user message is a valid request to modify AI agent config files (CLAUDE.md, .cursorrules, skills).
+Valid: requests to add, remove, change, or restructure config content. Examples: "add testing commands", "remove the terraform section", "make CLAUDE.md shorter".
+Invalid: questions, requests to show/display something, general chat, or anything that isn't a concrete config change.
+Return {"valid": true} or {"valid": false}. Nothing else.`,
+      prompt: message,
+      maxTokens: 20,
+      ...fastModel ? { model: fastModel } : {}
+    });
+    return result.valid === true;
+  } catch {
+    return true;
+  }
 }
+async function evaluateDismissals(failingChecks, fingerprint) {
+  const fastModel = getFastModel();
+  const checkList = failingChecks.map((c) => ({
+    id: c.id,
+    name: c.name,
+    suggestion: c.suggestion
+  }));
+  try {
+    const result = await llmJsonCall({
+      system: `You evaluate whether scoring checks are applicable to a project.
+Given the project's languages/frameworks and a list of failing checks, return which checks are NOT applicable.
 
-// src/commands/recommend.ts
-function detectLocalPlatforms() {
-  const items = scanLocalState(process.cwd());
-  const platforms = /* @__PURE__ */ new Set();
-  for (const item of items) {
-    platforms.add(item.platform);
+Only dismiss checks that truly don't apply \u2014 e.g. "Build/test/lint commands" for a pure Terraform/HCL repo with no build system.
+Do NOT dismiss checks that could reasonably apply even if the project doesn't use them yet.
+
+Return {"dismissed": [{"id": "check_id", "reason": "brief reason"}]} or {"dismissed": []} if all apply.`,
+      prompt: `Languages: ${fingerprint.languages.join(", ") || "none"}
+Frameworks: ${fingerprint.frameworks.join(", ") || "none"}
+
+Failing checks:
+${JSON.stringify(checkList, null, 2)}`,
+      maxTokens: 200,
+      ...fastModel ? { model: fastModel } : {}
+    });
+    if (!Array.isArray(result.dismissed)) return [];
+    return result.dismissed.filter((d) => d.id && d.reason && failingChecks.some((c) => c.id === d.id)).map((d) => ({ id: d.id, reason: d.reason, dismissedAt: (/* @__PURE__ */ new Date()).toISOString() }));
+  } catch {
+    return [];
   }
-  return platforms.size > 0 ? Array.from(platforms) : ["claude"];
 }
-function getSkillPath(platform, slug) {
-  if (platform === "cursor") {
-    return join8(".cursor", "skills", slug, "SKILL.md");
-  }
-  if (platform === "codex") {
-    return join8(".agents", "skills", slug, "SKILL.md");
+function promptInput3(question) {
+  const rl = readline4.createInterface({ input: process.stdin, output: process.stdout });
+  return new Promise((resolve2) => {
+    rl.question(chalk7.cyan(`${question} `), (answer) => {
+      rl.close();
+      resolve2(answer.trim());
+    });
+  });
+}
+async function promptAgent() {
+  const selected = await checkbox({
+    message: "Which coding agents do you use? (toggle with space)",
+    choices: [
+      { name: "Claude Code", value: "claude" },
+      { name: "Cursor", value: "cursor" },
+      { name: "Codex (OpenAI)", value: "codex" }
+    ],
+    validate: (items) => {
+      if (items.length === 0) return "At least one agent must be selected";
+      return true;
+    }
+  });
+  return selected;
+}
+async function promptHookType(targetAgent) {
+  const choices = [];
+  const hasClaude = targetAgent.includes("claude");
+  if (hasClaude) {
+    choices.push({ name: "Claude Code hook (auto-refresh on session end)", value: "claude" });
   }
-  return join8(".claude", "skills", slug, "SKILL.md");
+  choices.push({ name: "Git pre-commit hook (refresh before each commit)", value: "precommit" });
+  if (hasClaude) {
+    choices.push({ name: "Both (Claude Code + pre-commit)", value: "both" });
+  }
+  choices.push({ name: "Skip for now", value: "skip" });
+  return select4({
+    message: "How would you like to auto-refresh your docs?",
+    choices
+  });
 }
-function getInstalledSkills() {
-  const installed = /* @__PURE__ */ new Set();
-  const dirs = [
-    join8(process.cwd(), ".claude", "skills"),
-    join8(process.cwd(), ".cursor", "skills"),
-    join8(process.cwd(), ".agents", "skills")
-  ];
-  for (const dir of dirs) {
-    try {
-      const entries = readdirSync5(dir, { withFileTypes: true });
-      for (const entry of entries) {
-        if (entry.isDirectory()) {
-          installed.add(entry.name.toLowerCase());
-        }
+async function promptReviewAction() {
+  return select4({
+    message: "What would you like to do?",
+    choices: [
+      { name: "Accept and apply", value: "accept" },
+      { name: "Refine via chat", value: "refine" },
+      { name: "Decline", value: "decline" }
+    ]
+  });
+}
+function printSetupSummary(setup) {
+  const claude = setup.claude;
+  const cursor = setup.cursor;
+  const fileDescriptions = setup.fileDescriptions;
+  const deletions = setup.deletions;
+  console.log("");
+  console.log(chalk7.bold("  Proposed changes:\n"));
+  const getDescription = (filePath) => {
+    return fileDescriptions?.[filePath];
+  };
+  if (claude) {
+    if (claude.claudeMd) {
+      const icon = fs22.existsSync("CLAUDE.md") ? chalk7.yellow("~") : chalk7.green("+");
+      const desc = getDescription("CLAUDE.md");
+      console.log(`  ${icon} ${chalk7.bold("CLAUDE.md")}`);
+      if (desc) console.log(chalk7.dim(`    ${desc}`));
+      console.log("");
+    }
+    const skills = claude.skills;
+    if (Array.isArray(skills) && skills.length > 0) {
+      for (const skill of skills) {
+        const skillPath = `.claude/skills/${skill.name}/SKILL.md`;
+        const icon = fs22.existsSync(skillPath) ? chalk7.yellow("~") : chalk7.green("+");
+        const desc = getDescription(skillPath);
+        console.log(`  ${icon} ${chalk7.bold(skillPath)}`);
+        console.log(chalk7.dim(`    ${desc || skill.description || skill.name}`));
+        console.log("");
       }
-    } catch {
     }
   }
-  return installed;
-}
-async function searchSkillsSh(technologies) {
-  const bestBySlug = /* @__PURE__ */ new Map();
-  for (const tech of technologies) {
-    try {
-      const resp = await fetch(`https://skills.sh/api/search?q=${encodeURIComponent(tech)}&limit=10`, {
-        signal: AbortSignal.timeout(1e4)
-      });
-      if (!resp.ok) continue;
-      const data = await resp.json();
-      if (!data.skills?.length) continue;
-      for (const skill of data.skills) {
-        const existing = bestBySlug.get(skill.skillId);
-        if (existing && existing.installs >= (skill.installs ?? 0)) continue;
-        bestBySlug.set(skill.skillId, {
-          name: skill.name,
-          slug: skill.skillId,
-          source_url: skill.source ? `https://github.com/${skill.source}` : "",
-          score: 0,
-          reason: skill.description || "",
-          detected_technology: tech,
-          item_type: "skill",
-          installs: skill.installs ?? 0
-        });
+  const codex = setup.codex;
+  if (codex) {
+    if (codex.agentsMd) {
+      const icon = fs22.existsSync("AGENTS.md") ? chalk7.yellow("~") : chalk7.green("+");
+      const desc = getDescription("AGENTS.md");
+      console.log(`  ${icon} ${chalk7.bold("AGENTS.md")}`);
+      if (desc) console.log(chalk7.dim(`    ${desc}`));
+      console.log("");
+    }
+    const codexSkills = codex.skills;
+    if (Array.isArray(codexSkills) && codexSkills.length > 0) {
+      for (const skill of codexSkills) {
+        const skillPath = `.agents/skills/${skill.name}/SKILL.md`;
+        const icon = fs22.existsSync(skillPath) ? chalk7.yellow("~") : chalk7.green("+");
+        const desc = getDescription(skillPath);
+        console.log(`  ${icon} ${chalk7.bold(skillPath)}`);
+        console.log(chalk7.dim(`    ${desc || skill.description || skill.name}`));
+        console.log("");
       }
-    } catch {
-      continue;
     }
   }
-  return Array.from(bestBySlug.values());
-}
-async function searchTessl(technologies) {
-  const results = [];
-  const seen = /* @__PURE__ */ new Set();
-  for (const tech of technologies) {
-    try {
-      const resp = await fetch(`https://tessl.io/registry?q=${encodeURIComponent(tech)}`, {
-        signal: AbortSignal.timeout(1e4)
-      });
-      if (!resp.ok) continue;
-      const html = await resp.text();
-      const linkMatches = html.matchAll(/\/registry\/skills\/github\/([^/]+)\/([^/]+)\/([^/"]+)/g);
-      for (const match of linkMatches) {
-        const [, org, repo, skillName] = match;
-        const slug = `${org}-${repo}-${skillName}`.toLowerCase();
-        if (seen.has(slug)) continue;
-        seen.add(slug);
-        results.push({
-          name: skillName,
-          slug,
-          source_url: `https://github.com/${org}/${repo}`,
-          score: 0,
-          reason: `Skill from ${org}/${repo}`,
-          detected_technology: tech,
-          item_type: "skill"
-        });
+  if (cursor) {
+    if (cursor.cursorrules) {
+      const icon = fs22.existsSync(".cursorrules") ? chalk7.yellow("~") : chalk7.green("+");
+      const desc = getDescription(".cursorrules");
+      console.log(`  ${icon} ${chalk7.bold(".cursorrules")}`);
+      if (desc) console.log(chalk7.dim(`    ${desc}`));
+      console.log("");
+    }
+    const cursorSkills = cursor.skills;
+    if (Array.isArray(cursorSkills) && cursorSkills.length > 0) {
+      for (const skill of cursorSkills) {
+        const skillPath = `.cursor/skills/${skill.name}/SKILL.md`;
+        const icon = fs22.existsSync(skillPath) ? chalk7.yellow("~") : chalk7.green("+");
+        const desc = getDescription(skillPath);
+        console.log(`  ${icon} ${chalk7.bold(skillPath)}`);
+        console.log(chalk7.dim(`    ${desc || skill.description || skill.name}`));
+        console.log("");
+      }
+    }
+    const rules = cursor.rules;
+    if (Array.isArray(rules) && rules.length > 0) {
+      for (const rule of rules) {
+        const rulePath = `.cursor/rules/${rule.filename}`;
+        const icon = fs22.existsSync(rulePath) ? chalk7.yellow("~") : chalk7.green("+");
+        const desc = getDescription(rulePath);
+        console.log(`  ${icon} ${chalk7.bold(rulePath)}`);
+        if (desc) {
+          console.log(chalk7.dim(`    ${desc}`));
+        } else {
+          const firstLine = rule.content.split("\n").filter((l) => l.trim() && !l.trim().startsWith("#"))[0];
+          if (firstLine) console.log(chalk7.dim(`    ${firstLine.trim().slice(0, 80)}`));
+        }
+        console.log("");
       }
-    } catch {
-      continue;
     }
   }
-  return results;
+  if (!codex && !fs22.existsSync("AGENTS.md")) {
+    console.log(`  ${chalk7.green("+")} ${chalk7.bold("AGENTS.md")}`);
+    console.log(chalk7.dim("    Cross-agent coordination file"));
+    console.log("");
+  }
+  if (Array.isArray(deletions) && deletions.length > 0) {
+    for (const del of deletions) {
+      console.log(`  ${chalk7.red("-")} ${chalk7.bold(del.filePath)}`);
+      console.log(chalk7.dim(`    ${del.reason}`));
+      console.log("");
+    }
+  }
+  console.log(`  ${chalk7.green("+")} ${chalk7.dim("new")}  ${chalk7.yellow("~")} ${chalk7.dim("modified")}  ${chalk7.red("-")} ${chalk7.dim("removed")}`);
+  console.log("");
 }
-var AWESOME_CLAUDE_CODE_URL = "https://raw.githubusercontent.com/hesreallyhim/awesome-claude-code/main/README.md";
-async function searchAwesomeClaudeCode(technologies) {
+function ensurePermissions() {
+  const settingsPath = ".claude/settings.json";
+  let settings = {};
   try {
-    const resp = await fetch(AWESOME_CLAUDE_CODE_URL, {
-      signal: AbortSignal.timeout(1e4)
-    });
-    if (!resp.ok) return [];
-    const markdown = await resp.text();
-    const items = [];
-    const itemPattern = /^[-*]\s+\[([^\]]+)\]\(([^)]+)\)(?:\s+by\s+\[[^\]]*\]\([^)]*\))?\s*[-–—:]\s*(.*)/gm;
-    let match;
-    while ((match = itemPattern.exec(markdown)) !== null) {
-      const [, name, url, description] = match;
-      if (url.startsWith("#")) continue;
-      const slug = name.toLowerCase().replace(/[^a-z0-9]+/g, "-").replace(/^-|-$/g, "");
-      items.push({
-        name: name.trim(),
-        slug,
-        source_url: url.trim(),
-        score: 0,
-        reason: description.trim().slice(0, 150),
-        detected_technology: "claude-code",
-        item_type: "skill"
-      });
+    if (fs22.existsSync(settingsPath)) {
+      settings = JSON.parse(fs22.readFileSync(settingsPath, "utf-8"));
     }
-    const techLower = technologies.map((t) => t.toLowerCase());
-    return items.filter((item) => {
-      const text = `${item.name} ${item.reason}`.toLowerCase();
-      return techLower.some((t) => text.includes(t));
-    });
   } catch {
-    return [];
   }
-}
-async function searchAllProviders(technologies, platform) {
-  const searches = [
-    searchSkillsSh(technologies),
-    searchTessl(technologies)
+  const permissions = settings.permissions ?? {};
+  const allow = permissions.allow;
+  if (Array.isArray(allow) && allow.length > 0) return;
+  permissions.allow = [
+    "Bash(npm run *)",
+    "Bash(npx vitest *)",
+    "Bash(npx tsc *)",
+    "Bash(git *)"
   ];
-  if (platform === "claude" || !platform) {
-    searches.push(searchAwesomeClaudeCode(technologies));
-  }
-  const results = await Promise.all(searches);
-  const seen = /* @__PURE__ */ new Set();
-  const combined = [];
-  for (const batch of results) {
-    for (const result of batch) {
-      const key = result.name.toLowerCase().replace(/[-_]/g, "");
-      if (seen.has(key)) continue;
-      seen.add(key);
-      combined.push(result);
+  settings.permissions = permissions;
+  if (!fs22.existsSync(".claude")) fs22.mkdirSync(".claude", { recursive: true });
+  fs22.writeFileSync(settingsPath, JSON.stringify(settings, null, 2) + "\n");
+}
+
+// src/commands/undo.ts
+import chalk8 from "chalk";
+import ora4 from "ora";
+function undoCommand() {
+  const spinner = ora4("Reverting setup...").start();
+  try {
+    const { restored, removed } = undoSetup();
+    if (restored.length === 0 && removed.length === 0) {
+      spinner.info("Nothing to undo.");
+      return;
     }
+    spinner.succeed("Setup reverted successfully.\n");
+    if (restored.length > 0) {
+      console.log(chalk8.cyan("  Restored from backup:"));
+      for (const file of restored) {
+        console.log(`    ${chalk8.green("\u21A9")} ${file}`);
+      }
+    }
+    if (removed.length > 0) {
+      console.log(chalk8.cyan("  Removed:"));
+      for (const file of removed) {
+        console.log(`    ${chalk8.red("\u2717")} ${file}`);
+      }
+    }
+    console.log("");
+  } catch (err) {
+    spinner.fail(chalk8.red(err instanceof Error ? err.message : "Undo failed"));
+    throw new Error("__exit__");
   }
-  return combined;
 }
-async function scoreWithLLM2(candidates, projectContext, technologies) {
-  const candidateList = candidates.map((c, i) => `${i}. "${c.name}" \u2014 ${c.reason || "no description"}`).join("\n");
-  const scored = await llmJsonCall({
-    system: `You evaluate whether AI agent skills and tools are relevant to a specific software project.
-Given a project context and a list of candidates, score each one's relevance from 0-100 and provide a brief reason (max 80 chars).
-
-Return a JSON array where each element has:
-- "index": the candidate's index number
-- "score": relevance score 0-100
-- "reason": one-liner explaining why it fits or doesn't
 
-Scoring guidelines:
-- 90-100: Directly matches a core technology or workflow in the project
-- 70-89: Relevant to the project's stack, patterns, or development workflow
-- 50-69: Tangentially related or generic but useful
-- 0-49: Not relevant to this project
-
-Be selective. Prefer specific, high-quality matches over generic ones.
-A skill for "React testing" is only relevant if the project uses React.
-A generic "TypeScript best practices" skill is less valuable than one targeting the project's actual framework.
-Return ONLY the JSON array.`,
-    prompt: `PROJECT CONTEXT:
-${projectContext}
-
-DETECTED TECHNOLOGIES:
-${technologies.join(", ")}
-
-CANDIDATES:
-${candidateList}`,
-    maxTokens: 8e3
-  });
-  if (!Array.isArray(scored)) return [];
-  return scored.filter((s) => s.score >= 60 && s.index >= 0 && s.index < candidates.length).sort((a, b) => b.score - a.score).slice(0, 20).map((s) => ({
-    ...candidates[s.index],
-    score: s.score,
-    reason: s.reason || candidates[s.index].reason
-  }));
-}
-function buildProjectContext(dir) {
-  const parts = [];
-  const fingerprint = collectFingerprint(dir);
-  if (fingerprint.packageName) parts.push(`Package: ${fingerprint.packageName}`);
-  if (fingerprint.languages.length > 0) parts.push(`Languages: ${fingerprint.languages.join(", ")}`);
-  if (fingerprint.frameworks.length > 0) parts.push(`Frameworks: ${fingerprint.frameworks.join(", ")}`);
-  if (fingerprint.description) parts.push(`Description: ${fingerprint.description}`);
-  if (fingerprint.fileTree.length > 0) {
-    parts.push(`
-File tree (${fingerprint.fileTree.length} files):
-${fingerprint.fileTree.slice(0, 50).join("\n")}`);
+// src/commands/status.ts
+import chalk9 from "chalk";
+import fs23 from "fs";
+async function statusCommand(options) {
+  const config = loadConfig();
+  const manifest = readManifest();
+  if (options.json) {
+    console.log(JSON.stringify({
+      configured: !!config,
+      provider: config?.provider,
+      model: config?.model,
+      manifest
+    }, null, 2));
+    return;
   }
-  if (fingerprint.existingConfigs.claudeMd) {
-    parts.push(`
-Existing CLAUDE.md (first 500 chars):
-${fingerprint.existingConfigs.claudeMd.slice(0, 500)}`);
+  console.log(chalk9.bold("\nCaliber Status\n"));
+  if (config) {
+    console.log(`  LLM: ${chalk9.green(config.provider)} (${config.model})`);
+  } else {
+    console.log(`  LLM: ${chalk9.yellow("Not configured")} \u2014 run ${chalk9.hex("#83D1EB")("caliber config")}`);
   }
-  const deps = extractTopDeps();
-  if (deps.length > 0) {
-    parts.push(`
-Dependencies: ${deps.slice(0, 30).join(", ")}`);
+  if (!manifest) {
+    console.log(`  Setup: ${chalk9.dim("No setup applied")}`);
+    console.log(chalk9.dim("\n  Run ") + chalk9.hex("#83D1EB")("caliber onboard") + chalk9.dim(" to get started.\n"));
+    return;
   }
-  const installed = getInstalledSkills();
-  if (installed.size > 0) {
-    parts.push(`
-Already installed skills: ${Array.from(installed).join(", ")}`);
+  console.log(`  Files managed: ${chalk9.cyan(manifest.entries.length.toString())}`);
+  for (const entry of manifest.entries) {
+    const exists = fs23.existsSync(entry.path);
+    const icon = exists ? chalk9.green("\u2713") : chalk9.red("\u2717");
+    console.log(`    ${icon} ${entry.path} (${entry.action})`);
   }
-  return parts.join("\n");
+  console.log("");
 }
-function extractTopDeps() {
-  const pkgPath = join8(process.cwd(), "package.json");
-  if (!existsSync9(pkgPath)) return [];
-  try {
-    const pkg3 = JSON.parse(readFileSync7(pkgPath, "utf-8"));
-    const deps = Object.keys(pkg3.dependencies ?? {});
-    const trivial = /* @__PURE__ */ new Set([
-      "typescript",
-      "tslib",
-      "ts-node",
-      "tsx",
-      "prettier",
-      "eslint",
-      "@eslint/js",
-      "rimraf",
-      "cross-env",
-      "dotenv",
-      "nodemon",
-      "husky",
-      "lint-staged",
-      "commitlint",
-      "chalk",
-      "ora",
-      "commander",
-      "yargs",
-      "meow",
-      "inquirer",
-      "@inquirer/confirm",
-      "@inquirer/select",
-      "@inquirer/prompts",
-      "glob",
-      "minimatch",
-      "micromatch",
-      "diff",
-      "semver",
-      "uuid",
-      "nanoid",
-      "debug",
-      "ms",
-      "lodash",
-      "underscore",
-      "tsup",
-      "esbuild",
-      "rollup",
-      "webpack",
-      "vite",
-      "vitest",
-      "jest",
-      "mocha",
-      "chai",
-      "ava",
-      "fs-extra",
-      "mkdirp",
-      "del",
-      "rimraf",
-      "path-to-regexp",
-      "strip-ansi",
-      "ansi-colors"
-    ]);
-    const trivialPatterns = [
-      /^@types\//,
-      /^@rely-ai\//,
-      /^@caliber-ai\//,
-      /^eslint-/,
-      /^@eslint\//,
-      /^prettier-/,
-      /^@typescript-eslint\//,
-      /^@commitlint\//
-    ];
-    return deps.filter(
-      (d) => !trivial.has(d) && !trivialPatterns.some((p) => p.test(d))
-    );
-  } catch {
-    return [];
+
+// src/commands/regenerate.ts
+import chalk10 from "chalk";
+import ora5 from "ora";
+import select5 from "@inquirer/select";
+async function regenerateCommand(options) {
+  const config = loadConfig();
+  if (!config) {
+    console.log(chalk10.red("No LLM provider configured. Run ") + chalk10.hex("#83D1EB")("caliber config") + chalk10.red(" first."));
+    throw new Error("__exit__");
   }
-}
-async function recommendCommand(options) {
+  const manifest = readManifest();
+  if (!manifest) {
+    console.log(chalk10.yellow("No existing setup found. Run ") + chalk10.hex("#83D1EB")("caliber onboard") + chalk10.yellow(" first."));
+    throw new Error("__exit__");
+  }
+  const targetAgent = readState()?.targetAgent ?? ["claude", "cursor"];
+  const spinner = ora5("Analyzing project...").start();
   const fingerprint = collectFingerprint(process.cwd());
-  const platforms = detectLocalPlatforms();
-  const installedSkills = getInstalledSkills();
-  const technologies = [...new Set([
-    ...fingerprint.languages,
-    ...fingerprint.frameworks,
-    ...extractTopDeps()
-  ].filter(Boolean))];
-  if (technologies.length === 0) {
-    console.log(chalk9.yellow("Could not detect any languages or dependencies. Try running from a project root."));
+  await enrichFingerprintWithLLM(fingerprint, process.cwd());
+  spinner.succeed("Project analyzed");
+  const baselineScore = computeLocalScore(process.cwd(), targetAgent);
+  displayScoreSummary(baselineScore);
+  if (baselineScore.score === 100) {
+    console.log(chalk10.green("  Your setup is already at 100/100 \u2014 nothing to regenerate.\n"));
+    return;
+  }
+  const genSpinner = ora5("Regenerating setup...").start();
+  const genMessages = new SpinnerMessages(genSpinner, GENERATION_MESSAGES, { showElapsedTime: true });
+  genMessages.start();
+  let generatedSetup = null;
+  try {
+    const result = await generateSetup(
+      fingerprint,
+      targetAgent,
+      void 0,
+      {
+        onStatus: (status) => {
+          genMessages.handleServerStatus(status);
+        },
+        onComplete: (setup) => {
+          generatedSetup = setup;
+        },
+        onError: (error) => {
+          genMessages.stop();
+          genSpinner.fail(`Generation error: ${error}`);
+        }
+      }
+    );
+    if (!generatedSetup) generatedSetup = result.setup;
+  } catch (err) {
+    genMessages.stop();
+    const msg = err instanceof Error ? err.message : "Unknown error";
+    genSpinner.fail(`Regeneration failed: ${msg}`);
     throw new Error("__exit__");
   }
-  const primaryPlatform = platforms.includes("claude") ? "claude" : platforms[0];
-  const searchSpinner = ora5("Searching skill registries...").start();
-  const allCandidates = await searchAllProviders(technologies, primaryPlatform);
-  if (!allCandidates.length) {
-    searchSpinner.succeed("No skills found matching your tech stack.");
-    return;
+  genMessages.stop();
+  if (!generatedSetup) {
+    genSpinner.fail("Failed to regenerate setup.");
+    throw new Error("__exit__");
   }
-  const newCandidates = allCandidates.filter((c) => !installedSkills.has(c.slug.toLowerCase()));
-  const filteredCount = allCandidates.length - newCandidates.length;
-  if (!newCandidates.length) {
-    searchSpinner.succeed(`Found ${allCandidates.length} skills \u2014 all already installed.`);
+  genSpinner.succeed("Setup regenerated");
+  const setupFiles = collectSetupFiles(generatedSetup);
+  const staged = stageFiles(setupFiles, process.cwd());
+  const totalChanges = staged.newFiles + staged.modifiedFiles;
+  console.log(chalk10.dim(`
+  ${chalk10.green(`${staged.newFiles} new`)} / ${chalk10.yellow(`${staged.modifiedFiles} modified`)} file${totalChanges !== 1 ? "s" : ""}
+`));
+  if (totalChanges === 0) {
+    console.log(chalk10.dim("  No changes needed \u2014 your configs are already up to date.\n"));
+    cleanupStaging();
     return;
   }
-  searchSpinner.succeed(
-    `Found ${allCandidates.length} skills` + (filteredCount > 0 ? chalk9.dim(` (${filteredCount} already installed)`) : "")
-  );
-  let results;
-  const config = loadConfig();
-  if (config) {
-    const scoreSpinner = ora5("Scoring relevance for your project...").start();
-    try {
-      const projectContext = buildProjectContext(process.cwd());
-      results = await scoreWithLLM2(newCandidates, projectContext, technologies);
-      if (results.length === 0) {
-        scoreSpinner.succeed("No highly relevant skills found for your specific project.");
-        return;
-      }
-      scoreSpinner.succeed(`${results.length} relevant skill${results.length > 1 ? "s" : ""} for your project`);
-    } catch {
-      scoreSpinner.warn("Could not score relevance \u2014 showing top results");
-      results = newCandidates.slice(0, 20);
+  if (options.dryRun) {
+    console.log(chalk10.yellow("[Dry run] Would write:"));
+    for (const f of staged.stagedFiles) {
+      console.log(`  ${f.isNew ? chalk10.green("+") : chalk10.yellow("~")} ${f.relativePath}`);
     }
-  } else {
-    results = newCandidates.slice(0, 20);
-  }
-  const fetchSpinner = ora5("Verifying skill availability...").start();
-  const contentMap = /* @__PURE__ */ new Map();
-  await Promise.all(results.map(async (rec) => {
-    const content = await fetchSkillContent(rec);
-    if (content) contentMap.set(rec.slug, content);
-  }));
-  const available = results.filter((r) => contentMap.has(r.slug));
-  if (!available.length) {
-    fetchSpinner.fail("No installable skills found \u2014 content could not be fetched.");
+    cleanupStaging();
     return;
   }
-  const unavailableCount = results.length - available.length;
-  fetchSpinner.succeed(
-    `${available.length} installable skill${available.length > 1 ? "s" : ""}` + (unavailableCount > 0 ? chalk9.dim(` (${unavailableCount} unavailable)`) : "")
-  );
-  const selected = await interactiveSelect2(available);
-  if (selected?.length) {
-    await installSkills(selected, platforms, contentMap);
+  const wantsReview = await promptWantsReview();
+  if (wantsReview) {
+    const reviewMethod = await promptReviewMethod();
+    await openReview(reviewMethod, staged.stagedFiles);
   }
-}
-async function interactiveSelect2(recs) {
-  if (!process.stdin.isTTY) {
-    printRecommendations(recs);
-    return null;
+  const action = await select5({
+    message: "Apply regenerated setup?",
+    choices: [
+      { name: "Accept and apply", value: "accept" },
+      { name: "Decline", value: "decline" }
+    ]
+  });
+  cleanupStaging();
+  if (action === "decline") {
+    console.log(chalk10.dim("Regeneration cancelled. No files were modified."));
+    return;
   }
-  const selected = /* @__PURE__ */ new Set();
-  let cursor = 0;
-  const { stdin, stdout } = process;
-  let lineCount = 0;
-  const hasScores = recs.some((r) => r.score > 0);
-  function render() {
-    const lines = [];
-    lines.push(chalk9.bold("  Recommendations"));
-    lines.push("");
-    if (hasScores) {
-      lines.push(`  ${chalk9.dim("Score".padEnd(7))} ${chalk9.dim("Name".padEnd(28))} ${chalk9.dim("Why")}`);
-    } else {
-      lines.push(`  ${chalk9.dim("Name".padEnd(30))} ${chalk9.dim("Technology".padEnd(18))} ${chalk9.dim("Source")}`);
+  const writeSpinner = ora5("Writing config files...").start();
+  try {
+    const result = writeSetup(generatedSetup);
+    writeSpinner.succeed("Config files written");
+    for (const file of result.written) {
+      console.log(`  ${chalk10.green("\u2713")} ${file}`);
     }
-    lines.push(chalk9.dim("  " + "\u2500".repeat(70)));
-    for (let i = 0; i < recs.length; i++) {
-      const rec = recs[i];
-      const check = selected.has(i) ? chalk9.green("[x]") : "[ ]";
-      const ptr = i === cursor ? chalk9.cyan(">") : " ";
-      if (hasScores) {
-        const scoreColor = rec.score >= 90 ? chalk9.green : rec.score >= 70 ? chalk9.yellow : chalk9.dim;
-        lines.push(`  ${ptr} ${check} ${scoreColor(String(rec.score).padStart(3))}   ${rec.name.padEnd(26)} ${chalk9.dim(rec.reason.slice(0, 40))}`);
-      } else {
-        lines.push(`  ${ptr} ${check} ${rec.name.padEnd(28)} ${rec.detected_technology.padEnd(16)} ${chalk9.dim(rec.source_url || "")}`);
+    if (result.deleted.length > 0) {
+      for (const file of result.deleted) {
+        console.log(`  ${chalk10.red("\u2717")} ${file}`);
       }
     }
-    lines.push("");
-    lines.push(chalk9.dim("  \u2191\u2193 navigate  \u23B5 toggle  a all  n none  \u23CE install  q cancel"));
-    return lines.join("\n");
-  }
-  function draw(initial) {
-    if (!initial && lineCount > 0) {
-      stdout.write(`\x1B[${lineCount}A`);
+    if (result.backupDir) {
+      console.log(chalk10.dim(`
+  Backups saved to ${result.backupDir}`));
     }
-    stdout.write("\x1B[0J");
-    const output = render();
-    stdout.write(output + "\n");
-    lineCount = output.split("\n").length;
+  } catch (err) {
+    writeSpinner.fail("Failed to write files");
+    console.error(chalk10.red(err instanceof Error ? err.message : "Unknown error"));
+    throw new Error("__exit__");
   }
-  return new Promise((resolve2) => {
-    console.log("");
-    draw(true);
-    stdin.setRawMode(true);
-    stdin.resume();
-    stdin.setEncoding("utf8");
-    function cleanup() {
-      stdin.removeListener("data", onData);
-      stdin.setRawMode(false);
-      stdin.pause();
-    }
-    function onData(key) {
-      switch (key) {
-        case "\x1B[A":
-          cursor = (cursor - 1 + recs.length) % recs.length;
-          draw(false);
-          break;
-        case "\x1B[B":
-          cursor = (cursor + 1) % recs.length;
-          draw(false);
-          break;
-        case " ":
-          selected.has(cursor) ? selected.delete(cursor) : selected.add(cursor);
-          draw(false);
-          break;
-        case "a":
-          recs.forEach((_, i) => selected.add(i));
-          draw(false);
-          break;
-        case "n":
-          selected.clear();
-          draw(false);
-          break;
-        case "\r":
-        case "\n":
-          cleanup();
-          if (selected.size === 0) {
-            console.log(chalk9.dim("\n  No skills selected.\n"));
-            resolve2(null);
-          } else {
-            resolve2(Array.from(selected).sort().map((i) => recs[i]));
-          }
-          break;
-        case "q":
-        case "\x1B":
-        case "":
-          cleanup();
-          console.log(chalk9.dim("\n  Cancelled.\n"));
-          resolve2(null);
-          break;
-      }
-    }
-    stdin.on("data", onData);
+  const sha = getCurrentHeadSha();
+  writeState({
+    lastRefreshSha: sha ?? "",
+    lastRefreshTimestamp: (/* @__PURE__ */ new Date()).toISOString(),
+    targetAgent
   });
-}
-async function fetchSkillContent(rec) {
-  if (!rec.source_url) return null;
-  const repoPath = rec.source_url.replace("https://github.com/", "");
-  const candidates = [
-    `https://raw.githubusercontent.com/${repoPath}/HEAD/skills/${rec.slug}/SKILL.md`,
-    `https://raw.githubusercontent.com/${repoPath}/HEAD/${rec.slug}/SKILL.md`,
-    `https://raw.githubusercontent.com/${repoPath}/HEAD/.claude/skills/${rec.slug}/SKILL.md`,
-    `https://raw.githubusercontent.com/${repoPath}/HEAD/.agents/skills/${rec.slug}/SKILL.md`
-  ];
-  for (const url of candidates) {
+  const afterScore = computeLocalScore(process.cwd(), targetAgent);
+  if (afterScore.score < baselineScore.score) {
+    console.log("");
+    console.log(chalk10.yellow(`  Score would drop from ${baselineScore.score} to ${afterScore.score} \u2014 reverting changes.`));
     try {
-      const resp = await fetch(url, { signal: AbortSignal.timeout(1e4) });
-      if (resp.ok) {
-        const text = await resp.text();
-        if (text.length > 20) return text;
+      const { restored, removed } = undoSetup();
+      if (restored.length > 0 || removed.length > 0) {
+        console.log(chalk10.dim(`  Reverted ${restored.length + removed.length} file${restored.length + removed.length === 1 ? "" : "s"} from backup.`));
       }
     } catch {
     }
+    console.log(chalk10.dim("  Run ") + chalk10.hex("#83D1EB")("caliber onboard --force") + chalk10.dim(" to override.\n"));
+    return;
   }
-  try {
-    const resp = await fetch(
-      `https://api.github.com/repos/${repoPath}/git/trees/HEAD?recursive=1`,
-      { signal: AbortSignal.timeout(1e4) }
-    );
-    if (resp.ok) {
-      const tree = await resp.json();
-      const needle = `${rec.slug}/SKILL.md`;
-      const match = tree.tree?.find((f) => f.path.endsWith(needle));
-      if (match) {
-        const rawUrl = `https://raw.githubusercontent.com/${repoPath}/HEAD/${match.path}`;
-        const contentResp = await fetch(rawUrl, { signal: AbortSignal.timeout(1e4) });
-        if (contentResp.ok) return await contentResp.text();
-      }
-    }
-  } catch {
-  }
-  return null;
-}
-async function installSkills(recs, platforms, contentMap) {
-  const spinner = ora5(`Installing ${recs.length} skill${recs.length > 1 ? "s" : ""}...`).start();
-  const installed = [];
-  for (const rec of recs) {
-    const content = contentMap.get(rec.slug);
-    if (!content) continue;
-    for (const platform of platforms) {
-      const skillPath = getSkillPath(platform, rec.slug);
-      const fullPath = join8(process.cwd(), skillPath);
-      mkdirSync(dirname2(fullPath), { recursive: true });
-      writeFileSync(fullPath, content, "utf-8");
-      installed.push(`[${platform}] ${skillPath}`);
-    }
-  }
-  if (installed.length > 0) {
-    spinner.succeed(`Installed ${installed.length} file${installed.length > 1 ? "s" : ""}`);
-    for (const p of installed) {
-      console.log(chalk9.green(`  \u2713 ${p}`));
-    }
-  } else {
-    spinner.fail("No skills were installed");
-  }
-  console.log("");
-}
-function printRecommendations(recs) {
-  const hasScores = recs.some((r) => r.score > 0);
-  console.log(chalk9.bold("\n  Recommendations\n"));
-  if (hasScores) {
-    console.log(`  ${chalk9.dim("Score".padEnd(7))} ${chalk9.dim("Name".padEnd(28))} ${chalk9.dim("Why")}`);
-  } else {
-    console.log(`  ${chalk9.dim("Name".padEnd(30))} ${chalk9.dim("Technology".padEnd(18))} ${chalk9.dim("Source")}`);
-  }
-  console.log(chalk9.dim("  " + "\u2500".repeat(70)));
-  for (const rec of recs) {
-    if (hasScores) {
-      console.log(`  ${String(rec.score).padStart(3)}   ${rec.name.padEnd(26)} ${chalk9.dim(rec.reason.slice(0, 50))}`);
-    } else {
-      console.log(`  ${rec.name.padEnd(28)} ${rec.detected_technology.padEnd(16)} ${chalk9.dim(rec.source_url || "")}`);
-    }
-  }
-  console.log("");
+  displayScoreDelta(baselineScore, afterScore);
+  console.log(chalk10.bold.green("  Regeneration complete!"));
+  console.log(chalk10.dim("  Run ") + chalk10.hex("#83D1EB")("caliber undo") + chalk10.dim(" to revert changes.\n"));
 }
 
 // src/commands/score.ts
-import chalk10 from "chalk";
+import chalk11 from "chalk";
 async function scoreCommand(options) {
   const dir = process.cwd();
   const target = options.agent ?? readState()?.targetAgent;
@@ -6134,22 +6196,22 @@ async function scoreCommand(options) {
     return;
   }
   displayScore(result);
-  const separator = chalk10.gray("  " + "\u2500".repeat(53));
+  const separator = chalk11.gray("  " + "\u2500".repeat(53));
   console.log(separator);
   if (result.score < 40) {
-    console.log(chalk10.gray("  Run ") + chalk10.hex("#83D1EB")("caliber onboard") + chalk10.gray(" to generate a complete, optimized setup."));
+    console.log(chalk11.gray("  Run ") + chalk11.hex("#83D1EB")("caliber onboard") + chalk11.gray(" to generate a complete, optimized setup."));
   } else if (result.score < 70) {
-    console.log(chalk10.gray("  Run ") + chalk10.hex("#83D1EB")("caliber onboard") + chalk10.gray(" to improve your setup."));
+    console.log(chalk11.gray("  Run ") + chalk11.hex("#83D1EB")("caliber onboard") + chalk11.gray(" to improve your setup."));
   } else {
-    console.log(chalk10.green("  Looking good!") + chalk10.gray(" Run ") + chalk10.hex("#83D1EB")("caliber regenerate") + chalk10.gray(" to rebuild from scratch."));
+    console.log(chalk11.green("  Looking good!") + chalk11.gray(" Run ") + chalk11.hex("#83D1EB")("caliber regenerate") + chalk11.gray(" to rebuild from scratch."));
   }
   console.log("");
 }
 
 // src/commands/refresh.ts
-import fs24 from "fs";
+import fs25 from "fs";
 import path19 from "path";
-import chalk11 from "chalk";
+import chalk12 from "chalk";
 import ora6 from "ora";
 
 // src/lib/git-diff.ts
@@ -6225,37 +6287,37 @@ function collectDiff(lastSha) {
 }
 
 // src/writers/refresh.ts
-import fs23 from "fs";
+import fs24 from "fs";
 import path18 from "path";
 function writeRefreshDocs(docs) {
   const written = [];
   if (docs.claudeMd) {
-    fs23.writeFileSync("CLAUDE.md", docs.claudeMd);
+    fs24.writeFileSync("CLAUDE.md", docs.claudeMd);
     written.push("CLAUDE.md");
   }
   if (docs.readmeMd) {
-    fs23.writeFileSync("README.md", docs.readmeMd);
+    fs24.writeFileSync("README.md", docs.readmeMd);
     written.push("README.md");
   }
   if (docs.cursorrules) {
-    fs23.writeFileSync(".cursorrules", docs.cursorrules);
+    fs24.writeFileSync(".cursorrules", docs.cursorrules);
     written.push(".cursorrules");
   }
   if (docs.cursorRules) {
     const rulesDir = path18.join(".cursor", "rules");
-    if (!fs23.existsSync(rulesDir)) fs23.mkdirSync(rulesDir, { recursive: true });
+    if (!fs24.existsSync(rulesDir)) fs24.mkdirSync(rulesDir, { recursive: true });
     for (const rule of docs.cursorRules) {
       const filePath = path18.join(rulesDir, rule.filename);
-      fs23.writeFileSync(filePath, rule.content);
+      fs24.writeFileSync(filePath, rule.content);
       written.push(filePath);
     }
   }
   if (docs.claudeSkills) {
     const skillsDir = path18.join(".claude", "skills");
-    if (!fs23.existsSync(skillsDir)) fs23.mkdirSync(skillsDir, { recursive: true });
+    if (!fs24.existsSync(skillsDir)) fs24.mkdirSync(skillsDir, { recursive: true });
     for (const skill of docs.claudeSkills) {
       const filePath = path18.join(skillsDir, skill.filename);
-      fs23.writeFileSync(filePath, skill.content);
+      fs24.writeFileSync(filePath, skill.content);
       written.push(filePath);
     }
   }
@@ -6332,11 +6394,11 @@ function log(quiet, ...args) {
 function discoverGitRepos(parentDir) {
   const repos = [];
   try {
-    const entries = fs24.readdirSync(parentDir, { withFileTypes: true });
+    const entries = fs25.readdirSync(parentDir, { withFileTypes: true });
     for (const entry of entries) {
       if (!entry.isDirectory() || entry.name.startsWith(".")) continue;
       const childPath = path19.join(parentDir, entry.name);
-      if (fs24.existsSync(path19.join(childPath, ".git"))) {
+      if (fs25.existsSync(path19.join(childPath, ".git"))) {
         repos.push(childPath);
       }
     }
@@ -6346,7 +6408,7 @@ function discoverGitRepos(parentDir) {
 }
 async function refreshSingleRepo(repoDir, options) {
   const quiet = !!options.quiet;
-  const prefix = options.label ? `${chalk11.bold(options.label)} ` : "";
+  const prefix = options.label ? `${chalk12.bold(options.label)} ` : "";
   const state = readState();
   const lastSha = state?.lastRefreshSha ?? null;
   const diff = collectDiff(lastSha);
@@ -6355,7 +6417,7 @@ async function refreshSingleRepo(repoDir, options) {
     if (currentSha) {
       writeState({ lastRefreshSha: currentSha, lastRefreshTimestamp: (/* @__PURE__ */ new Date()).toISOString() });
     }
-    log(quiet, chalk11.dim(`${prefix}No changes since last refresh.`));
+    log(quiet, chalk12.dim(`${prefix}No changes since last refresh.`));
     return;
   }
   const spinner = quiet ? null : ora6(`${prefix}Analyzing changes...`).start();
@@ -6387,10 +6449,10 @@ async function refreshSingleRepo(repoDir, options) {
   if (options.dryRun) {
     spinner?.info(`${prefix}Dry run \u2014 would update:`);
     for (const doc of response.docsUpdated) {
-      console.log(`  ${chalk11.yellow("~")} ${doc}`);
+      console.log(`  ${chalk12.yellow("~")} ${doc}`);
     }
     if (response.changesSummary) {
-      console.log(chalk11.dim(`
+      console.log(chalk12.dim(`
   ${response.changesSummary}`));
     }
     return;
@@ -6398,10 +6460,10 @@ async function refreshSingleRepo(repoDir, options) {
   const written = writeRefreshDocs(response.updatedDocs);
   spinner?.succeed(`${prefix}Updated ${written.length} doc${written.length === 1 ? "" : "s"}`);
   for (const file of written) {
-    log(quiet, `  ${chalk11.green("\u2713")} ${file}`);
+    log(quiet, `  ${chalk12.green("\u2713")} ${file}`);
   }
   if (response.changesSummary) {
-    log(quiet, chalk11.dim(`
+    log(quiet, chalk12.dim(`
   ${response.changesSummary}`));
   }
   if (currentSha) {
@@ -6414,7 +6476,7 @@ async function refreshCommand(options) {
     const config = loadConfig();
     if (!config) {
       if (quiet) return;
-      console.log(chalk11.red("No LLM provider configured. Run ") + chalk11.hex("#83D1EB")("caliber config") + chalk11.red(" (e.g. choose Cursor) or set an API key."));
+      console.log(chalk12.red("No LLM provider configured. Run ") + chalk12.hex("#83D1EB")("caliber config") + chalk12.red(" (e.g. choose Cursor) or set an API key."));
       throw new Error("__exit__");
     }
     if (isGitRepo()) {
@@ -6424,10 +6486,10 @@ async function refreshCommand(options) {
     const repos = discoverGitRepos(process.cwd());
     if (repos.length === 0) {
       if (quiet) return;
-      console.log(chalk11.red("Not inside a git repository and no git repos found in child directories."));
+      console.log(chalk12.red("Not inside a git repository and no git repos found in child directories."));
       throw new Error("__exit__");
     }
-    log(quiet, chalk11.dim(`Found ${repos.length} git repo${repos.length === 1 ? "" : "s"}
+    log(quiet, chalk12.dim(`Found ${repos.length} git repo${repos.length === 1 ? "" : "s"}
 `));
     const originalDir = process.cwd();
     for (const repo of repos) {
@@ -6437,7 +6499,7 @@ async function refreshCommand(options) {
         await refreshSingleRepo(repo, { ...options, label: repoName });
       } catch (err) {
         if (err instanceof Error && err.message === "__exit__") continue;
-        log(quiet, chalk11.yellow(`${repoName}: refresh failed \u2014 ${err instanceof Error ? err.message : "unknown error"}`));
+        log(quiet, chalk12.yellow(`${repoName}: refresh failed \u2014 ${err instanceof Error ? err.message : "unknown error"}`));
       }
     }
     process.chdir(originalDir);
@@ -6445,13 +6507,13 @@ async function refreshCommand(options) {
     if (err instanceof Error && err.message === "__exit__") throw err;
     if (quiet) return;
     const msg = err instanceof Error ? err.message : "Unknown error";
-    console.log(chalk11.red(`Refresh failed: ${msg}`));
+    console.log(chalk12.red(`Refresh failed: ${msg}`));
     throw new Error("__exit__");
   }
 }
 
 // src/commands/hooks.ts
-import chalk12 from "chalk";
+import chalk13 from "chalk";
 var HOOKS = [
   {
     id: "session-end",
@@ -6471,13 +6533,13 @@ var HOOKS = [
   }
 ];
 function printStatus() {
-  console.log(chalk12.bold("\n  Hooks\n"));
+  console.log(chalk13.bold("\n  Hooks\n"));
   for (const hook of HOOKS) {
     const installed = hook.isInstalled();
-    const icon = installed ? chalk12.green("\u2713") : chalk12.dim("\u2717");
-    const state = installed ? chalk12.green("enabled") : chalk12.dim("disabled");
+    const icon = installed ? chalk13.green("\u2713") : chalk13.dim("\u2717");
+    const state = installed ? chalk13.green("enabled") : chalk13.dim("disabled");
     console.log(`  ${icon} ${hook.label.padEnd(26)} ${state}`);
-    console.log(chalk12.dim(`    ${hook.description}`));
+    console.log(chalk13.dim(`    ${hook.description}`));
   }
   console.log("");
 }
@@ -6486,9 +6548,9 @@ async function hooksCommand(options) {
     for (const hook of HOOKS) {
       const result = hook.install();
       if (result.alreadyInstalled) {
-        console.log(chalk12.dim(`  ${hook.label} already enabled.`));
+        console.log(chalk13.dim(`  ${hook.label} already enabled.`));
       } else {
-        console.log(chalk12.green("  \u2713") + ` ${hook.label} enabled`);
+        console.log(chalk13.green("  \u2713") + ` ${hook.label} enabled`);
       }
     }
     return;
@@ -6497,9 +6559,9 @@ async function hooksCommand(options) {
     for (const hook of HOOKS) {
       const result = hook.remove();
       if (result.notFound) {
-        console.log(chalk12.dim(`  ${hook.label} already disabled.`));
+        console.log(chalk13.dim(`  ${hook.label} already disabled.`));
       } else {
-        console.log(chalk12.green("  \u2713") + ` ${hook.label} removed`);
+        console.log(chalk13.green("  \u2713") + ` ${hook.label} removed`);
       }
     }
     return;
@@ -6514,18 +6576,18 @@ async function hooksCommand(options) {
   const states = HOOKS.map((h) => h.isInstalled());
   function render() {
     const lines = [];
-    lines.push(chalk12.bold("  Hooks"));
+    lines.push(chalk13.bold("  Hooks"));
     lines.push("");
     for (let i = 0; i < HOOKS.length; i++) {
       const hook = HOOKS[i];
       const enabled = states[i];
-      const toggle = enabled ? chalk12.green("[on] ") : chalk12.dim("[off]");
-      const ptr = i === cursor ? chalk12.cyan(">") : " ";
+      const toggle = enabled ? chalk13.green("[on] ") : chalk13.dim("[off]");
+      const ptr = i === cursor ? chalk13.cyan(">") : " ";
       lines.push(`  ${ptr} ${toggle} ${hook.label}`);
-      lines.push(chalk12.dim(`        ${hook.description}`));
+      lines.push(chalk13.dim(`        ${hook.description}`));
     }
     lines.push("");
-    lines.push(chalk12.dim("  \u2191\u2193 navigate  \u23B5 toggle  a all on  n all off  \u23CE apply  q cancel"));
+    lines.push(chalk13.dim("  \u2191\u2193 navigate  \u23B5 toggle  a all on  n all off  \u23CE apply  q cancel"));
     return lines.join("\n");
   }
   function draw(initial) {
@@ -6556,16 +6618,16 @@ async function hooksCommand(options) {
         const wantEnabled = states[i];
         if (wantEnabled && !wasInstalled) {
           hook.install();
-          console.log(chalk12.green("  \u2713") + ` ${hook.label} enabled`);
+          console.log(chalk13.green("  \u2713") + ` ${hook.label} enabled`);
           changed++;
         } else if (!wantEnabled && wasInstalled) {
           hook.remove();
-          console.log(chalk12.green("  \u2713") + ` ${hook.label} disabled`);
+          console.log(chalk13.green("  \u2713") + ` ${hook.label} disabled`);
           changed++;
         }
       }
       if (changed === 0) {
-        console.log(chalk12.dim("  No changes."));
+        console.log(chalk13.dim("  No changes."));
       }
       console.log("");
     }
@@ -6601,7 +6663,7 @@ async function hooksCommand(options) {
         case "\x1B":
         case "":
           cleanup();
-          console.log(chalk12.dim("\n  Cancelled.\n"));
+          console.log(chalk13.dim("\n  Cancelled.\n"));
           resolve2();
           break;
       }
@@ -6611,48 +6673,48 @@ async function hooksCommand(options) {
 }
 
 // src/commands/config.ts
-import chalk13 from "chalk";
+import chalk14 from "chalk";
 async function configCommand() {
   const existing = loadConfig();
   if (existing) {
     const displayModel = existing.model === "default" && existing.provider === "claude-cli" ? process.env.ANTHROPIC_MODEL || "default (inherited from Claude Code)" : existing.model;
     const fastModel = getFastModel();
-    console.log(chalk13.bold("\nCurrent Configuration\n"));
-    console.log(`  Provider: ${chalk13.cyan(existing.provider)}`);
-    console.log(`  Model:    ${chalk13.cyan(displayModel)}`);
+    console.log(chalk14.bold("\nCurrent Configuration\n"));
+    console.log(`  Provider: ${chalk14.cyan(existing.provider)}`);
+    console.log(`  Model:    ${chalk14.cyan(displayModel)}`);
     if (fastModel) {
-      console.log(`  Scan:     ${chalk13.cyan(fastModel)}`);
+      console.log(`  Scan:     ${chalk14.cyan(fastModel)}`);
     }
     if (existing.apiKey) {
       const masked = existing.apiKey.slice(0, 8) + "..." + existing.apiKey.slice(-4);
-      console.log(`  API Key:  ${chalk13.dim(masked)}`);
+      console.log(`  API Key:  ${chalk14.dim(masked)}`);
     }
     if (existing.provider === "cursor") {
-      console.log(`  Seat:     ${chalk13.dim("Cursor (agent acp)")}`);
+      console.log(`  Seat:     ${chalk14.dim("Cursor (agent acp)")}`);
     }
     if (existing.provider === "claude-cli") {
-      console.log(`  Seat:     ${chalk13.dim("Claude Code (claude -p)")}`);
+      console.log(`  Seat:     ${chalk14.dim("Claude Code (claude -p)")}`);
     }
     if (existing.baseUrl) {
-      console.log(`  Base URL: ${chalk13.dim(existing.baseUrl)}`);
+      console.log(`  Base URL: ${chalk14.dim(existing.baseUrl)}`);
     }
     if (existing.vertexProjectId) {
-      console.log(`  Vertex Project: ${chalk13.dim(existing.vertexProjectId)}`);
-      console.log(`  Vertex Region:  ${chalk13.dim(existing.vertexRegion || "us-east5")}`);
+      console.log(`  Vertex Project: ${chalk14.dim(existing.vertexProjectId)}`);
+      console.log(`  Vertex Region:  ${chalk14.dim(existing.vertexRegion || "us-east5")}`);
     }
-    console.log(`  Source:   ${chalk13.dim(process.env.ANTHROPIC_API_KEY || process.env.OPENAI_API_KEY || process.env.VERTEX_PROJECT_ID || process.env.CALIBER_USE_CURSOR_SEAT || process.env.CALIBER_USE_CLAUDE_CLI ? "environment variables" : getConfigFilePath())}`);
+    console.log(`  Source:   ${chalk14.dim(process.env.ANTHROPIC_API_KEY || process.env.OPENAI_API_KEY || process.env.VERTEX_PROJECT_ID || process.env.CALIBER_USE_CURSOR_SEAT || process.env.CALIBER_USE_CLAUDE_CLI ? "environment variables" : getConfigFilePath())}`);
     console.log("");
   }
   await runInteractiveProviderSetup();
-  console.log(chalk13.green("\n\u2713 Configuration saved"));
-  console.log(chalk13.dim(`  ${getConfigFilePath()}
+  console.log(chalk14.green("\n\u2713 Configuration saved"));
+  console.log(chalk14.dim(`  ${getConfigFilePath()}
 `));
-  console.log(chalk13.dim("  You can also set environment variables instead:"));
-  console.log(chalk13.dim("  ANTHROPIC_API_KEY, OPENAI_API_KEY, VERTEX_PROJECT_ID, CALIBER_USE_CURSOR_SEAT=1, or CALIBER_USE_CLAUDE_CLI=1\n"));
+  console.log(chalk14.dim("  You can also set environment variables instead:"));
+  console.log(chalk14.dim("  ANTHROPIC_API_KEY, OPENAI_API_KEY, VERTEX_PROJECT_ID, CALIBER_USE_CURSOR_SEAT=1, or CALIBER_USE_CLAUDE_CLI=1\n"));
 }
 
 // src/commands/learn.ts
-import chalk14 from "chalk";
+import chalk15 from "chalk";
 
 // src/learner/stdin.ts
 var STDIN_TIMEOUT_MS = 5e3;
@@ -6683,7 +6745,7 @@ function readStdin() {
 
 // src/learner/storage.ts
 init_constants();
-import fs25 from "fs";
+import fs26 from "fs";
 import path20 from "path";
 var MAX_RESPONSE_LENGTH = 2e3;
 var DEFAULT_STATE = {
@@ -6692,8 +6754,8 @@ var DEFAULT_STATE = {
   lastAnalysisTimestamp: null
 };
 function ensureLearningDir() {
-  if (!fs25.existsSync(LEARNING_DIR)) {
-    fs25.mkdirSync(LEARNING_DIR, { recursive: true });
+  if (!fs26.existsSync(LEARNING_DIR)) {
+    fs26.mkdirSync(LEARNING_DIR, { recursive: true });
   }
 }
 function sessionFilePath() {
@@ -6711,49 +6773,49 @@ function appendEvent(event) {
   ensureLearningDir();
   const truncated = { ...event, tool_response: truncateResponse(event.tool_response) };
   const filePath = sessionFilePath();
-  fs25.appendFileSync(filePath, JSON.stringify(truncated) + "\n");
+  fs26.appendFileSync(filePath, JSON.stringify(truncated) + "\n");
   const count = getEventCount();
   if (count > LEARNING_MAX_EVENTS) {
-    const lines = fs25.readFileSync(filePath, "utf-8").split("\n").filter(Boolean);
+    const lines = fs26.readFileSync(filePath, "utf-8").split("\n").filter(Boolean);
     const kept = lines.slice(lines.length - LEARNING_MAX_EVENTS);
-    fs25.writeFileSync(filePath, kept.join("\n") + "\n");
+    fs26.writeFileSync(filePath, kept.join("\n") + "\n");
   }
 }
 function readAllEvents() {
   const filePath = sessionFilePath();
-  if (!fs25.existsSync(filePath)) return [];
-  const lines = fs25.readFileSync(filePath, "utf-8").split("\n").filter(Boolean);
+  if (!fs26.existsSync(filePath)) return [];
+  const lines = fs26.readFileSync(filePath, "utf-8").split("\n").filter(Boolean);
   return lines.map((line) => JSON.parse(line));
 }
 function getEventCount() {
   const filePath = sessionFilePath();
-  if (!fs25.existsSync(filePath)) return 0;
-  const content = fs25.readFileSync(filePath, "utf-8");
+  if (!fs26.existsSync(filePath)) return 0;
+  const content = fs26.readFileSync(filePath, "utf-8");
   return content.split("\n").filter(Boolean).length;
 }
 function clearSession() {
   const filePath = sessionFilePath();
-  if (fs25.existsSync(filePath)) fs25.unlinkSync(filePath);
+  if (fs26.existsSync(filePath)) fs26.unlinkSync(filePath);
 }
 function readState2() {
   const filePath = stateFilePath();
-  if (!fs25.existsSync(filePath)) return { ...DEFAULT_STATE };
+  if (!fs26.existsSync(filePath)) return { ...DEFAULT_STATE };
   try {
-    return JSON.parse(fs25.readFileSync(filePath, "utf-8"));
+    return JSON.parse(fs26.readFileSync(filePath, "utf-8"));
   } catch {
     return { ...DEFAULT_STATE };
   }
 }
 function writeState2(state) {
   ensureLearningDir();
-  fs25.writeFileSync(stateFilePath(), JSON.stringify(state, null, 2));
+  fs26.writeFileSync(stateFilePath(), JSON.stringify(state, null, 2));
 }
 function resetState() {
   writeState2({ ...DEFAULT_STATE });
 }
 
 // src/learner/writer.ts
-import fs26 from "fs";
+import fs27 from "fs";
 import path21 from "path";
 var LEARNED_START = "<!-- caliber:learned -->";
 var LEARNED_END = "<!-- /caliber:learned -->";
@@ -6774,8 +6836,8 @@ function writeLearnedContent(update) {
 function writeLearnedSection(content) {
   const claudeMdPath = "CLAUDE.md";
   let existing = "";
-  if (fs26.existsSync(claudeMdPath)) {
-    existing = fs26.readFileSync(claudeMdPath, "utf-8");
+  if (fs27.existsSync(claudeMdPath)) {
+    existing = fs27.readFileSync(claudeMdPath, "utf-8");
   }
   const section = `${LEARNED_START}
 ${content}
@@ -6789,15 +6851,15 @@ ${LEARNED_END}`;
     const separator = existing.endsWith("\n") || existing === "" ? "" : "\n";
     updated = existing + separator + "\n" + section + "\n";
   }
-  fs26.writeFileSync(claudeMdPath, updated);
+  fs27.writeFileSync(claudeMdPath, updated);
 }
 function writeLearnedSkill(skill) {
   const skillDir = path21.join(".claude", "skills", skill.name);
-  if (!fs26.existsSync(skillDir)) fs26.mkdirSync(skillDir, { recursive: true });
+  if (!fs27.existsSync(skillDir)) fs27.mkdirSync(skillDir, { recursive: true });
   const skillPath = path21.join(skillDir, "SKILL.md");
-  if (!skill.isNew && fs26.existsSync(skillPath)) {
-    const existing = fs26.readFileSync(skillPath, "utf-8");
-    fs26.writeFileSync(skillPath, existing.trimEnd() + "\n\n" + skill.content);
+  if (!skill.isNew && fs27.existsSync(skillPath)) {
+    const existing = fs27.readFileSync(skillPath, "utf-8");
+    fs27.writeFileSync(skillPath, existing.trimEnd() + "\n\n" + skill.content);
   } else {
     const frontmatter = [
       "---",
@@ -6806,14 +6868,14 @@ function writeLearnedSkill(skill) {
       "---",
       ""
     ].join("\n");
-    fs26.writeFileSync(skillPath, frontmatter + skill.content);
+    fs27.writeFileSync(skillPath, frontmatter + skill.content);
   }
   return skillPath;
 }
 function readLearnedSection() {
   const claudeMdPath = "CLAUDE.md";
-  if (!fs26.existsSync(claudeMdPath)) return null;
-  const content = fs26.readFileSync(claudeMdPath, "utf-8");
+  if (!fs27.existsSync(claudeMdPath)) return null;
+  const content = fs27.readFileSync(claudeMdPath, "utf-8");
   const startIdx = content.indexOf(LEARNED_START);
   const endIdx = content.indexOf(LEARNED_END);
   if (startIdx === -1 || endIdx === -1) return null;
@@ -6953,53 +7015,53 @@ async function learnFinalizeCommand() {
 async function learnInstallCommand() {
   const result = installLearningHooks();
   if (result.alreadyInstalled) {
-    console.log(chalk14.dim("Learning hooks already installed."));
+    console.log(chalk15.dim("Learning hooks already installed."));
     return;
   }
-  console.log(chalk14.green("\u2713") + " Learning hooks installed in .claude/settings.json");
-  console.log(chalk14.dim("  PostToolUse, PostToolUseFailure, and SessionEnd hooks active."));
-  console.log(chalk14.dim("  Session learnings will be written to CLAUDE.md and skills."));
+  console.log(chalk15.green("\u2713") + " Learning hooks installed in .claude/settings.json");
+  console.log(chalk15.dim("  PostToolUse, PostToolUseFailure, and SessionEnd hooks active."));
+  console.log(chalk15.dim("  Session learnings will be written to CLAUDE.md and skills."));
 }
 async function learnRemoveCommand() {
   const result = removeLearningHooks();
   if (result.notFound) {
-    console.log(chalk14.dim("Learning hooks not found."));
+    console.log(chalk15.dim("Learning hooks not found."));
     return;
   }
-  console.log(chalk14.green("\u2713") + " Learning hooks removed from .claude/settings.json");
+  console.log(chalk15.green("\u2713") + " Learning hooks removed from .claude/settings.json");
 }
 async function learnStatusCommand() {
   const installed = areLearningHooksInstalled();
   const state = readState2();
   const eventCount = getEventCount();
-  console.log(chalk14.bold("Session Learning Status"));
+  console.log(chalk15.bold("Session Learning Status"));
   console.log();
   if (installed) {
-    console.log(chalk14.green("\u2713") + " Learning hooks are " + chalk14.green("installed"));
+    console.log(chalk15.green("\u2713") + " Learning hooks are " + chalk15.green("installed"));
   } else {
-    console.log(chalk14.dim("\u2717") + " Learning hooks are " + chalk14.yellow("not installed"));
-    console.log(chalk14.dim("  Run `caliber learn install` to enable session learning."));
+    console.log(chalk15.dim("\u2717") + " Learning hooks are " + chalk15.yellow("not installed"));
+    console.log(chalk15.dim("  Run `caliber learn install` to enable session learning."));
   }
   console.log();
-  console.log(`Events recorded: ${chalk14.cyan(String(eventCount))}`);
-  console.log(`Total this session: ${chalk14.cyan(String(state.eventCount))}`);
+  console.log(`Events recorded: ${chalk15.cyan(String(eventCount))}`);
+  console.log(`Total this session: ${chalk15.cyan(String(state.eventCount))}`);
   if (state.lastAnalysisTimestamp) {
-    console.log(`Last analysis: ${chalk14.cyan(state.lastAnalysisTimestamp)}`);
+    console.log(`Last analysis: ${chalk15.cyan(state.lastAnalysisTimestamp)}`);
   } else {
-    console.log(`Last analysis: ${chalk14.dim("none")}`);
+    console.log(`Last analysis: ${chalk15.dim("none")}`);
   }
   const learnedSection = readLearnedSection();
   if (learnedSection) {
     const lineCount = learnedSection.split("\n").filter(Boolean).length;
     console.log(`
-Learned items in CLAUDE.md: ${chalk14.cyan(String(lineCount))}`);
+Learned items in CLAUDE.md: ${chalk15.cyan(String(lineCount))}`);
   }
 }
 
 // src/cli.ts
 var __dirname = path22.dirname(fileURLToPath(import.meta.url));
 var pkg = JSON.parse(
-  fs27.readFileSync(path22.resolve(__dirname, "..", "package.json"), "utf-8")
+  fs28.readFileSync(path22.resolve(__dirname, "..", "package.json"), "utf-8")
 );
 var program = new Command();
 var displayVersion = process.env.CALIBER_LOCAL ? `${pkg.version}-local` : pkg.version;
@@ -7020,7 +7082,7 @@ program.command("undo").description("Revert all config changes made by Caliber")
 program.command("status").description("Show current Caliber setup status").option("--json", "Output as JSON").action(statusCommand);
 program.command("regenerate").alias("regen").alias("re").description("Re-analyze project and regenerate setup").option("--dry-run", "Preview changes without writing files").action(regenerateCommand);
 program.command("config").description("Configure LLM provider, API key, and model").action(configCommand);
-program.command("recommend").description("Discover and install skill recommendations").option("--generate", "Force fresh recommendation search").action(recommendCommand);
+program.command("skills").description("Discover and install community skills for your project").action(recommendCommand);
 program.command("score").description("Score your current agent config setup (deterministic, no network)").option("--json", "Output as JSON").option("--quiet", "One-line output for scripts/hooks").option("--agent <type>", "Target agents (comma-separated): claude, cursor, codex", parseAgentOption).action(scoreCommand);
 program.command("refresh").description("Update docs based on recent code changes").option("--quiet", "Suppress output (for use in hooks)").option("--dry-run", "Preview changes without writing files").action(refreshCommand);
 program.command("hooks").description("Manage auto-refresh hooks (toggle interactively)").option("--install", "Enable all hooks non-interactively").option("--remove", "Disable all hooks non-interactively").action(hooksCommand);
@@ -7032,22 +7094,22 @@ learn.command("remove").description("Remove learning hooks from .claude/settings
 learn.command("status").description("Show learning system status").action(learnStatusCommand);
 
 // src/utils/version-check.ts
-import fs28 from "fs";
+import fs29 from "fs";
 import path23 from "path";
 import { fileURLToPath as fileURLToPath2 } from "url";
 import { execSync as execSync9 } from "child_process";
-import chalk15 from "chalk";
+import chalk16 from "chalk";
 import ora7 from "ora";
 import confirm from "@inquirer/confirm";
 var __dirname_vc = path23.dirname(fileURLToPath2(import.meta.url));
 var pkg2 = JSON.parse(
-  fs28.readFileSync(path23.resolve(__dirname_vc, "..", "package.json"), "utf-8")
+  fs29.readFileSync(path23.resolve(__dirname_vc, "..", "package.json"), "utf-8")
 );
 function getInstalledVersion() {
   try {
     const globalRoot = execSync9("npm root -g", { encoding: "utf-8", stdio: ["pipe", "pipe", "pipe"] }).trim();
     const pkgPath = path23.join(globalRoot, "@rely-ai", "caliber", "package.json");
-    return JSON.parse(fs28.readFileSync(pkgPath, "utf-8")).version;
+    return JSON.parse(fs29.readFileSync(pkgPath, "utf-8")).version;
   } catch {
     return null;
   }
@@ -7070,17 +7132,17 @@ async function checkForUpdates() {
     const isInteractive = process.stdin.isTTY === true;
     if (!isInteractive) {
       console.log(
-        chalk15.yellow(
+        chalk16.yellow(
           `
 Update available: ${current} -> ${latest}
-Run ${chalk15.bold("npm install -g @rely-ai/caliber")} to upgrade.
+Run ${chalk16.bold("npm install -g @rely-ai/caliber")} to upgrade.
 `
         )
       );
       return;
     }
     console.log(
-      chalk15.yellow(`
+      chalk16.yellow(`
 Update available: ${current} -> ${latest}`)
     );
     const shouldUpdate = await confirm({ message: "Would you like to update now? (Y/n)", default: true });
@@ -7098,13 +7160,13 @@ Update available: ${current} -> ${latest}`)
       const installed = getInstalledVersion();
       if (installed !== latest) {
         spinner.fail(`Update incomplete \u2014 got ${installed ?? "unknown"}, expected ${latest}`);
-        console.log(chalk15.yellow(`Run ${chalk15.bold(`npm install -g @rely-ai/caliber@${latest}`)} manually.
+        console.log(chalk16.yellow(`Run ${chalk16.bold(`npm install -g @rely-ai/caliber@${latest}`)} manually.
 `));
         return;
       }
-      spinner.succeed(chalk15.green(`Updated to ${latest}`));
+      spinner.succeed(chalk16.green(`Updated to ${latest}`));
       const args = process.argv.slice(2);
-      console.log(chalk15.dim(`
+      console.log(chalk16.dim(`
 Restarting: caliber ${args.join(" ")}
 `));
       execSync9(`caliber ${args.map((a) => JSON.stringify(a)).join(" ")}`, {
@@ -7117,11 +7179,11 @@ Restarting: caliber ${args.join(" ")}
       if (err instanceof Error) {
         const stderr = err.stderr;
         const errMsg = stderr ? String(stderr).trim().split("\n").pop() : err.message.split("\n")[0];
-        if (errMsg && !errMsg.includes("SIGTERM")) console.log(chalk15.dim(`  ${errMsg}`));
+        if (errMsg && !errMsg.includes("SIGTERM")) console.log(chalk16.dim(`  ${errMsg}`));
       }
       console.log(
-        chalk15.yellow(
-          `Run ${chalk15.bold(`npm install -g @rely-ai/caliber@${latest}`)} manually to upgrade.
+        chalk16.yellow(
+          `Run ${chalk16.bold(`npm install -g @rely-ai/caliber@${latest}`)} manually to upgrade.
 `
         )
       );