lynxprompt 0.3.0 → 0.3.1

package/dist/index.js

@@ -1370,7 +1370,7 @@ function formatDetectionResults(result) {
 }
 
 // src/utils/detect.ts
-import { readFile as readFile3, access as access3 } from "fs/promises";
+import { readFile as readFile3, access as access2 } from "fs/promises";
 import { join as join4 } from "path";
 var JS_FRAMEWORK_PATTERNS = {
   nextjs: ["next"],
@@ -1593,7 +1593,7 @@ async function detectProject(cwd) {
 }
 async function fileExists(path2) {
   try {
-    await access3(path2);
+    await access2(path2);
     return true;
   } catch {
     return false;
@@ -1964,7 +1964,7 @@ async function initCommand(options) {
 import chalk8 from "chalk";
 import prompts4 from "prompts";
 import ora7 from "ora";
-import { writeFile as writeFile4, mkdir as mkdir4, access as access5 } from "fs/promises";
+import { writeFile as writeFile4, mkdir as mkdir4, access as access3 } from "fs/promises";
 import { join as join6, dirname as dirname4 } from "path";
 
 // src/utils/generator.ts
@@ -2245,101 +2245,137 @@ function generateFileContent(options, platform) {
 // src/commands/wizard.ts
 var OUTPUT_FORMATS = [
   {
-    title: "AGENTS.md (Universal)",
+    title: "\u{1F310} AGENTS.md",
     value: "agents",
-    description: "Works with Claude Code, GitHub Copilot, Aider, and most AI editors",
+    description: "Universal format - Claude, Copilot, Aider, & more",
     recommended: true
   },
   {
-    title: "Cursor (.cursor/rules/)",
+    title: "\u{1F5B1}\uFE0F  Cursor",
     value: "cursor",
-    description: "Cursor IDE with MDC format"
+    description: ".cursor/rules/ with MDC format"
   },
   {
-    title: "Multiple formats",
+    title: "\u{1F30A} Windsurf",
+    value: "windsurf",
+    description: ".windsurfrules configuration"
+  },
+  {
+    title: "\u{1F916} Claude Code",
+    value: "claude",
+    description: "CLAUDE.md for Claude AI"
+  },
+  {
+    title: "\u{1F4E6} Multiple",
     value: "multiple",
-    description: "Select multiple AI editors to generate for"
+    description: "Generate for multiple AI editors"
   }
 ];
 var TECH_STACKS = [
-  { title: "TypeScript", value: "typescript" },
-  { title: "JavaScript", value: "javascript" },
-  { title: "Python", value: "python" },
-  { title: "Go", value: "go" },
-  { title: "Rust", value: "rust" },
-  { title: "Java", value: "java" },
-  { title: "C#/.NET", value: "csharp" },
-  { title: "Ruby", value: "ruby" },
-  { title: "PHP", value: "php" },
-  { title: "Swift", value: "swift" }
+  { title: "\u{1F537} TypeScript", value: "typescript" },
+  { title: "\u{1F7E1} JavaScript", value: "javascript" },
+  { title: "\u{1F40D} Python", value: "python" },
+  { title: "\u{1F535} Go", value: "go" },
+  { title: "\u{1F980} Rust", value: "rust" },
+  { title: "\u2615 Java", value: "java" },
+  { title: "\u{1F49C} C#/.NET", value: "csharp" },
+  { title: "\u{1F48E} Ruby", value: "ruby" },
+  { title: "\u{1F418} PHP", value: "php" },
+  { title: "\u{1F34E} Swift", value: "swift" }
 ];
 var FRAMEWORKS = [
-  { title: "React", value: "react" },
-  { title: "Next.js", value: "nextjs" },
-  { title: "Vue.js", value: "vue" },
-  { title: "Angular", value: "angular" },
-  { title: "Svelte", value: "svelte" },
-  { title: "Express", value: "express" },
-  { title: "FastAPI", value: "fastapi" },
-  { title: "Django", value: "django" },
-  { title: "Flask", value: "flask" },
-  { title: "Spring Boot", value: "spring" },
-  { title: "Rails", value: "rails" },
-  { title: "Laravel", value: "laravel" }
+  { title: "\u269B\uFE0F  React", value: "react" },
+  { title: "\u25B2  Next.js", value: "nextjs" },
+  { title: "\u{1F49A} Vue.js", value: "vue" },
+  { title: "\u{1F170}\uFE0F  Angular", value: "angular" },
+  { title: "\u{1F525} Svelte", value: "svelte" },
+  { title: "\u{1F682} Express", value: "express" },
+  { title: "\u26A1 FastAPI", value: "fastapi" },
+  { title: "\u{1F3B8} Django", value: "django" },
+  { title: "\u{1F9EA} Flask", value: "flask" },
+  { title: "\u{1F343} Spring", value: "spring" },
+  { title: "\u{1F48E} Rails", value: "rails" },
+  { title: "\u{1F534} Laravel", value: "laravel" },
+  { title: "\u{1F3D7}\uFE0F  NestJS", value: "nestjs" },
+  { title: "\u26A1 Vite", value: "vite" },
+  { title: "\u{1F4F1} React Native", value: "react-native" }
 ];
 var PLATFORMS = [
-  { title: "AGENTS.md (Universal)", value: "agents", filename: "AGENTS.md" },
-  { title: "Cursor (.cursor/rules/)", value: "cursor", filename: ".cursor/rules/project.mdc" },
-  { title: "Claude Code (CLAUDE.md)", value: "claude", filename: "CLAUDE.md" },
-  { title: "GitHub Copilot", value: "copilot", filename: ".github/copilot-instructions.md" },
-  { title: "Windsurf (.windsurfrules)", value: "windsurf", filename: ".windsurfrules" },
-  { title: "Zed", value: "zed", filename: ".zed/instructions.md" }
+  { title: "\u{1F310} AGENTS.md (Universal)", value: "agents", filename: "AGENTS.md" },
+  { title: "\u{1F5B1}\uFE0F  Cursor", value: "cursor", filename: ".cursor/rules/project.mdc" },
+  { title: "\u{1F916} Claude Code", value: "claude", filename: "CLAUDE.md" },
+  { title: "\u{1F419} GitHub Copilot", value: "copilot", filename: ".github/copilot-instructions.md" },
+  { title: "\u{1F30A} Windsurf", value: "windsurf", filename: ".windsurfrules" },
+  { title: "\u26A1 Zed", value: "zed", filename: ".zed/instructions.md" },
+  { title: "\u{1F916} Cline", value: "cline", filename: ".clinerules" }
 ];
 var PERSONAS = [
-  { title: "Full-Stack Developer - Complete application setups", value: "fullstack" },
-  { title: "Backend Developer - APIs, databases, microservices", value: "backend" },
-  { title: "Frontend Developer - UI, components, styling", value: "frontend" },
-  { title: "DevOps Engineer - Infrastructure, CI/CD, containers", value: "devops" },
-  { title: "Data Engineer - Pipelines, ETL, databases", value: "data" },
-  { title: "Security Engineer - Secure code, vulnerabilities", value: "security" },
-  { title: "Custom...", value: "custom" }
+  { title: "\u{1F9D1}\u200D\u{1F4BB} Full-Stack Developer", value: "fullstack", description: "Complete application development" },
+  { title: "\u2699\uFE0F  Backend Developer", value: "backend", description: "APIs, databases, services" },
+  { title: "\u{1F3A8} Frontend Developer", value: "frontend", description: "UI, components, styling" },
+  { title: "\u{1F680} DevOps Engineer", value: "devops", description: "Infrastructure, CI/CD" },
+  { title: "\u{1F4CA} Data Engineer", value: "data", description: "Pipelines, ETL, analytics" },
+  { title: "\u{1F512} Security Engineer", value: "security", description: "Secure code, auditing" },
+  { title: "\u270F\uFE0F  Custom...", value: "custom", description: "Define your own" }
 ];
 var BOUNDARY_PRESETS = [
   {
-    title: "Standard - Balance of freedom and safety (recommended)",
+    title: "\u{1F7E2} Standard",
     value: "standard",
+    description: "Balanced freedom & safety",
     always: ["Read any file", "Modify files in src/", "Run build/test/lint", "Create test files"],
     askFirst: ["Add new dependencies", "Modify config files", "Create new modules"],
     never: ["Delete production data", "Modify .env secrets", "Force push"]
   },
   {
-    title: "Conservative - Ask before most changes",
+    title: "\u{1F7E1} Conservative",
     value: "conservative",
+    description: "Ask before most changes",
     always: ["Read any file", "Run lint/format commands"],
     askFirst: ["Modify any file", "Add dependencies", "Create files", "Run tests"],
     never: ["Delete files", "Modify .env", "Push to git"]
   },
   {
-    title: "Permissive - AI can modify freely within src/",
+    title: "\u{1F7E0} Permissive",
     value: "permissive",
+    description: "AI can modify freely",
     always: ["Modify any file in src/", "Run any script", "Add dependencies", "Create files"],
     askFirst: ["Modify root configs", "Delete directories"],
     never: ["Modify .env", "Access external APIs without confirmation"]
   }
 ];
+function showStep(current, total, title) {
+  const progress = "\u25CF".repeat(current) + "\u25CB".repeat(total - current);
+  console.log();
+  console.log(chalk8.cyan(`  ${progress}  Step ${current}/${total}: ${title}`));
+  console.log();
+}
+function printBox(lines, color = chalk8.gray) {
+  const maxLen = Math.max(...lines.map((l) => l.replace(/\x1b\[[0-9;]*m/g, "").length));
+  const top = "\u250C" + "\u2500".repeat(maxLen + 2) + "\u2510";
+  const bottom = "\u2514" + "\u2500".repeat(maxLen + 2) + "\u2518";
+  console.log(color(top));
+  for (const line of lines) {
+    const stripped = line.replace(/\x1b\[[0-9;]*m/g, "");
+    const padding = " ".repeat(maxLen - stripped.length);
+    console.log(color("\u2502 ") + line + padding + color(" \u2502"));
+  }
+  console.log(color(bottom));
+}
 async function wizardCommand(options) {
   console.log();
-  console.log(chalk8.cyan("\u{1F431} LynxPrompt Wizard"));
-  console.log(chalk8.gray("Generate AI IDE configuration in seconds"));
+  console.log(chalk8.cyan.bold("  \u{1F431} LynxPrompt Wizard"));
+  console.log(chalk8.gray("     Generate AI IDE configuration in seconds"));
   console.log();
   const detected = await detectProject(process.cwd());
   if (detected) {
-    console.log(chalk8.green("\u2713 Detected project:"));
-    if (detected.name) console.log(chalk8.gray(`  Name: ${detected.name}`));
-    if (detected.stack.length > 0) console.log(chalk8.gray(`  Stack: ${detected.stack.join(", ")}`));
-    if (detected.packageManager) console.log(chalk8.gray(`  Package manager: ${detected.packageManager}`));
-    if (detected.commands.build) console.log(chalk8.gray(`  Build: ${detected.commands.build}`));
-    if (detected.commands.test) console.log(chalk8.gray(`  Test: ${detected.commands.test}`));
+    const detectedInfo = [
+      chalk8.green("\u2713 Project detected")
+    ];
+    if (detected.name) detectedInfo.push(chalk8.gray(`  Name: ${detected.name}`));
+    if (detected.stack.length > 0) detectedInfo.push(chalk8.gray(`  Stack: ${detected.stack.join(", ")}`));
+    if (detected.packageManager) detectedInfo.push(chalk8.gray(`  Package manager: ${detected.packageManager}`));
+    printBox(detectedInfo, chalk8.gray);
     console.log();
   }
   let config2;
@@ -2369,12 +2405,13 @@ async function wizardCommand(options) {
     const files = generateConfig(config2);
     spinner.stop();
     console.log();
-    console.log(chalk8.green("\u2705 Generated:"));
+    console.log(chalk8.green.bold("  \u2705 Generated:"));
+    console.log();
     for (const [filename, content] of Object.entries(files)) {
       const outputPath = join6(process.cwd(), filename);
       let exists = false;
       try {
-        await access5(outputPath);
+        await access3(outputPath);
         exists = true;
       } catch {
       }
@@ -2386,7 +2423,7 @@ async function wizardCommand(options) {
           initial: false
         });
         if (!response.overwrite) {
-          console.log(chalk8.yellow(`   Skipped: ${filename}`));
+          console.log(chalk8.yellow(`     \u23ED\uFE0F  Skipped: ${filename}`));
           continue;
         }
       }
@@ -2395,15 +2432,17 @@ async function wizardCommand(options) {
         await mkdir4(dir, { recursive: true });
       }
       await writeFile4(outputPath, content, "utf-8");
-      console.log(`   ${chalk8.cyan(filename)}`);
+      console.log(`     ${chalk8.cyan("\u2192")} ${chalk8.bold(filename)}`);
     }
     console.log();
-    console.log(chalk8.gray("Your AI assistant will now follow these instructions."));
-    console.log();
-    console.log(chalk8.gray("Tips:"));
-    console.log(chalk8.gray("  \u2022 Edit the generated file anytime to customize rules"));
-    console.log(chalk8.gray("  \u2022 Run 'lynxp wizard' again to regenerate"));
-    console.log(chalk8.gray("  \u2022 Run 'lynxp check' to validate your configuration"));
+    printBox([
+      chalk8.gray("Your AI assistant will now follow these instructions."),
+      "",
+      chalk8.gray("Next steps:"),
+      chalk8.cyan("  lynxp check    ") + chalk8.gray("Validate configuration"),
+      chalk8.cyan("  lynxp push     ") + chalk8.gray("Sync to cloud"),
+      chalk8.cyan("  lynxp status   ") + chalk8.gray("View current setup")
+    ], chalk8.gray);
     console.log();
   } catch (error) {
     spinner.fail("Failed to generate files");
@@ -2417,119 +2456,135 @@ async function wizardCommand(options) {
 }
 async function runInteractiveWizard(options, detected) {
   const answers = {};
+  const totalSteps = 5;
+  const promptConfig = {
+    onCancel: () => {
+      console.log(chalk8.yellow("\n  Cancelled. Run 'lynxp wizard' anytime to restart.\n"));
+      process.exit(0);
+    }
+  };
+  showStep(1, totalSteps, "Output Format");
   let platforms;
   if (options.format) {
     platforms = options.format.split(",").map((f) => f.trim());
+    console.log(chalk8.gray(`  Using format from flag: ${platforms.join(", ")}`));
   } else {
     const formatResponse = await prompts4({
       type: "select",
       name: "format",
-      message: "Select output format:",
+      message: chalk8.white("Where will you use this?"),
       choices: OUTPUT_FORMATS.map((f) => ({
-        title: f.recommended ? `${f.title} ${chalk8.green("(recommended)")}` : f.title,
+        title: f.recommended ? `${f.title} ${chalk8.green.bold("\u2605 recommended")}` : f.title,
         value: f.value,
-        description: f.description
+        description: chalk8.gray(f.description)
       })),
-      initial: 0
-      // AGENTS.md is default
-    });
+      initial: 0,
+      hint: chalk8.gray("\u2191\u2193 navigate \u2022 enter select")
+    }, promptConfig);
     if (formatResponse.format === "multiple") {
+      console.log();
       const platformResponse = await prompts4({
         type: "multiselect",
         name: "platforms",
-        message: "Select AI editors:",
-        choices: PLATFORMS.map((p) => ({ title: p.title, value: p.value })),
-        hint: "- Space to select, Enter to confirm",
-        min: 1
-      });
+        message: chalk8.white("Select AI editors:"),
+        choices: PLATFORMS.map((p) => ({
+          title: p.title,
+          value: p.value
+        })),
+        hint: chalk8.gray("space select \u2022 a toggle all \u2022 enter confirm"),
+        min: 1,
+        instructions: false
+      }, promptConfig);
       platforms = platformResponse.platforms || ["agents"];
     } else {
       platforms = [formatResponse.format || "agents"];
     }
   }
   answers.platforms = platforms;
+  showStep(2, totalSteps, "Project Info");
   const nameResponse = await prompts4({
     type: "text",
     name: "name",
-    message: "Project name:",
-    initial: options.name || detected?.name || "my-project"
-  });
+    message: chalk8.white("Project name:"),
+    initial: options.name || detected?.name || "my-project",
+    hint: chalk8.gray("Used in the generated config header")
+  }, promptConfig);
   answers.name = nameResponse.name || "my-project";
   const descResponse = await prompts4({
     type: "text",
     name: "description",
-    message: "Brief description (optional):",
-    initial: options.description || ""
-  });
+    message: chalk8.white("Brief description:"),
+    initial: options.description || "",
+    hint: chalk8.gray("optional - helps AI understand context")
+  }, promptConfig);
   answers.description = descResponse.description || "";
+  showStep(3, totalSteps, "Tech Stack");
   const allStackOptions = [...TECH_STACKS, ...FRAMEWORKS];
   const detectedStackSet = new Set(detected?.stack || []);
+  const preselected = allStackOptions.map((s, i) => detectedStackSet.has(s.value) ? i : -1).filter((i) => i !== -1);
+  if (preselected.length > 0) {
+    console.log(chalk8.gray(`  Auto-selected: ${detected?.stack?.join(", ")}`));
+    console.log();
+  }
   const stackResponse = await prompts4({
     type: "multiselect",
     name: "stack",
-    message: "Tech stack:",
+    message: chalk8.white("Tech stack:"),
     choices: allStackOptions.map((s) => ({
       title: s.title,
       value: s.value,
       selected: detectedStackSet.has(s.value)
     })),
-    hint: "- Space to select, Enter to confirm"
-  });
+    hint: chalk8.gray("space select \u2022 a toggle all \u2022 enter confirm"),
+    instructions: false
+  }, promptConfig);
   answers.stack = stackResponse.stack || [];
+  showStep(4, totalSteps, "AI Persona");
   const personaResponse = await prompts4({
     type: "select",
     name: "persona",
-    message: "AI persona:",
-    choices: PERSONAS,
-    initial: 0
-    // Full-stack by default
-  });
+    message: chalk8.white("What role should the AI take?"),
+    choices: PERSONAS.map((p) => ({
+      title: p.title,
+      value: p.value,
+      description: chalk8.gray(p.description)
+    })),
+    initial: 0,
+    hint: chalk8.gray("\u2191\u2193 navigate \u2022 enter select")
+  }, promptConfig);
   if (personaResponse.persona === "custom") {
     const customPersona = await prompts4({
       type: "text",
       name: "value",
-      message: "Describe the custom persona:"
-    });
+      message: chalk8.white("Describe the custom persona:"),
+      hint: chalk8.gray("e.g., 'ML engineer focused on PyTorch and data pipelines'")
+    }, promptConfig);
     answers.persona = customPersona.value || "fullstack";
   } else {
     answers.persona = personaResponse.persona || "fullstack";
   }
+  showStep(5, totalSteps, "AI Boundaries");
   const boundaryResponse = await prompts4({
     type: "select",
     name: "boundaries",
-    message: "AI boundaries:",
-    choices: BOUNDARY_PRESETS.map((b) => ({ title: b.title, value: b.value })),
-    initial: 0
-    // Standard by default
-  });
+    message: chalk8.white("How much freedom should the AI have?"),
+    choices: BOUNDARY_PRESETS.map((b) => ({
+      title: b.title,
+      value: b.value,
+      description: chalk8.gray(b.description)
+    })),
+    initial: 0,
+    hint: chalk8.gray("\u2191\u2193 navigate \u2022 enter select")
+  }, promptConfig);
   answers.boundaries = boundaryResponse.boundaries || "standard";
-  if (detected?.commands && Object.keys(detected.commands).length > 0) {
-    console.log();
-    console.log(chalk8.gray("Auto-detected commands:"));
-    if (detected.commands.build) console.log(chalk8.gray(`  Build: ${detected.commands.build}`));
-    if (detected.commands.test) console.log(chalk8.gray(`  Test: ${detected.commands.test}`));
-    if (detected.commands.lint) console.log(chalk8.gray(`  Lint: ${detected.commands.lint}`));
-    if (detected.commands.dev) console.log(chalk8.gray(`  Dev: ${detected.commands.dev}`));
-    const editCommands = await prompts4({
-      type: "confirm",
-      name: "edit",
-      message: "Edit commands?",
-      initial: false
-    });
-    if (editCommands.edit) {
-      const commandsResponse = await prompts4([
-        { type: "text", name: "build", message: "Build:", initial: detected.commands.build },
-        { type: "text", name: "test", message: "Test:", initial: detected.commands.test },
-        { type: "text", name: "lint", message: "Lint:", initial: detected.commands.lint },
-        { type: "text", name: "dev", message: "Dev:", initial: detected.commands.dev }
-      ]);
-      answers.commands = commandsResponse;
-    } else {
-      answers.commands = detected.commands;
-    }
-  } else {
-    answers.commands = {};
+  const selectedBoundary = BOUNDARY_PRESETS.find((b) => b.value === answers.boundaries);
+  if (selectedBoundary) {
+    console.log();
+    console.log(chalk8.gray("  Always allowed: ") + chalk8.green(selectedBoundary.always.slice(0, 2).join(", ")));
+    console.log(chalk8.gray("  Ask first:      ") + chalk8.yellow(selectedBoundary.askFirst.slice(0, 2).join(", ")));
+    console.log(chalk8.gray("  Never:          ") + chalk8.red(selectedBoundary.never.slice(0, 2).join(", ")));
   }
+  answers.commands = detected?.commands || {};
   return {
     name: answers.name,
     description: answers.description,
@@ -2604,7 +2659,7 @@ function handleApiError3(error) {
 
 // src/commands/status.ts
 import chalk10 from "chalk";
-import { access as access6, readFile as readFile6, readdir as readdir3 } from "fs/promises";
+import { readFile as readFile5, readdir, access as access4 } from "fs/promises";
 import { join as join7 } from "path";
 import { existsSync as existsSync4 } from "fs";
 var CONFIG_FILES = [
@@ -2634,7 +2689,7 @@ async function statusCommand() {
     const configPath = join7(cwd, ".lynxprompt/conf.yml");
     if (existsSync4(configPath)) {
       try {
-        const content = await readFile6(configPath, "utf-8");
+        const content = await readFile5(configPath, "utf-8");
         const { parse: parse5 } = await import("yaml");
         const config2 = parse5(content);
         if (config2?.exporters?.length > 0) {
@@ -2677,8 +2732,8 @@ async function statusCommand() {
   for (const config2 of CONFIG_FILES) {
     const filePath = join7(cwd, config2.path);
     try {
-      await access6(filePath);
-      const content = await readFile6(filePath, "utf-8");
+      await access4(filePath);
+      const content = await readFile5(filePath, "utf-8");
       const lines = content.split("\n").length;
       const size = formatBytes(content.length);
       foundAny = true;
@@ -2699,7 +2754,7 @@ async function statusCommand() {
     const dirPath = join7(cwd, config2.path);
     if (existsSync4(dirPath)) {
       try {
-        const files = await readdir3(dirPath);
+        const files = await readdir(dirPath);
         const ruleFiles = files.filter((f) => f.endsWith(".md") || f.endsWith(".mdc"));
         if (ruleFiles.length > 0) {
           foundAny = true;
@@ -2757,7 +2812,7 @@ function formatBytes(bytes) {
 import chalk11 from "chalk";
 import ora9 from "ora";
 import prompts5 from "prompts";
-import { readFile as readFile7, writeFile as writeFile5, mkdir as mkdir5, readdir as readdir4 } from "fs/promises";
+import { readFile as readFile6, writeFile as writeFile5, mkdir as mkdir5, readdir as readdir2 } from "fs/promises";
 import { join as join8, dirname as dirname5 } from "path";
 import { existsSync as existsSync5 } from "fs";
 import * as yaml3 from "yaml";
@@ -2778,7 +2833,7 @@ async function syncCommand(options = {}) {
   const spinner = ora9("Loading configuration...").start();
   let config2;
   try {
-    const configContent = await readFile7(configPath, "utf-8");
+    const configContent = await readFile6(configPath, "utf-8");
     config2 = yaml3.parse(configContent);
     spinner.succeed("Configuration loaded");
   } catch (error) {
@@ -2875,12 +2930,12 @@ async function syncCommand(options = {}) {
 async function loadRules(rulesPath) {
   const files = [];
   try {
-    const entries = await readdir4(rulesPath, { withFileTypes: true });
+    const entries = await readdir2(rulesPath, { withFileTypes: true });
     for (const entry of entries) {
       if (!entry.isFile()) continue;
       if (!entry.name.endsWith(".md")) continue;
       const filePath = join8(rulesPath, entry.name);
-      const content = await readFile7(filePath, "utf-8");
+      const content = await readFile6(filePath, "utf-8");
       if (content.trim()) {
         files.push({ name: entry.name, content: content.trim() });
       }
@@ -2930,7 +2985,7 @@ function formatForAgent(agent, content) {
       return content;
   }
 }
-function formatAsMdc(content, agent) {
+function formatAsMdc(content, _agent) {
   const frontmatter = yaml3.stringify({
     description: "LynxPrompt rules - AI coding guidelines",
     globs: ["**/*"],
@@ -2941,7 +2996,7 @@ ${frontmatter}---
 
 ${content}`;
 }
-function formatAsMarkdown(content, agent) {
+function formatAsMarkdown(content, _agent) {
   const header = `# AI Coding Rules
 
 > Generated by [LynxPrompt](https://lynxprompt.com)
@@ -2949,7 +3004,7 @@ function formatAsMarkdown(content, agent) {
 `;
   return header + content;
 }
-function formatAsJson(content, agent) {
+function formatAsJson(content, _agent) {
   return JSON.stringify(
     {
       $schema: "https://lynxprompt.com/schemas/rules.json",
@@ -2968,7 +3023,7 @@ function formatAsJson(content, agent) {
 // src/commands/agents.ts
 import chalk12 from "chalk";
 import prompts6 from "prompts";
-import { readFile as readFile8, writeFile as writeFile6 } from "fs/promises";
+import { readFile as readFile7, writeFile as writeFile6 } from "fs/promises";
 import { join as join9 } from "path";
 import { existsSync as existsSync6 } from "fs";
 import * as yaml4 from "yaml";
@@ -3170,7 +3225,7 @@ async function loadConfig() {
     return null;
   }
   try {
-    const content = await readFile8(configPath, "utf-8");
+    const content = await readFile7(configPath, "utf-8");
     return yaml4.parse(content);
   } catch {
     return null;
@@ -3186,7 +3241,7 @@ async function saveConfig(config2) {
 // src/commands/check.ts
 import chalk13 from "chalk";
 import ora10 from "ora";
-import { readFile as readFile9, readdir as readdir5, stat as stat2 } from "fs/promises";
+import { readFile as readFile8, readdir as readdir3, stat } from "fs/promises";
 import { join as join10 } from "path";
 import { existsSync as existsSync7 } from "fs";
 import * as yaml5 from "yaml";
@@ -3252,7 +3307,7 @@ async function validateLynxPromptConfig(cwd) {
     return { errors, warnings };
   }
   try {
-    const content = await readFile9(configPath, "utf-8");
+    const content = await readFile8(configPath, "utf-8");
     const config2 = yaml5.parse(content);
     if (!config2.version) {
       warnings.push(".lynxprompt/conf.yml: Missing 'version' field");
@@ -3325,7 +3380,7 @@ async function checkCommand(options = {}) {
     if (existsSync7(filePath)) {
       result.files.push(file.path);
       try {
-        const content = await readFile9(filePath, "utf-8");
+        const content = await readFile8(filePath, "utf-8");
         const validation = validateMarkdown(content, file.path);
         result.errors.push(...validation.errors);
         result.warnings.push(...validation.warnings);
@@ -3338,13 +3393,13 @@ async function checkCommand(options = {}) {
     const dirPath = join10(cwd, dir.path);
     if (existsSync7(dirPath)) {
       try {
-        const files = await readdir5(dirPath);
+        const files = await readdir3(dirPath);
         for (const file of files) {
           const filePath = join10(dirPath, file);
-          const fileStat = await stat2(filePath);
+          const fileStat = await stat(filePath);
           if (fileStat.isFile()) {
             result.files.push(`${dir.path}/${file}`);
-            const content = await readFile9(filePath, "utf-8");
+            const content = await readFile8(filePath, "utf-8");
             if (file.endsWith(".mdc")) {
               const validation = validateMdc(content, `${dir.path}/${file}`);
               result.errors.push(...validation.errors);
@@ -3420,7 +3475,7 @@ async function checkCommand(options = {}) {
 // src/commands/diff.ts
 import chalk14 from "chalk";
 import ora11 from "ora";
-import { readFile as readFile10 } from "fs/promises";
+import { readFile as readFile9 } from "fs/promises";
 import { join as join11 } from "path";
 import { existsSync as existsSync8 } from "fs";
 function computeDiff(oldText, newText) {
@@ -3484,7 +3539,6 @@ function longestCommonSubsequence(a, b) {
 function formatDiff(diff, contextLines = 3) {
   const output = [];
   let lastPrintedIndex = -1;
-  let inHunk = false;
   const changeIndices = diff.map((d, i) => d.type !== "same" ? i : -1).filter((i) => i !== -1);
   if (changeIndices.length === 0) {
     return chalk14.gray("  (no changes)");
@@ -3515,7 +3569,7 @@ function getDiffStats(diff) {
     unchanged: diff.filter((d) => d.type === "same").length
   };
 }
-async function diffCommand(blueprintId, options = {}) {
+async function diffCommand(fileOrId, options = {}) {
   console.log();
   console.log(chalk14.cyan("\u{1F431} LynxPrompt Diff"));
   console.log();
@@ -3524,14 +3578,90 @@ async function diffCommand(blueprintId, options = {}) {
     await diffLocal(cwd);
     return;
   }
-  if (!blueprintId) {
-    console.log(chalk14.red("\u2717 Please provide a blueprint ID to compare with."));
+  const trackedFiles = await checkSyncStatus(cwd);
+  if (fileOrId) {
+    const tracked = await findBlueprintByFile(cwd, fileOrId);
+    if (tracked) {
+      await diffFileWithBlueprint(cwd, fileOrId, tracked.id);
+      return;
+    }
+    await diffWithBlueprintId(cwd, fileOrId);
+    return;
+  }
+  if (trackedFiles.length === 0) {
+    console.log(chalk14.yellow("No tracked blueprints found."));
+    console.log();
+    console.log(chalk14.gray("To track a blueprint and compare changes:"));
+    console.log(chalk14.gray("  1. Pull a blueprint: lynxp pull <blueprint-id>"));
+    console.log(chalk14.gray("  2. Or link an existing file: lynxp link"));
+    console.log();
+    console.log(chalk14.gray("Other options:"));
+    console.log(chalk14.gray("  lynxp diff --local    Compare .lynxprompt/rules/ with exported files"));
+    return;
+  }
+  let hasChanges = false;
+  for (const { blueprint, localModified, fileExists: fileExists2 } of trackedFiles) {
+    if (!fileExists2) {
+      console.log(chalk14.red(`\u2717 ${blueprint.file} - file not found`));
+      continue;
+    }
+    console.log(chalk14.cyan(`\u{1F4C4} ${blueprint.file}`));
+    console.log(chalk14.gray(`   Linked to: ${blueprint.name} (${blueprint.id})`));
+    if (localModified) {
+      hasChanges = true;
+      await diffFileWithBlueprint(cwd, blueprint.file, blueprint.id, true);
+    } else {
+      console.log(chalk14.green("   \u2713 In sync with cloud"));
+    }
     console.log();
-    console.log(chalk14.gray("Usage:"));
-    console.log(chalk14.gray("  lynxp diff <blueprint-id>    Compare local with remote blueprint"));
-    console.log(chalk14.gray("  lynxp diff --local           Compare .lynxprompt/rules/ with exports"));
+  }
+  if (!hasChanges) {
+    console.log(chalk14.green("\u2713 All tracked files are in sync with their cloud blueprints!"));
+  } else {
+    console.log(chalk14.gray("To push local changes: lynxp push"));
+    console.log(chalk14.gray("To pull cloud changes: lynxp pull <id>"));
+  }
+  console.log();
+}
+async function diffFileWithBlueprint(cwd, file, blueprintId, compact = false) {
+  const filePath = join11(cwd, file);
+  if (!existsSync8(filePath)) {
+    console.log(chalk14.red(`\u2717 File not found: ${file}`));
     return;
   }
+  const spinner = compact ? null : ora11("Fetching blueprint...").start();
+  try {
+    const { blueprint } = await api.getBlueprint(blueprintId);
+    spinner?.stop();
+    if (!blueprint || !blueprint.content) {
+      console.log(chalk14.red(`\u2717 Blueprint has no content`));
+      return;
+    }
+    const localContent = await readFile9(filePath, "utf-8");
+    const diff = computeDiff(blueprint.content, localContent);
+    const stats = getDiffStats(diff);
+    if (stats.added === 0 && stats.removed === 0) {
+      if (!compact) {
+        console.log(chalk14.green("\u2713 Files are identical!"));
+      }
+    } else {
+      if (!compact) {
+        console.log(chalk14.gray("Changes (cloud \u2192 local):"));
+        console.log();
+      }
+      console.log(formatDiff(diff));
+      console.log(chalk14.gray(`   ${chalk14.green(`+${stats.added}`)} ${chalk14.red(`-${stats.removed}`)} lines`));
+    }
+  } catch (error) {
+    spinner?.stop();
+    if (error instanceof ApiRequestError) {
+      console.log(chalk14.red(`\u2717 Could not fetch blueprint: ${error.message}`));
+    } else {
+      console.log(chalk14.red("\u2717 Failed to compare"));
+    }
+  }
+}
+async function diffWithBlueprintId(cwd, blueprintId) {
   if (!isAuthenticated()) {
     console.log(chalk14.yellow("\u26A0 Not logged in. Some blueprints may not be accessible."));
     console.log(chalk14.gray("Run 'lynxp login' to authenticate."));
@@ -3563,7 +3693,7 @@ async function diffCommand(blueprintId, options = {}) {
       const fullPath = join11(cwd, path2);
       if (existsSync8(fullPath)) {
         try {
-          localContent = await readFile10(fullPath, "utf-8");
+          localContent = await readFile9(fullPath, "utf-8");
           localPath = path2;
           break;
         } catch {
@@ -3625,7 +3755,7 @@ async function diffLocal(cwd) {
   }
   let rulesContent;
   try {
-    rulesContent = await readFile10(rulesPath, "utf-8");
+    rulesContent = await readFile9(rulesPath, "utf-8");
   } catch {
     console.log(chalk14.red("\u2717 Could not read .lynxprompt/rules/agents.md"));
     return;
@@ -3639,7 +3769,7 @@ async function diffLocal(cwd) {
     const filePath = join11(cwd, file.path);
     if (existsSync8(filePath)) {
       try {
-        const exportedContent = await readFile10(filePath, "utf-8");
+        const exportedContent = await readFile9(filePath, "utf-8");
         let compareContent = exportedContent;
         if (file.path.endsWith(".mdc")) {
           const frontmatterEnd = exportedContent.indexOf("---", 3);
@@ -3691,33 +3821,53 @@ function getSourceFromVisibility2(visibility) {
       return "marketplace";
   }
 }
-async function linkCommand(file, blueprintId, options = {}) {
+async function linkCommand(fileArg, blueprintIdArg, options = {}) {
   const cwd = process.cwd();
   if (options.list) {
     await listTrackedBlueprints(cwd);
     return;
   }
-  if (!file) {
-    console.log(chalk15.red("\u2717 Please provide a file path to link."));
-    console.log();
-    console.log(chalk15.gray("Usage:"));
-    console.log(chalk15.gray("  lynxp link <file> <blueprint-id>   Link a local file to a cloud blueprint"));
-    console.log(chalk15.gray("  lynxp link --list                  List all tracked blueprints"));
-    console.log();
-    console.log(chalk15.gray("Example:"));
-    console.log(chalk15.gray("  lynxp link AGENTS.md bp_abc123"));
-    return;
-  }
-  if (!blueprintId) {
-    console.log(chalk15.red("\u2717 Please provide a blueprint ID to link to."));
-    console.log();
-    console.log(chalk15.gray("Usage: lynxp link <file> <blueprint-id>"));
-    console.log(chalk15.gray("Example: lynxp link AGENTS.md bp_abc123"));
-    console.log();
-    console.log(chalk15.gray("To find blueprint IDs:"));
-    console.log(chalk15.gray("  lynxp list      - Show your blueprints"));
-    console.log(chalk15.gray("  lynxp search <query>  - Search marketplace"));
-    return;
+  console.log();
+  console.log(chalk15.cyan("\u{1F431} Link File to Blueprint"));
+  console.log();
+  let file;
+  let blueprintId = blueprintIdArg;
+  if (!fileArg) {
+    const configFiles = [
+      "AGENTS.md",
+      "CLAUDE.md",
+      ".cursor/rules/project.mdc",
+      ".github/copilot-instructions.md",
+      ".windsurfrules",
+      ".zed/instructions.md",
+      ".clinerules"
+    ];
+    const foundFiles = configFiles.filter((f) => existsSync9(join12(cwd, f)));
+    if (foundFiles.length === 0) {
+      console.log(chalk15.yellow("No AI configuration files found in this directory."));
+      console.log();
+      console.log(chalk15.gray("Create one first:"));
+      console.log(chalk15.gray("  lynxp wizard    Generate a new config file"));
+      console.log(chalk15.gray("  lynxp pull <id> Download from marketplace"));
+      return;
+    }
+    const { selectedFile } = await prompts7({
+      type: "select",
+      name: "selectedFile",
+      message: "Which file do you want to link to a cloud blueprint?",
+      choices: foundFiles.map((f) => ({
+        title: f,
+        value: f,
+        description: "Local file exists"
+      }))
+    });
+    if (!selectedFile) {
+      console.log(chalk15.gray("Cancelled."));
+      return;
+    }
+    file = selectedFile;
+  } else {
+    file = fileArg;
   }
   const filePath = join12(cwd, file);
   if (!existsSync9(filePath)) {
@@ -3726,7 +3876,9 @@ async function linkCommand(file, blueprintId, options = {}) {
   }
   const existing = await findBlueprintByFile(cwd, file);
   if (existing) {
-    console.log(chalk15.yellow(`\u26A0 This file is already linked to: ${existing.id}`));
+    console.log(chalk15.yellow(`This file is already linked to: ${existing.name}`));
+    console.log(chalk15.gray(`   ID: ${existing.id}`));
+    console.log();
     const { proceed } = await prompts7({
       type: "confirm",
       name: "proceed",
@@ -3738,11 +3890,120 @@ async function linkCommand(file, blueprintId, options = {}) {
       return;
     }
   }
-  if (!isAuthenticated()) {
-    console.log(
-      chalk15.yellow("Not logged in. Run 'lynxp login' to authenticate.")
-    );
-    process.exit(1);
+  if (!blueprintId) {
+    if (!isAuthenticated()) {
+      console.log(chalk15.yellow("You need to login to access your blueprints."));
+      const { doLogin } = await prompts7({
+        type: "confirm",
+        name: "doLogin",
+        message: "Login now?",
+        initial: true
+      });
+      if (doLogin) {
+        console.log(chalk15.gray("Run 'lynxp login' in another terminal, then come back here."));
+        return;
+      }
+      console.log(chalk15.gray("Cancelled."));
+      return;
+    }
+    const { searchMethod } = await prompts7({
+      type: "select",
+      name: "searchMethod",
+      message: "How do you want to find the blueprint?",
+      choices: [
+        { title: "\u{1F4CB} From my blueprints", value: "list" },
+        { title: "\u{1F50D} Search marketplace", value: "search" },
+        { title: "\u{1F522} Enter ID directly", value: "manual" }
+      ]
+    });
+    if (!searchMethod) {
+      console.log(chalk15.gray("Cancelled."));
+      return;
+    }
+    if (searchMethod === "list") {
+      const spinner2 = ora12("Fetching your blueprints...").start();
+      try {
+        const { blueprints } = await api.listBlueprints();
+        spinner2.stop();
+        if (!blueprints || blueprints.length === 0) {
+          console.log(chalk15.yellow("You don't have any blueprints yet."));
+          console.log(chalk15.gray("Create one with 'lynxp push' or search the marketplace."));
+          return;
+        }
+        const { selected } = await prompts7({
+          type: "select",
+          name: "selected",
+          message: "Select a blueprint:",
+          choices: blueprints.map((b) => ({
+            title: b.name,
+            value: b.id,
+            description: b.description?.substring(0, 50) || ""
+          }))
+        });
+        if (!selected) {
+          console.log(chalk15.gray("Cancelled."));
+          return;
+        }
+        blueprintId = selected;
+      } catch {
+        spinner2.stop();
+        console.log(chalk15.red("\u2717 Could not fetch blueprints"));
+        return;
+      }
+    } else if (searchMethod === "search") {
+      const { query } = await prompts7({
+        type: "text",
+        name: "query",
+        message: "Search for:"
+      });
+      if (!query) {
+        console.log(chalk15.gray("Cancelled."));
+        return;
+      }
+      const spinner2 = ora12(`Searching for "${query}"...`).start();
+      try {
+        const results = await api.searchBlueprints(query, 10);
+        spinner2.stop();
+        if (!results.templates || results.templates.length === 0) {
+          console.log(chalk15.yellow(`No blueprints found for "${query}"`));
+          return;
+        }
+        const { selected } = await prompts7({
+          type: "select",
+          name: "selected",
+          message: "Select a blueprint:",
+          choices: results.templates.map((b) => ({
+            title: `${b.name} (\u2605 ${b.likes})`,
+            value: b.id,
+            description: b.author ? `by ${b.author}` : ""
+          }))
+        });
+        if (!selected) {
+          console.log(chalk15.gray("Cancelled."));
+          return;
+        }
+        blueprintId = selected;
+      } catch {
+        spinner2.stop();
+        console.log(chalk15.red("\u2717 Search failed"));
+        return;
+      }
+    } else {
+      const { manualId } = await prompts7({
+        type: "text",
+        name: "manualId",
+        message: "Enter blueprint ID:"
+      });
+      if (!manualId) {
+        console.log(chalk15.gray("Cancelled."));
+        return;
+      }
+      blueprintId = manualId;
+    }
+  }
+  if (!blueprintId) {
+    console.log(chalk15.red("\u2717 No blueprint ID provided."));
+    return;
   }
   const spinner = ora12(`Fetching blueprint ${chalk15.cyan(blueprintId)}...`).start();
   try {
@@ -3778,11 +4039,10 @@ async function linkCommand(file, blueprintId, options = {}) {
     console.log(chalk15.green(`\u2705 Linked: ${file} \u2192 ${blueprint.id}`));
     console.log();
     console.log(chalk15.gray("Next steps:"));
-    console.log(chalk15.gray(`  \u2022 Run 'lynxp pull ${blueprintId}' to update local file from cloud`));
-    console.log(chalk15.gray(`  \u2022 Run 'lynxp diff ${blueprintId}' to see differences`));
+    console.log(chalk15.gray(`  \u2022 Run 'lynxp diff' to see differences`));
     console.log(chalk15.gray(`  \u2022 Run 'lynxp status' to see all tracked blueprints`));
     if (!isMarketplace) {
-      console.log(chalk15.gray(`  \u2022 Run 'lynxp push ${file}' to push local changes to cloud`));
+      console.log(chalk15.gray(`  \u2022 Run 'lynxp push' to push local changes to cloud`));
     }
     console.log();
   } catch (error) {
@@ -3801,23 +4061,43 @@ async function linkCommand(file, blueprintId, options = {}) {
     }
   }
 }
-async function unlinkCommand(file) {
+async function unlinkCommand(fileArg) {
   const cwd = process.cwd();
-  if (!file) {
-    console.log(chalk15.red("\u2717 Please provide a file path to unlink."));
-    console.log();
-    console.log(chalk15.gray("Usage: lynxp unlink <file>"));
-    console.log(chalk15.gray("Example: lynxp unlink AGENTS.md"));
-    return;
+  console.log();
+  console.log(chalk15.cyan("\u{1F431} Unlink File from Blueprint"));
+  console.log();
+  let file;
+  if (!fileArg) {
+    const status = await checkSyncStatus(cwd);
+    if (status.length === 0) {
+      console.log(chalk15.yellow("No files are currently linked to blueprints."));
+      return;
+    }
+    const { selectedFile } = await prompts7({
+      type: "select",
+      name: "selectedFile",
+      message: "Which file do you want to unlink?",
+      choices: status.map(({ blueprint }) => ({
+        title: blueprint.file,
+        value: blueprint.file,
+        description: `${blueprint.name} (${blueprint.source})`
+      }))
+    });
+    if (!selectedFile) {
+      console.log(chalk15.gray("Cancelled."));
+      return;
+    }
+    file = selectedFile;
+  } else {
+    file = fileArg;
   }
   const tracked = await findBlueprintByFile(cwd, file);
   if (!tracked) {
-    console.log(chalk15.yellow(`\u26A0 File is not linked to any blueprint: ${file}`));
+    console.log(chalk15.yellow(`File is not linked to any blueprint: ${file}`));
     return;
   }
-  console.log();
-  console.log(chalk15.cyan(`Currently linked to: ${tracked.id}`));
-  console.log(chalk15.gray(`   Name: ${tracked.name}`));
+  console.log(chalk15.gray(`Currently linked to: ${tracked.name}`));
+  console.log(chalk15.gray(`   ID: ${tracked.id}`));
   console.log(chalk15.gray(`   Source: ${tracked.source}`));
   console.log();
   const { confirm } = await prompts7({
@@ -3834,8 +4114,7 @@ async function unlinkCommand(file) {
   if (success) {
     console.log();
     console.log(chalk15.green(`\u2705 Unlinked: ${file}`));
-    console.log(chalk15.gray("  The file is now a standalone local file."));
-    console.log(chalk15.gray("  It will no longer receive updates from the cloud blueprint."));
+    console.log(chalk15.gray("  The file is now standalone. Changes won't sync with the cloud."));
     console.log();
   } else {
     console.log(chalk15.red("\u2717 Failed to unlink file."));
@@ -3851,7 +4130,7 @@ async function listTrackedBlueprints(cwd) {
     console.log();
     console.log(chalk15.gray("To track a blueprint:"));
     console.log(chalk15.gray("  lynxp pull <blueprint-id>     Download and track a blueprint"));
-    console.log(chalk15.gray("  lynxp link <file> <id>        Link an existing file to a blueprint"));
+    console.log(chalk15.gray("  lynxp link                    Link an existing file to a blueprint"));
     return;
   }
   for (const { blueprint, localModified, fileExists: fileExists2 } of status) {
@@ -3888,8 +4167,8 @@ program.command("search <query>").description("Search public blueprints in the m
 program.command("list").description("List your blueprints").option("-l, --limit <number>", "Number of results", "20").option("-v, --visibility <visibility>", "Filter: PRIVATE, TEAM, PUBLIC, or all").action(listCommand);
 program.command("push [file]").description("Push local file to LynxPrompt cloud as a blueprint").option("-n, --name <name>", "Blueprint name").option("-d, --description <desc>", "Blueprint description").option("-v, --visibility <vis>", "Visibility: PRIVATE, TEAM, or PUBLIC", "PRIVATE").option("-t, --tags <tags>", "Tags (comma-separated)").option("-y, --yes", "Skip prompts").action(pushCommand);
 program.command("link [file] [blueprint-id]").description("Link a local file to a cloud blueprint for tracking").option("--list", "List all tracked blueprints").action(linkCommand);
-program.command("unlink <file>").description("Disconnect a local file from its cloud blueprint").action(unlinkCommand);
-program.command("diff [blueprint-id]").description("Show changes between local and remote blueprint").option("--local", "Compare .lynxprompt/rules/ with exported files").action(diffCommand);
+program.command("unlink [file]").description("Disconnect a local file from its cloud blueprint").action(unlinkCommand);
+program.command("diff [file-or-id]").description("Compare tracked files with their cloud blueprints").option("--local", "Compare .lynxprompt/rules/ with exported files").action(diffCommand);
 program.command("init").description("Initialize .lynxprompt/ for multi-editor sync (advanced)").option("-y, --yes", "Skip prompts and use defaults").option("-f, --force", "Re-initialize even if already initialized").action(initCommand);
 program.command("sync").description("Sync .lynxprompt/rules/ to all configured agents").option("--dry-run", "Preview changes without writing files").option("-f, --force", "Skip prompts (for CI/automation)").action(syncCommand);
 program.command("agents [action] [agent]").description("Manage AI agents (list, enable, disable, detect)").option("-i, --interactive", "Interactive agent selection").action(agentsCommand);