@rely-ai/caliber 1.4.2 → 1.5.0

package/dist/bin.js

@@ -56,12 +56,12 @@ import path22 from "path";
 import { fileURLToPath } from "url";
 
 // src/commands/onboard.ts
-import chalk6 from "chalk";
-import ora2 from "ora";
+import chalk7 from "chalk";
+import ora3 from "ora";
 import readline4 from "readline";
-import select3 from "@inquirer/select";
+import select4 from "@inquirer/select";
 import checkbox from "@inquirer/checkbox";
-import fs21 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.
 
@@ -4632,702 +4644,848 @@ async function interactiveSelect(candidates) {
   });
 }
 
-// src/commands/onboard.ts
-async function initCommand(options) {
-  const brand = chalk6.hex("#EB9D83");
-  const title = chalk6.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(chalk6.dim("  Onboard your project for AI-assisted development\n"));
-  console.log(title.bold("  Welcome to Caliber\n"));
-  console.log(chalk6.dim("  Caliber analyzes your codebase and creates tailored config files"));
-  console.log(chalk6.dim("  so your AI coding agents understand your project from day one.\n"));
-  console.log(title.bold("  How onboarding works:\n"));
-  console.log(chalk6.dim("  1. Connect    Set up your LLM provider"));
-  console.log(chalk6.dim("  2. Discover   Analyze your code, dependencies, and structure"));
-  console.log(chalk6.dim("  3. Generate   Create config files tailored to your project"));
-  console.log(chalk6.dim("  4. Review     Preview, refine, and apply the changes"));
-  console.log(chalk6.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(chalk6.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)"
+// 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 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
       });
-    } catch (err) {
-      if (err.message === "__exit__") throw err;
-      throw err;
-    }
-    config = loadConfig();
-    if (!config) {
-      console.log(chalk6.red("  Setup was cancelled or failed.\n"));
-      throw new Error("__exit__");
     }
-    console.log(chalk6.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(chalk6.dim(modelLine + "\n"));
-  console.log(title.bold("  Step 2/5 \u2014 Discover your project\n"));
-  console.log(chalk6.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(chalk6.dim(`  Languages: ${fingerprint.languages.join(", ") || "none detected"}`));
-  console.log(chalk6.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 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
+          });
+        }
+      }
+    } catch {
     }
   }
-  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(chalk6.bold.green("  Your setup is already optimal \u2014 nothing to change.\n"));
-    console.log(chalk6.dim("  Run ") + chalk6.hex("#83D1EB")("caliber onboard --force") + chalk6.dim(" to regenerate anyway.\n"));
-    if (!options.force) return;
+  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
+    });
   }
-  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(chalk6.bold.green("\n  Your config is fully optimized for LLM generation.\n"));
-    console.log(chalk6.dim("  Remaining items need CLI actions:\n"));
-    for (const check of allFailingChecks) {
-      console.log(chalk6.dim(`    \u2022 ${check.name}`));
-      if (check.suggestion) {
-        console.log(`      ${chalk6.hex("#83D1EB")(check.suggestion)}`);
+  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 {
     }
-    console.log("");
-    console.log(chalk6.dim("  Run ") + chalk6.hex("#83D1EB")("caliber onboard --force") + chalk6.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?");
+  const cursorrulesPath = path17.join(dir, ".cursorrules");
+  if (fs21.existsSync(cursorrulesPath)) {
+    items.push({
+      type: "rule",
+      platform: "cursor",
+      name: ".cursorrules",
+      contentHash: hashFile(cursorrulesPath),
+      path: cursorrulesPath
+    });
   }
-  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(chalk6.dim(`  Your setup scores ${baselineScore.score}/100 \u2014 fixing ${failingChecks.length} remaining issue${failingChecks.length === 1 ? "" : "s"}:
-`));
-      for (const check of failingChecks) {
-        console.log(chalk6.dim(`    \u2022 ${check.name}`));
-      }
-      console.log("");
+  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
+      });
     }
-  } else if (hasExistingConfig) {
-    console.log(title.bold("  Step 3/5 \u2014 Improve your setup\n"));
-    console.log(chalk6.dim("  Reviewing your existing configs against your codebase"));
-    console.log(chalk6.dim("  and preparing improvements.\n"));
-  } else {
-    console.log(title.bold("  Step 3/5 \u2014 Build your agent setup\n"));
-    console.log(chalk6.dim("  Creating config files tailored to your project.\n"));
   }
-  console.log(chalk6.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}`);
+  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
+          });
         }
-      },
-      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__");
-  }
-  genMessages.stop();
-  if (!generatedSetup) {
-    genSpinner.fail("Failed to generate setup.");
-    if (rawOutput) {
-      console.log(chalk6.dim("\nRaw LLM output (JSON parse failed):"));
-      console.log(chalk6.dim(rawOutput.slice(0, 500)));
+      }
+    } 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 ${chalk6.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(chalk6.dim(`  ${chalk6.green(`${staged.newFiles} new`)} / ${chalk6.yellow(`${staged.modifiedFiles} modified`)} file${totalChanges !== 1 ? "s" : ""}
-`));
-  let action;
-  if (totalChanges === 0) {
-    console.log(chalk6.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);
+  const cursorMcpPath = path17.join(dir, ".cursor", "mcp.json");
+  if (fs21.existsSync(cursorMcpPath)) {
+    try {
+      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 {
     }
-    action = await promptReviewAction();
   }
-  while (action === "refine") {
-    generatedSetup = await refineLoop(generatedSetup, targetAgent, sessionHistory);
-    if (!generatedSetup) {
-      cleanupStaging();
-      console.log(chalk6.dim("Refinement cancelled. No files were modified."));
-      return;
-    }
-    const updatedFiles = collectSetupFiles(generatedSetup);
-    const restaged = stageFiles(updatedFiles, process.cwd());
-    console.log(chalk6.dim(`  ${chalk6.green(`${restaged.newFiles} new`)} / ${chalk6.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(chalk6.dim("Setup declined. No files were modified."));
-    return;
+  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 (options.dryRun) {
-    console.log(chalk6.yellow("\n[Dry run] Would write the following files:"));
-    console.log(JSON.stringify(generatedSetup, null, 2));
-    return;
+  return platforms.size > 0 ? Array.from(platforms) : ["claude"];
+}
+function getSkillPath(platform, slug) {
+  if (platform === "cursor") {
+    return join8(".cursor", "skills", slug, "SKILL.md");
   }
-  const writeSpinner = ora2("Writing config files...").start();
-  try {
-    const result = writeSetup(generatedSetup);
-    writeSpinner.succeed("Config files written");
-    console.log(chalk6.bold("\nFiles created/updated:"));
-    for (const file of result.written) {
-      console.log(`  ${chalk6.green("\u2713")} ${file}`);
-    }
-    if (result.deleted.length > 0) {
-      console.log(chalk6.bold("\nFiles removed:"));
-      for (const file of result.deleted) {
-        console.log(`  ${chalk6.red("\u2717")} ${file}`);
-      }
-    }
-    if (result.backupDir) {
-      console.log(chalk6.dim(`
-  Backups saved to ${result.backupDir}`));
-    }
-  } catch (err) {
-    writeSpinner.fail("Failed to write files");
-    console.error(chalk6.red(err instanceof Error ? err.message : "Unknown error"));
-    throw new Error("__exit__");
+  if (platform === "codex") {
+    return join8(".agents", "skills", slug, "SKILL.md");
   }
-  console.log(title.bold("\n  Step 5/5 \u2014 Enhance with MCP servers\n"));
-  console.log(chalk6.dim("  MCP servers connect your AI agents to external tools and services"));
-  console.log(chalk6.dim("  like databases, APIs, and platforms your project depends on.\n"));
-  if (fingerprint.tools.length > 0) {
+  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 mcpResult = await discoverAndInstallMcps(targetAgent, fingerprint, process.cwd());
-      if (mcpResult.installed > 0) {
-        console.log(chalk6.bold(`
-  ${mcpResult.installed} MCP server${mcpResult.installed > 1 ? "s" : ""} configured`));
-        for (const name of mcpResult.names) {
-          console.log(`  ${chalk6.green("\u2713")} ${name}`);
+      const entries = readdirSync5(dir, { withFileTypes: true });
+      for (const entry of entries) {
+        if (entry.isDirectory()) {
+          installed.add(entry.name.toLowerCase());
         }
       }
-    } catch (err) {
-      console.log(chalk6.dim("  MCP discovery skipped: " + (err instanceof Error ? err.message : "unknown error")));
-    }
-  } else {
-    console.log(chalk6.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(chalk6.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(`  ${chalk6.green("\u2713")} Claude Code hook installed \u2014 docs update on session end`);
-      console.log(chalk6.dim("    Run ") + chalk6.hex("#83D1EB")("caliber hooks --remove") + chalk6.dim(" to disable"));
-    } else if (hookResult.alreadyInstalled) {
-      console.log(chalk6.dim("  Claude Code hook already installed"));
-    }
-    const learnResult = installLearningHooks();
-    if (learnResult.installed) {
-      console.log(`  ${chalk6.green("\u2713")} Learning hooks installed \u2014 session insights captured automatically`);
-      console.log(chalk6.dim("    Run ") + chalk6.hex("#83D1EB")("caliber learn remove") + chalk6.dim(" to disable"));
-    } else if (learnResult.alreadyInstalled) {
-      console.log(chalk6.dim("  Learning hooks already installed"));
-    }
-  }
-  if (hookChoice === "precommit" || hookChoice === "both") {
-    const precommitResult = installPreCommitHook();
-    if (precommitResult.installed) {
-      console.log(`  ${chalk6.green("\u2713")} Pre-commit hook installed \u2014 docs refresh before each commit`);
-      console.log(chalk6.dim("    Run ") + chalk6.hex("#83D1EB")("caliber hooks --remove") + chalk6.dim(" to disable"));
-    } else if (precommitResult.alreadyInstalled) {
-      console.log(chalk6.dim("  Pre-commit hook already installed"));
-    } else {
-      console.log(chalk6.yellow("  Could not install pre-commit hook (not a git repository?)"));
+    } catch {
     }
   }
-  if (hookChoice === "skip") {
-    console.log(chalk6.dim("  Skipped auto-refresh hooks. Run ") + chalk6.hex("#83D1EB")("caliber hooks --install") + chalk6.dim(" later to enable."));
-  }
-  const afterScore = computeLocalScore(process.cwd(), targetAgent);
-  if (afterScore.score < baselineScore.score) {
-    console.log("");
-    console.log(chalk6.yellow(`  Score would drop from ${baselineScore.score} to ${afterScore.score} \u2014 reverting changes.`));
+  return installed;
+}
+async function searchSkillsSh(technologies) {
+  const bestBySlug = /* @__PURE__ */ new Map();
+  for (const tech of technologies) {
     try {
-      const { restored, removed } = undoSetup();
-      if (restored.length > 0 || removed.length > 0) {
-        console.log(chalk6.dim(`  Reverted ${restored.length + removed.length} file${restored.length + removed.length === 1 ? "" : "s"} from backup.`));
+      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;
     }
-    console.log(chalk6.dim("  Run ") + chalk6.hex("#83D1EB")("caliber onboard --force") + chalk6.dim(" to override.\n"));
-    return;
   }
-  displayScoreDelta(baselineScore, afterScore);
-  console.log(chalk6.bold.green("  Onboarding complete! Your project is ready for AI-assisted development."));
-  console.log(chalk6.dim("  Run ") + chalk6.hex("#83D1EB")("caliber undo") + chalk6.dim(" to revert changes.\n"));
-  console.log(chalk6.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 Array.from(bestBySlug.values());
 }
-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(chalk6.dim("  This doesn't look like a config change request."));
-      console.log(chalk6.dim("  Describe what to add, remove, or modify in your configs."));
-      console.log(chalk6.dim('  Type "done" to accept the current setup.\n'));
-      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)
+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(chalk6.dim('Type "done" to accept, or describe more changes.'));
-    } else {
-      refineSpinner.fail("Refinement failed \u2014 could not parse AI response.");
-      console.log(chalk6.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)
+    });
+    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));
     });
-    return result.valid === true;
   } catch {
-    return true;
+    return [];
   }
 }
-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.
+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 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).
 
-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 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
 
-Return {"dismissed": [{"id": "check_id", "reason": "brief reason"}]} or {"dismissed": []} if all apply.`,
-      prompt: `Languages: ${fingerprint.languages.join(", ") || "none"}
-Frameworks: ${fingerprint.frameworks.join(", ") || "none"}
+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
 
-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 [];
-  }
-}
-function promptInput3(question) {
-  const rl = readline4.createInterface({ input: process.stdin, output: process.stdout });
-  return new Promise((resolve2) => {
-    rl.question(chalk6.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;
-    }
+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 select3({
-    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 promptReviewAction() {
-  return select3({
-    message: "What would you like to do?",
+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: "Accept and apply", value: "accept" },
-      { name: "Refine via chat", value: "refine" },
-      { name: "Decline", value: "decline" }
+      { name: "Yes, find skills for my project", value: true },
+      { name: "No, cancel", value: false }
     ]
   });
+  if (!proceed) {
+    console.log(chalk6.dim("  Cancelled.\n"));
+    return;
+  }
+  await searchAndInstallSkills();
 }
-function printSetupSummary(setup) {
-  const claude = setup.claude;
-  const cursor = setup.cursor;
-  const fileDescriptions = setup.fileDescriptions;
-  const deletions = setup.deletions;
-  console.log("");
-  console.log(chalk6.bold("  Proposed changes:\n"));
-  const getDescription = (filePath) => {
-    return fileDescriptions?.[filePath];
-  };
-  if (claude) {
-    if (claude.claudeMd) {
-      const icon = fs21.existsSync("CLAUDE.md") ? chalk6.yellow("~") : chalk6.green("+");
-      const desc = getDescription("CLAUDE.md");
-      console.log(`  ${icon} ${chalk6.bold("CLAUDE.md")}`);
-      if (desc) console.log(chalk6.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 = fs21.existsSync(skillPath) ? chalk6.yellow("~") : chalk6.green("+");
-        const desc = getDescription(skillPath);
-        console.log(`  ${icon} ${chalk6.bold(skillPath)}`);
-        console.log(chalk6.dim(`    ${desc || skill.description || skill.name}`));
-        console.log("");
+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 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;
+  }
+  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;
+  }
+  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 codex = setup.codex;
-  if (codex) {
-    if (codex.agentsMd) {
-      const icon = fs21.existsSync("AGENTS.md") ? chalk6.yellow("~") : chalk6.green("+");
-      const desc = getDescription("AGENTS.md");
-      console.log(`  ${icon} ${chalk6.bold("AGENTS.md")}`);
-      if (desc) console.log(chalk6.dim(`    ${desc}`));
-      console.log("");
+  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 = [];
+    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")}`);
     }
-    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 = fs21.existsSync(skillPath) ? chalk6.yellow("~") : chalk6.green("+");
-        const desc = getDescription(skillPath);
-        console.log(`  ${icon} ${chalk6.bold(skillPath)}`);
-        console.log(chalk6.dim(`    ${desc || skill.description || skill.name}`));
-        console.log("");
+    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(`  ${ptr} ${check} ${rec.name.padEnd(28)} ${rec.detected_technology.padEnd(16)} ${chalk6.dim(rec.source_url || "")}`);
       }
     }
+    lines.push("");
+    lines.push(chalk6.dim("  \u2191\u2193 navigate  \u23B5 toggle  a all  n none  \u23CE install  q cancel"));
+    return lines.join("\n");
   }
-  if (cursor) {
-    if (cursor.cursorrules) {
-      const icon = fs21.existsSync(".cursorrules") ? chalk6.yellow("~") : chalk6.green("+");
-      const desc = getDescription(".cursorrules");
-      console.log(`  ${icon} ${chalk6.bold(".cursorrules")}`);
-      if (desc) console.log(chalk6.dim(`    ${desc}`));
-      console.log("");
+  function draw(initial) {
+    if (!initial && lineCount > 0) {
+      stdout.write(`\x1B[${lineCount}A`);
     }
-    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 = fs21.existsSync(skillPath) ? chalk6.yellow("~") : chalk6.green("+");
-        const desc = getDescription(skillPath);
-        console.log(`  ${icon} ${chalk6.bold(skillPath)}`);
-        console.log(chalk6.dim(`    ${desc || skill.description || skill.name}`));
-        console.log("");
+    stdout.write("\x1B[0J");
+    const output = render();
+    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) {
+      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;
       }
     }
-    const rules = cursor.rules;
-    if (Array.isArray(rules) && rules.length > 0) {
-      for (const rule of rules) {
-        const rulePath = `.cursor/rules/${rule.filename}`;
-        const icon = fs21.existsSync(rulePath) ? chalk6.yellow("~") : chalk6.green("+");
-        const desc = getDescription(rulePath);
-        console.log(`  ${icon} ${chalk6.bold(rulePath)}`);
-        if (desc) {
-          console.log(chalk6.dim(`    ${desc}`));
-        } else {
-          const firstLine = rule.content.split("\n").filter((l) => l.trim() && !l.trim().startsWith("#"))[0];
-          if (firstLine) console.log(chalk6.dim(`    ${firstLine.trim().slice(0, 80)}`));
-        }
-        console.log("");
+    stdin.on("data", onData);
+  });
+}
+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 {
     }
   }
-  if (!codex && !fs21.existsSync("AGENTS.md")) {
-    console.log(`  ${chalk6.green("+")} ${chalk6.bold("AGENTS.md")}`);
-    console.log(chalk6.dim("    Cross-agent coordination file"));
-    console.log("");
-  }
-  if (Array.isArray(deletions) && deletions.length > 0) {
-    for (const del of deletions) {
-      console.log(`  ${chalk6.red("-")} ${chalk6.bold(del.filePath)}`);
-      console.log(chalk6.dim(`    ${del.reason}`));
-      console.log("");
-    }
-  }
-  console.log(`  ${chalk6.green("+")} ${chalk6.dim("new")}  ${chalk6.yellow("~")} ${chalk6.dim("modified")}  ${chalk6.red("-")} ${chalk6.dim("removed")}`);
-  console.log("");
-}
-function ensurePermissions() {
-  const settingsPath = ".claude/settings.json";
-  let settings = {};
   try {
-    if (fs21.existsSync(settingsPath)) {
-      settings = JSON.parse(fs21.readFileSync(settingsPath, "utf-8"));
+    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 {
   }
-  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 (!fs21.existsSync(".claude")) fs21.mkdirSync(".claude", { recursive: true });
-  fs21.writeFileSync(settingsPath, JSON.stringify(settings, null, 2) + "\n");
+  return null;
 }
-
-// src/commands/undo.ts
-import chalk7 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(chalk7.cyan("  Restored from backup:"));
-      for (const file of restored) {
-        console.log(`    ${chalk7.green("\u21A9")} ${file}`);
-      }
+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}`);
     }
-    if (removed.length > 0) {
-      console.log(chalk7.cyan("  Removed:"));
-      for (const file of removed) {
-        console.log(`    ${chalk7.red("\u2717")} ${file}`);
-      }
+  }
+  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}`));
     }
-    console.log("");
-  } catch (err) {
-    spinner.fail(chalk7.red(err instanceof Error ? err.message : "Undo failed"));
-    throw new Error("__exit__");
+  } else {
+    spinner.fail("No skills were installed");
   }
+  console.log("");
 }
-
-// src/commands/status.ts
-import chalk8 from "chalk";
-import fs22 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(chalk8.bold("\nCaliber Status\n"));
-  if (config) {
-    console.log(`  LLM: ${chalk8.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: ${chalk8.yellow("Not configured")} \u2014 run ${chalk8.hex("#83D1EB")("caliber config")}`);
-  }
-  if (!manifest) {
-    console.log(`  Setup: ${chalk8.dim("No setup applied")}`);
-    console.log(chalk8.dim("\n  Run ") + chalk8.hex("#83D1EB")("caliber onboard") + chalk8.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: ${chalk8.cyan(manifest.entries.length.toString())}`);
-  for (const entry of manifest.entries) {
-    const exists = fs22.existsSync(entry.path);
-    const icon = exists ? chalk8.green("\u2713") : chalk8.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 chalk9 from "chalk";
-import ora4 from "ora";
-import select4 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(chalk9.red("No LLM provider configured. Run ") + chalk9.hex("#83D1EB")("caliber config") + chalk9.red(" first."));
-    throw new Error("__exit__");
-  }
-  const manifest = readManifest();
-  if (!manifest) {
-    console.log(chalk9.yellow("No existing setup found. Run ") + chalk9.hex("#83D1EB")("caliber onboard") + chalk9.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);
-  if (baselineScore.score === 100) {
-    console.log(chalk9.green("  Your setup is already at 100/100 \u2014 nothing to regenerate.\n"));
+  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 genSpinner = ora4("Regenerating setup...").start();
+  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);
@@ -5339,797 +5497,688 @@ 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(chalk9.dim(`
-  ${chalk9.green(`${staged.newFiles} new`)} / ${chalk9.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(chalk9.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;
-  }
-  if (options.dryRun) {
-    console.log(chalk9.yellow("[Dry run] Would write:"));
-    for (const f of staged.stagedFiles) {
-      console.log(`  ${f.isNew ? chalk9.green("+") : chalk9.yellow("~")} ${f.relativePath}`);
+    action = "accept";
+  } else {
+    const wantsReview = await promptWantsReview();
+    if (wantsReview) {
+      const reviewMethod = await promptReviewMethod();
+      await openReview(reviewMethod, staged.stagedFiles);
     }
-    cleanupStaging();
-    return;
+    action = await promptReviewAction();
   }
-  const wantsReview = await promptWantsReview();
-  if (wantsReview) {
-    const reviewMethod = await promptReviewMethod();
-    await openReview(reviewMethod, staged.stagedFiles);
+  while (action === "refine") {
+    generatedSetup = await refineLoop(generatedSetup, targetAgent, sessionHistory);
+    if (!generatedSetup) {
+      cleanupStaging();
+      console.log(chalk7.dim("Refinement cancelled. No files were modified."));
+      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 select4({
-    message: "Apply regenerated setup?",
-    choices: [
-      { name: "Accept and apply", value: "accept" },
-      { name: "Decline", value: "decline" }
-    ]
-  });
   cleanupStaging();
   if (action === "decline") {
-    console.log(chalk9.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(`  ${chalk9.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(`  ${chalk9.red("\u2717")} ${file}`);
+        console.log(`  ${chalk7.red("\u2717")} ${file}`);
       }
     }
     if (result.backupDir) {
-      console.log(chalk9.dim(`
+      console.log(chalk7.dim(`
   Backups saved to ${result.backupDir}`));
     }
   } catch (err) {
     writeSpinner.fail("Failed to write files");
-    console.error(chalk9.red(err instanceof Error ? err.message : "Unknown error"));
+    console.error(chalk7.red(err instanceof Error ? err.message : "Unknown error"));
     throw new Error("__exit__");
   }
+  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 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 (err) {
+      console.log(chalk7.dim("  MCP discovery skipped: " + (err instanceof Error ? err.message : "unknown error")));
+    }
+  } else {
+    console.log(chalk7.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(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"));
+    }
+  }
+  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?)"));
+    }
+  }
+  if (hookChoice === "skip") {
+    console.log(chalk7.dim("  Skipped auto-refresh hooks. Run ") + chalk7.hex("#83D1EB")("caliber hooks --install") + chalk7.dim(" later to enable."));
+  }
   const afterScore = computeLocalScore(process.cwd(), targetAgent);
   if (afterScore.score < baselineScore.score) {
     console.log("");
-    console.log(chalk9.yellow(`  Score would drop from ${baselineScore.score} to ${afterScore.score} \u2014 reverting changes.`));
+    console.log(chalk7.yellow(`  Score would drop from ${baselineScore.score} to ${afterScore.score} \u2014 reverting changes.`));
     try {
       const { restored, removed } = undoSetup();
       if (restored.length > 0 || removed.length > 0) {
-        console.log(chalk9.dim(`  Reverted ${restored.length + removed.length} file${restored.length + removed.length === 1 ? "" : "s"} from backup.`));
+        console.log(chalk7.dim(`  Reverted ${restored.length + removed.length} file${restored.length + removed.length === 1 ? "" : "s"} from backup.`));
       }
     } catch {
     }
-    console.log(chalk9.dim("  Run ") + chalk9.hex("#83D1EB")("caliber onboard --force") + chalk9.dim(" to override.\n"));
+    console.log(chalk7.dim("  Run ") + chalk7.hex("#83D1EB")("caliber onboard --force") + chalk7.dim(" to override.\n"));
     return;
   }
   displayScoreDelta(baselineScore, afterScore);
-  console.log(chalk9.bold.green("  Regeneration complete!"));
-  console.log(chalk9.dim("  Run ") + chalk9.hex("#83D1EB")("caliber undo") + chalk9.dim(" to revert changes.\n"));
-}
-
-// src/commands/recommend.ts
-import chalk10 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 fs23 from "fs";
-import path17 from "path";
-import crypto2 from "crypto";
-function scanLocalState(dir) {
-  const items = [];
-  const claudeMdPath = path17.join(dir, "CLAUDE.md");
-  if (fs23.existsSync(claudeMdPath)) {
-    items.push({
-      type: "rule",
-      platform: "claude",
-      name: "CLAUDE.md",
-      contentHash: hashFile(claudeMdPath),
-      path: claudeMdPath
-    });
-  }
-  const skillsDir = path17.join(dir, ".claude", "skills");
-  if (fs23.existsSync(skillsDir)) {
-    for (const file of fs23.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
-      });
-    }
-  }
-  const mcpJsonPath = path17.join(dir, ".mcp.json");
-  if (fs23.existsSync(mcpJsonPath)) {
+  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 {
-      const mcpJson = JSON.parse(fs23.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
-          });
-        }
+      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 agentsMdPath = path17.join(dir, "AGENTS.md");
-  if (fs23.existsSync(agentsMdPath)) {
-    items.push({
-      type: "rule",
-      platform: "codex",
-      name: "AGENTS.md",
-      contentHash: hashFile(agentsMdPath),
-      path: agentsMdPath
-    });
-  }
-  const codexSkillsDir = path17.join(dir, ".agents", "skills");
-  if (fs23.existsSync(codexSkillsDir)) {
-    try {
-      for (const name of fs23.readdirSync(codexSkillsDir)) {
-        const skillFile = path17.join(codexSkillsDir, name, "SKILL.md");
-        if (fs23.existsSync(skillFile)) {
-          items.push({
-            type: "skill",
-            platform: "codex",
-            name: `${name}/SKILL.md`,
-            contentHash: hashFile(skillFile),
-            path: skillFile
-          });
-        }
-      }
-    } 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;
     }
-  }
-  const cursorrulesPath = path17.join(dir, ".cursorrules");
-  if (fs23.existsSync(cursorrulesPath)) {
-    items.push({
-      type: "rule",
-      platform: "cursor",
-      name: ".cursorrules",
-      contentHash: hashFile(cursorrulesPath),
-      path: cursorrulesPath
-    });
-  }
-  const cursorRulesDir = path17.join(dir, ".cursor", "rules");
-  if (fs23.existsSync(cursorRulesDir)) {
-    for (const file of fs23.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
-      });
+    if (message.toLowerCase() === "cancel") {
+      return null;
     }
-  }
-  const cursorSkillsDir = path17.join(dir, ".cursor", "skills");
-  if (fs23.existsSync(cursorSkillsDir)) {
-    try {
-      for (const name of fs23.readdirSync(cursorSkillsDir)) {
-        const skillFile = path17.join(cursorSkillsDir, name, "SKILL.md");
-        if (fs23.existsSync(skillFile)) {
-          items.push({
-            type: "skill",
-            platform: "cursor",
-            name: `${name}/SKILL.md`,
-            contentHash: hashFile(skillFile),
-            path: skillFile
-          });
-        }
-      }
-    } catch {
+    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 cursorMcpPath = path17.join(dir, ".cursor", "mcp.json");
-  if (fs23.existsSync(cursorMcpPath)) {
-    try {
-      const mcpJson = JSON.parse(fs23.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 {
+    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 = fs23.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");
 }
+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();
+  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");
+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" });
   }
-  if (platform === "codex") {
-    return join8(".agents", "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" });
   }
-  return join8(".claude", "skills", slug, "SKILL.md");
+  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;
-}
-var AWESOME_CLAUDE_CODE_URL = "https://raw.githubusercontent.com/hesreallyhim/awesome-claude-code/main/README.md";
-async function searchAwesomeClaudeCode(technologies) {
-  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 (!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("");
     }
-    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 [];
   }
+  console.log(`  ${chalk7.green("+")} ${chalk7.dim("new")}  ${chalk7.yellow("~")} ${chalk7.dim("modified")}  ${chalk7.red("-")} ${chalk7.dim("removed")}`);
+  console.log("");
 }
-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);
+function ensurePermissions() {
+  const settingsPath = ".claude/settings.json";
+  let settings = {};
+  try {
+    if (fs22.existsSync(settingsPath)) {
+      settings = JSON.parse(fs22.readFileSync(settingsPath, "utf-8"));
     }
+  } catch {
   }
-  return combined;
+  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 (!fs22.existsSync(".claude")) fs22.mkdirSync(".claude", { recursive: true });
+  fs22.writeFileSync(settingsPath, JSON.stringify(settings, null, 2) + "\n");
 }
-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
-  }));
+// 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__");
+  }
 }
-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 [];
+
+// 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__");
+  }
+  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());
+  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 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))
+    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}`);
+        }
+      }
     );
-  } catch {
-    return [];
-  }
-}
-async function recommendCommand(options) {
-  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(chalk10.yellow("Could not detect any languages or dependencies. Try running from a project root."));
+    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 ? chalk10.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 ? chalk10.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(chalk10.bold("  Recommendations"));
-    lines.push("");
-    if (hasScores) {
-      lines.push(`  ${chalk10.dim("Score".padEnd(7))} ${chalk10.dim("Name".padEnd(28))} ${chalk10.dim("Why")}`);
-    } else {
-      lines.push(`  ${chalk10.dim("Name".padEnd(30))} ${chalk10.dim("Technology".padEnd(18))} ${chalk10.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(chalk10.dim("  " + "\u2500".repeat(70)));
-    for (let i = 0; i < recs.length; i++) {
-      const rec = recs[i];
-      const check = selected.has(i) ? chalk10.green("[x]") : "[ ]";
-      const ptr = i === cursor ? chalk10.cyan(">") : " ";
-      if (hasScores) {
-        const scoreColor = rec.score >= 90 ? chalk10.green : rec.score >= 70 ? chalk10.yellow : chalk10.dim;
-        lines.push(`  ${ptr} ${check} ${scoreColor(String(rec.score).padStart(3))}   ${rec.name.padEnd(26)} ${chalk10.dim(rec.reason.slice(0, 40))}`);
-      } else {
-        lines.push(`  ${ptr} ${check} ${rec.name.padEnd(28)} ${rec.detected_technology.padEnd(16)} ${chalk10.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(chalk10.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(chalk10.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(chalk10.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(chalk10.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(chalk10.bold("\n  Recommendations\n"));
-  if (hasScores) {
-    console.log(`  ${chalk10.dim("Score".padEnd(7))} ${chalk10.dim("Name".padEnd(28))} ${chalk10.dim("Why")}`);
-  } else {
-    console.log(`  ${chalk10.dim("Name".padEnd(30))} ${chalk10.dim("Technology".padEnd(18))} ${chalk10.dim("Source")}`);
-  }
-  console.log(chalk10.dim("  " + "\u2500".repeat(70)));
-  for (const rec of recs) {
-    if (hasScores) {
-      console.log(`  ${String(rec.score).padStart(3)}   ${rec.name.padEnd(26)} ${chalk10.dim(rec.reason.slice(0, 50))}`);
-    } else {
-      console.log(`  ${rec.name.padEnd(28)} ${rec.detected_technology.padEnd(16)} ${chalk10.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
@@ -7033,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);