ctx7 0.2.0 → 0.2.2

package/dist/index.js

@@ -6,8 +6,8 @@ import pc8 from "picocolors";
 import figlet from "figlet";
 
 // src/commands/skill.ts
-import pc6 from "picocolors";
-import ora2 from "ora";
+import pc7 from "picocolors";
+import ora3 from "ora";
 import { readdir, rm as rm2 } from "fs/promises";
 import { join as join5 } from "path";
 
@@ -117,6 +117,9 @@ async function downloadSkillFromGitHub(skill) {
 
 // src/utils/api.ts
 var baseUrl = "https://context7.com";
+function getBaseUrl() {
+  return baseUrl;
+}
 function setBaseUrl(url) {
   baseUrl = url;
 }
@@ -135,15 +138,6 @@ async function searchSkills(query) {
   const response = await fetch(`${baseUrl}/api/v2/skills?${params}`);
   return await response.json();
 }
-function trackInstalls(skills, ides) {
-  if (process.env.CTX7_TELEMETRY_DISABLED || !skills.length) return;
-  fetch(`${baseUrl}/api/v2/skills/track`, {
-    method: "POST",
-    headers: { "Content-Type": "application/json" },
-    body: JSON.stringify({ skills, ides })
-  }).catch(() => {
-  });
-}
 async function downloadSkill(project, skillName) {
   const skillData = await getSkill(project, skillName);
   if (skillData.error) {
@@ -527,23 +521,16 @@ import { checkbox as checkbox2 } from "@inquirer/prompts";
 import readline from "readline";
 function terminalLink(text, url, color) {
   const colorFn = color ?? ((s) => s);
-  return `\x1B]8;;${url}\x07${colorFn(text)}\x1B]8;;\x07`;
+  return `\x1B]8;;${url}\x07${colorFn(text)}\x1B]8;;\x07 ${pc3.white("\u2197")}`;
 }
-function formatInstallCount(count) {
-  if (count === void 0 || count === 0) return "";
-  let display;
-  if (count >= 1e3) {
-    display = `${Math.floor(count / 1e3)}k+`;
-  } else if (count >= 100) {
-    const hundreds = Math.floor(count / 100) * 100;
-    display = `${hundreds}+`;
-  } else if (count >= 10) {
-    const tens = Math.floor(count / 10) * 10;
-    display = `${tens}+`;
-  } else {
-    display = String(count);
-  }
-  return `\x1B[38;5;214m\u2193${display}\x1B[0m`;
+function formatInstallCount(count, placeholder = "") {
+  if (count === void 0 || count === 0) return placeholder;
+  return pc3.yellow(String(count));
+}
+function formatTrustScore(score) {
+  if (score === void 0 || score < 0) return pc3.dim("-");
+  if (score < 3) return pc3.red(score.toFixed(1));
+  return pc3.yellow(score.toFixed(1));
 }
 async function checkboxWithHover(config, options) {
   const choices = config.choices.filter(
@@ -614,12 +601,24 @@ async function symlinkSkill(skillName, sourcePath, targetDir) {
   await symlink(sourcePath, targetPath);
 }
 
+// src/utils/tracking.ts
+function trackEvent(event, data) {
+  if (process.env.CTX7_TELEMETRY_DISABLED) return;
+  fetch(`${getBaseUrl()}/api/v2/cli/events`, {
+    method: "POST",
+    headers: { "Content-Type": "application/json" },
+    body: JSON.stringify({ event, data })
+  }).catch(() => {
+  });
+}
+
 // src/commands/generate.ts
-import pc5 from "picocolors";
-import ora from "ora";
-import { mkdir as mkdir2, writeFile as writeFile2 } from "fs/promises";
+import pc6 from "picocolors";
+import ora2 from "ora";
+import { mkdir as mkdir2, writeFile as writeFile2, readFile, unlink } from "fs/promises";
 import { join as join4 } from "path";
 import { homedir as homedir3 } from "os";
+import { spawn } from "child_process";
 import { input, select as select2 } from "@inquirer/prompts";
 
 // src/utils/auth.ts
@@ -814,6 +813,148 @@ function buildAuthorizationUrl(baseUrl3, clientId, redirectUri, codeChallenge, s
   return url.toString();
 }
 
+// src/commands/auth.ts
+import pc4 from "picocolors";
+import ora from "ora";
+import open from "open";
+var CLI_CLIENT_ID = "2veBSofhicRBguUT";
+var baseUrl2 = "https://context7.com";
+function setAuthBaseUrl(url) {
+  baseUrl2 = url;
+}
+function registerAuthCommands(program2) {
+  program2.command("login").description("Log in to Context7").option("--no-browser", "Don't open browser automatically").action(async (options) => {
+    await loginCommand(options);
+  });
+  program2.command("logout").description("Log out of Context7").action(() => {
+    logoutCommand();
+  });
+  program2.command("whoami").description("Show current login status").action(async () => {
+    await whoamiCommand();
+  });
+}
+async function performLogin(openBrowser = true) {
+  const spinner = ora("Preparing login...").start();
+  try {
+    const { codeVerifier, codeChallenge } = generatePKCE();
+    const state = generateState();
+    const callbackServer = createCallbackServer(state);
+    const port = await callbackServer.port;
+    const redirectUri = `http://localhost:${port}/callback`;
+    const authUrl = buildAuthorizationUrl(
+      baseUrl2,
+      CLI_CLIENT_ID,
+      redirectUri,
+      codeChallenge,
+      state
+    );
+    spinner.stop();
+    console.log("");
+    console.log(pc4.bold("Opening browser to log in..."));
+    console.log("");
+    if (openBrowser) {
+      await open(authUrl);
+      console.log(pc4.dim("If the browser didn't open, visit this URL:"));
+    } else {
+      console.log(pc4.dim("Open this URL in your browser:"));
+    }
+    console.log(pc4.cyan(authUrl));
+    console.log("");
+    const waitingSpinner = ora("Waiting for login...").start();
+    try {
+      const { code } = await callbackServer.result;
+      waitingSpinner.text = "Exchanging code for tokens...";
+      const tokens = await exchangeCodeForTokens(
+        baseUrl2,
+        code,
+        codeVerifier,
+        redirectUri,
+        CLI_CLIENT_ID
+      );
+      saveTokens(tokens);
+      callbackServer.close();
+      waitingSpinner.succeed(pc4.green("Login successful!"));
+      return tokens.access_token;
+    } catch (error) {
+      callbackServer.close();
+      waitingSpinner.fail(pc4.red("Login failed"));
+      if (error instanceof Error) {
+        console.error(pc4.red(error.message));
+      }
+      return null;
+    }
+  } catch (error) {
+    spinner.fail(pc4.red("Login failed"));
+    if (error instanceof Error) {
+      console.error(pc4.red(error.message));
+    }
+    return null;
+  }
+}
+async function loginCommand(options) {
+  trackEvent("command", { name: "login" });
+  const existingTokens = loadTokens();
+  if (existingTokens) {
+    const expired = isTokenExpired(existingTokens);
+    if (!expired || existingTokens.refresh_token) {
+      console.log(pc4.yellow("You are already logged in."));
+      console.log(
+        pc4.dim("Run 'ctx7 logout' first if you want to log in with a different account.")
+      );
+      return;
+    }
+    clearTokens();
+  }
+  const token = await performLogin(options.browser);
+  if (!token) {
+    process.exit(1);
+  }
+  console.log("");
+  console.log(pc4.dim("You can now use authenticated Context7 features."));
+}
+function logoutCommand() {
+  trackEvent("command", { name: "logout" });
+  if (clearTokens()) {
+    console.log(pc4.green("Logged out successfully."));
+  } else {
+    console.log(pc4.yellow("You are not logged in."));
+  }
+}
+async function whoamiCommand() {
+  trackEvent("command", { name: "whoami" });
+  const tokens = loadTokens();
+  if (!tokens) {
+    console.log(pc4.yellow("Not logged in."));
+    console.log(pc4.dim("Run 'ctx7 login' to authenticate."));
+    return;
+  }
+  console.log(pc4.green("Logged in"));
+  try {
+    const userInfo = await fetchUserInfo(tokens.access_token);
+    if (userInfo.name) {
+      console.log(`${pc4.dim("Name:".padEnd(9))}${userInfo.name}`);
+    }
+    if (userInfo.email) {
+      console.log(`${pc4.dim("Email:".padEnd(9))}${userInfo.email}`);
+    }
+  } catch {
+    if (isTokenExpired(tokens) && !tokens.refresh_token) {
+      console.log(pc4.dim("(Session may be expired - run 'ctx7 login' to refresh)"));
+    }
+  }
+}
+async function fetchUserInfo(accessToken) {
+  const response = await fetch("https://clerk.context7.com/oauth/userinfo", {
+    headers: {
+      Authorization: `Bearer ${accessToken}`
+    }
+  });
+  if (!response.ok) {
+    throw new Error("Failed to fetch user info");
+  }
+  return await response.json();
+}
+
 // src/utils/selectOrInput.ts
 import {
   createPrompt,
@@ -824,10 +965,19 @@ import {
   isUpKey,
   isDownKey
 } from "@inquirer/core";
-import pc4 from "picocolors";
+import pc5 from "picocolors";
+function reorderOptions(options, recommendedIndex) {
+  if (recommendedIndex === 0) return options;
+  const reordered = [options[recommendedIndex]];
+  for (let i = 0; i < options.length; i++) {
+    if (i !== recommendedIndex) reordered.push(options[i]);
+  }
+  return reordered;
+}
 var selectOrInput = createPrompt((config, done) => {
-  const { message, options, recommendedIndex = 0 } = config;
-  const [cursor, setCursor] = useState(recommendedIndex);
+  const { message, options: rawOptions, recommendedIndex = 0 } = config;
+  const options = reorderOptions(rawOptions, recommendedIndex);
+  const [cursor, setCursor] = useState(0);
   const [inputValue, setInputValue] = useState("");
   const prefix = usePrefix({});
   useKeypress((key, rl) => {
@@ -842,7 +992,7 @@ var selectOrInput = createPrompt((config, done) => {
     if (isEnterKey(key)) {
       if (cursor === options.length) {
         const finalValue = inputValue.trim();
-        done(finalValue || options[recommendedIndex]);
+        done(finalValue || options[0]);
       } else {
         done(options[cursor]);
       }
@@ -872,16 +1022,16 @@ var selectOrInput = createPrompt((config, done) => {
       rl.line = "";
     }
   });
-  let output = `${prefix} ${pc4.bold(message)}
+  let output = `${prefix} ${pc5.bold(message)}
 
 `;
   options.forEach((opt, idx) => {
-    const isRecommended = idx === recommendedIndex;
+    const isRecommended = idx === 0;
     const isCursor = idx === cursor;
-    const number = pc4.cyan(`${idx + 1}.`);
-    const text = isRecommended ? `${opt} ${pc4.green("\u2713 Recommended")}` : opt;
+    const number = pc5.cyan(`${idx + 1}.`);
+    const text = isRecommended ? `${opt} ${pc5.green("\u2713 Recommended")}` : opt;
     if (isCursor) {
-      output += pc4.cyan(`\u276F ${number} ${text}
+      output += pc5.cyan(`\u276F ${number} ${text}
 `);
     } else {
       output += `  ${number} ${text}
@@ -890,9 +1040,9 @@ var selectOrInput = createPrompt((config, done) => {
   });
   const isCustomCursor = cursor === options.length;
   if (isCustomCursor) {
-    output += pc4.cyan(`\u276F ${pc4.yellow("\u270E")} ${inputValue || pc4.dim("Type your own...")}`);
+    output += pc5.cyan(`\u276F ${pc5.yellow("\u270E")} ${inputValue || pc5.dim("Type your own...")}`);
   } else {
-    output += `  ${pc4.yellow("\u270E")} ${pc4.dim("Type your own...")}`;
+    output += `  ${pc5.yellow("\u270E")} ${pc5.dim("Type your own...")}`;
   }
   return output;
 });
@@ -905,53 +1055,66 @@ function registerGenerateCommand(skillCommand) {
   });
 }
 async function generateCommand(options) {
+  trackEvent("command", { name: "generate" });
   log.blank();
+  let accessToken = null;
   const tokens = loadTokens();
-  if (!tokens) {
-    log.error("Authentication required. Please run 'ctx7 login' first.");
-    return;
-  }
-  if (isTokenExpired(tokens)) {
-    log.error("Session expired. Please run 'ctx7 login' to refresh.");
-    return;
+  if (tokens && !isTokenExpired(tokens)) {
+    accessToken = tokens.access_token;
+  } else {
+    log.info("Authentication required. Logging in...");
+    log.blank();
+    accessToken = await performLogin();
+    if (!accessToken) {
+      log.error("Login failed. Please try again.");
+      return;
+    }
+    log.blank();
   }
-  const accessToken = tokens.access_token;
-  const initSpinner = ora().start();
+  const initSpinner = ora2().start();
   const quota = await getSkillQuota(accessToken);
   if (quota.error) {
-    initSpinner.fail(pc5.red("Failed to initialize"));
+    initSpinner.fail(pc6.red("Failed to initialize"));
     return;
   }
   if (quota.tier !== "unlimited" && quota.remaining < 1) {
-    initSpinner.fail(pc5.red("Weekly skill generation limit reached"));
+    initSpinner.fail(pc6.red("Weekly skill generation limit reached"));
     log.blank();
     console.log(
-      `  You've used ${pc5.bold(pc5.white(quota.used.toString()))}/${pc5.bold(pc5.white(quota.limit.toString()))} skill generations this week.`
+      `  You've used ${pc6.bold(pc6.white(quota.used.toString()))}/${pc6.bold(pc6.white(quota.limit.toString()))} skill generations this week.`
     );
     console.log(
-      `  Your quota resets on ${pc5.yellow(new Date(quota.resetDate).toLocaleDateString())}.`
+      `  Your quota resets on ${pc6.yellow(new Date(quota.resetDate).toLocaleDateString())}.`
     );
     log.blank();
     if (quota.tier === "free") {
       console.log(
-        `  ${pc5.yellow("Tip:")} Upgrade to Pro for ${pc5.bold("10")} generations per week.`
+        `  ${pc6.yellow("Tip:")} Upgrade to Pro for ${pc6.bold("10")} generations per week.`
       );
-      console.log(`  Visit ${pc5.green("https://context7.com/dashboard")} to upgrade.`);
+      console.log(`  Visit ${pc6.green("https://context7.com/dashboard")} to upgrade.`);
     }
     return;
   }
   initSpinner.stop();
   initSpinner.clear();
-  console.log(pc5.bold("What should your agent become an expert at?\n"));
+  console.log(pc6.bold("What should your agent become an expert at?\n"));
   console.log(
-    pc5.dim("Skills teach agents best practices, design patterns, and domain expertise.\n")
+    pc6.dim(
+      "Skills should encode best practices, constraints, and decision-making \u2014\nnot step-by-step tutorials or one-off tasks.\n"
+    )
   );
-  console.log(pc5.yellow("Examples:"));
-  console.log(pc5.dim('  "React component optimization and performance best practices"'));
-  console.log(pc5.dim('  "Responsive web design with Tailwind CSS"'));
-  console.log(pc5.dim('  "Writing effective landing page copy"'));
-  console.log(pc5.dim('  "Deploying Next.js apps to Vercel"'));
-  console.log(pc5.dim('  "OAuth authentication with NextAuth.js"\n'));
+  console.log(pc6.yellow("Examples:"));
+  {
+    console.log(pc6.red('  \u2715 "Deploy a Next.js app to Vercel"'));
+    console.log(pc6.green('  \u2713 "Best practices and constraints for deploying Next.js apps to Vercel"'));
+    log.blank();
+    console.log(pc6.red('  \u2715 "Use Tailwind for responsive design"'));
+    console.log(pc6.green('  \u2713 "Responsive layout decision-making with Tailwind CSS"'));
+    log.blank();
+    console.log(pc6.red('  \u2715 "Build OAuth with NextAuth"'));
+    console.log(pc6.green('  \u2713 "OAuth authentication patterns and pitfalls with NextAuth.js"'));
+  }
+  log.blank();
   let motivation;
   try {
     motivation = await input({
@@ -966,14 +1129,26 @@ async function generateCommand(options) {
     log.warn("Generation cancelled");
     return;
   }
-  const searchSpinner = ora("Finding relevant libraries...").start();
+  log.blank();
+  console.log(
+    pc6.dim(
+      "To generate this skill, we will read relevant documentation and examples\nfrom Context7.\n"
+    )
+  );
+  console.log(
+    pc6.dim(
+      "These sources are used to:\n\u2022 extract best practices and constraints\n\u2022 compare patterns across official docs and examples\n\u2022 avoid outdated or incorrect guidance\n"
+    )
+  );
+  console.log(pc6.dim("You can adjust which sources the skill is based on.\n"));
+  const searchSpinner = ora2("Finding relevant sources...").start();
   const searchResult = await searchLibraries(motivation, accessToken);
   if (searchResult.error || !searchResult.results?.length) {
-    searchSpinner.fail(pc5.red("No libraries found"));
+    searchSpinner.fail(pc6.red("No sources found"));
     log.warn(searchResult.message || "Try a different description");
     return;
   }
-  searchSpinner.succeed(pc5.green(`Found ${searchResult.results.length} relevant libraries`));
+  searchSpinner.succeed(pc6.green(`Found ${searchResult.results.length} relevant sources`));
   log.blank();
   let selectedLibraries;
   try {
@@ -993,31 +1168,32 @@ async function generateCommand(options) {
     const libraryChoices = libraries.map((lib, index) => {
       const projectId = formatProjectId(lib.id);
       const isGitHub = isGitHubRepo(lib.id);
-      const indexStr = pc5.dim(`${(index + 1).toString().padStart(indexWidth)}.`);
+      const indexStr = pc6.dim(`${(index + 1).toString().padStart(indexWidth)}.`);
       const paddedName = lib.title.padEnd(maxNameLen);
       const libUrl = `https://context7.com${lib.id}`;
-      const libLink = terminalLink(lib.title, libUrl, pc5.white);
-      const repoLink = isGitHub ? terminalLink(projectId, `https://github.com/${projectId}`, pc5.white) : pc5.white(projectId);
-      const starsLine = lib.stars && isGitHub ? [`${pc5.yellow("Stars:")}       ${lib.stars.toLocaleString()}`] : [];
+      const libLink = terminalLink(lib.title, libUrl, pc6.white);
+      const sourceUrl = isGitHub ? `https://github.com/${projectId}` : `https://context7.com${lib.id}`;
+      const repoLink = terminalLink(projectId, sourceUrl, pc6.white);
+      const starsLine = lib.stars && isGitHub ? [`${pc6.yellow("Stars:")}       ${lib.stars.toLocaleString()}`] : [];
       const metadataLines = [
-        pc5.dim("\u2500".repeat(50)),
+        pc6.dim("\u2500".repeat(50)),
         "",
-        `${pc5.yellow("Library:")}     ${libLink}`,
-        `${pc5.yellow("Source:")}      ${repoLink}`,
-        `${pc5.yellow("Snippets:")}    ${lib.totalSnippets.toLocaleString()}`,
+        `${pc6.yellow("Library:")}     ${libLink}`,
+        `${pc6.yellow("Source:")}      ${repoLink}`,
+        `${pc6.yellow("Snippets:")}    ${lib.totalSnippets.toLocaleString()}`,
         ...starsLine,
-        `${pc5.yellow("Description:")}`,
-        pc5.white(lib.description || "No description")
+        `${pc6.yellow("Description:")}`,
+        pc6.white(lib.description || "No description")
       ];
       return {
-        name: `${indexStr} ${paddedName}  ${pc5.dim(`(${projectId})`)}`,
+        name: `${indexStr} ${paddedName}  ${pc6.dim(`(${projectId})`)}`,
         value: lib,
         description: metadataLines.join("\n")
       };
     });
     selectedLibraries = await checkboxWithHover(
       {
-        message: "Select libraries:",
+        message: "Select sources:",
         choices: libraryChoices,
         pageSize: 10,
         loop: false
@@ -1025,7 +1201,7 @@ async function generateCommand(options) {
       { getName: (lib) => `${lib.title} (${formatProjectId(lib.id)})` }
     );
     if (!selectedLibraries || selectedLibraries.length === 0) {
-      log.info("No libraries selected. Try running the command again.");
+      log.info("No sources selected. Try running the command again.");
       return;
     }
   } catch {
@@ -1033,15 +1209,17 @@ async function generateCommand(options) {
     return;
   }
   log.blank();
-  const questionsSpinner = ora("Preparing questions...").start();
+  const questionsSpinner = ora2(
+    "Preparing follow-up questions to clarify scope and constraints..."
+  ).start();
   const librariesInput = selectedLibraries.map((lib) => ({ id: lib.id, name: lib.title }));
   const questionsResult = await getSkillQuestions(librariesInput, motivation, accessToken);
   if (questionsResult.error || !questionsResult.questions?.length) {
-    questionsSpinner.fail(pc5.red("Failed to generate questions"));
+    questionsSpinner.fail(pc6.red("Failed to generate questions"));
     log.warn(questionsResult.message || "Please try again");
     return;
   }
-  questionsSpinner.succeed(pc5.green("Questions prepared"));
+  questionsSpinner.succeed(pc6.green("Questions prepared"));
   log.blank();
   const answers = [];
   try {
@@ -1050,7 +1228,7 @@ async function generateCommand(options) {
       const questionNum = i + 1;
       const totalQuestions = questionsResult.questions.length;
       const answer = await selectOrInput_default({
-        message: `${pc5.dim(`[${questionNum}/${totalQuestions}]`)} ${q.question}`,
+        message: `${pc6.dim(`[${questionNum}/${totalQuestions}]`)} ${q.question}`,
         options: q.options,
         recommendedIndex: q.recommendedIndex
       });
@@ -1061,8 +1239,8 @@ async function generateCommand(options) {
       const linesToClear = 3 + q.options.length;
       process.stdout.write(`\x1B[${linesToClear}A\x1B[J`);
       const truncatedAnswer = answer.length > 50 ? answer.slice(0, 47) + "..." : answer;
-      console.log(`${pc5.green("\u2713")} ${pc5.dim(`[${questionNum}/${totalQuestions}]`)} ${q.question}`);
-      console.log(`  ${pc5.cyan(truncatedAnswer)}`);
+      console.log(`${pc6.green("\u2713")} ${pc6.dim(`[${questionNum}/${totalQuestions}]`)} ${q.question}`);
+      console.log(`  ${pc6.cyan(truncatedAnswer)}`);
       log.blank();
     }
   } catch {
@@ -1072,33 +1250,39 @@ async function generateCommand(options) {
   let generatedContent = null;
   let skillName = "";
   let feedback;
-  const libraryNames = selectedLibraries.map((lib) => lib.title).join(", ");
+  let previewFile = null;
+  let previewFileWritten = false;
+  const cleanupPreviewFile = async () => {
+    if (previewFile) {
+      await unlink(previewFile).catch(() => {
+      });
+    }
+  };
   const queryLog = [];
   let genSpinner = null;
   const formatQueryLogText = () => {
     if (queryLog.length === 0) return "";
     const lines = [];
     const latestEntry = queryLog[queryLog.length - 1];
-    lines.push(pc5.dim(`(${queryLog.length} ${queryLog.length === 1 ? "query" : "queries"})`));
     lines.push("");
     for (const result of latestEntry.results.slice(0, 3)) {
       const cleanContent = result.content.replace(/Source:\s*https?:\/\/[^\s]+/gi, "").trim();
       if (cleanContent) {
-        lines.push(`  ${pc5.yellow("\u2022")} ${pc5.white(result.title)}`);
+        lines.push(`  ${pc6.yellow("\u2022")} ${pc6.white(result.title)}`);
         const maxLen = 400;
         const content = cleanContent.length > maxLen ? cleanContent.slice(0, maxLen - 3) + "..." : cleanContent;
         const words = content.split(" ");
         let currentLine = "    ";
         for (const word of words) {
           if (currentLine.length + word.length > 84) {
-            lines.push(pc5.dim(currentLine));
+            lines.push(pc6.dim(currentLine));
             currentLine = "    " + word + " ";
           } else {
             currentLine += word + " ";
           }
         }
         if (currentLine.trim()) {
-          lines.push(pc5.dim(currentLine));
+          lines.push(pc6.dim(currentLine));
         }
         lines.push("");
       }
@@ -1106,19 +1290,20 @@ async function generateCommand(options) {
     return "\n" + lines.join("\n");
   };
   let isGeneratingContent = false;
+  let initialStatus = "Reading selected Context7 sources to generate the skill...";
   const handleStreamEvent = (event) => {
     if (event.type === "progress") {
       if (genSpinner) {
         if (event.message.startsWith("Generating skill content...") && !isGeneratingContent) {
           isGeneratingContent = true;
           if (queryLog.length > 0) {
-            genSpinner.succeed(pc5.green(`Queried documentation`));
+            genSpinner.succeed(pc6.green(`Read Context7 sources`));
           } else {
-            genSpinner.succeed(pc5.green(`Ready to generate`));
+            genSpinner.succeed(pc6.green(`Ready to generate`));
           }
-          genSpinner = ora("Generating skill content...").start();
+          genSpinner = ora2("Generating skill content...").start();
         } else if (!isGeneratingContent) {
-          genSpinner.text = event.message + formatQueryLogText();
+          genSpinner.text = initialStatus + formatQueryLogText();
         }
       }
     } else if (event.type === "tool_result") {
@@ -1142,18 +1327,19 @@ async function generateCommand(options) {
     };
     queryLog.length = 0;
     isGeneratingContent = false;
-    const initialStatus = feedback ? "Regenerating skill with your feedback..." : `Generating skill for "${libraryNames}"...`;
-    genSpinner = ora(initialStatus).start();
+    previewFileWritten = false;
+    initialStatus = feedback ? "Regenerating skill with your feedback..." : "Reading selected Context7 sources to generate the skill...";
+    genSpinner = ora2(initialStatus).start();
     const result = await generateSkillStructured(generateInput, handleStreamEvent, accessToken);
     if (result.error) {
-      genSpinner.fail(pc5.red(`Error: ${result.error}`));
+      genSpinner.fail(pc6.red(`Error: ${result.error}`));
       return;
     }
     if (!result.content) {
-      genSpinner.fail(pc5.red("No content generated"));
+      genSpinner.fail(pc6.red("No content generated"));
       return;
     }
-    genSpinner.succeed(pc5.green(`Generated skill for "${result.libraryName}"`));
+    genSpinner.succeed(pc6.green(`Generated skill for "${result.libraryName}"`));
     generatedContent = result.content;
     skillName = result.libraryName.toLowerCase().replace(/[^a-z0-9-]/g, "-");
     const contentLines = generatedContent.split("\n");
@@ -1163,29 +1349,40 @@ async function generateCommand(options) {
     const remainingLines = contentLines.length - previewLineCount;
     const showPreview = () => {
       log.blank();
-      console.log(pc5.dim("\u2501".repeat(70)));
-      console.log(pc5.bold(`Generated Skill: `) + pc5.green(pc5.bold(skillName)));
-      console.log(pc5.dim("\u2501".repeat(70)));
+      console.log(pc6.dim("\u2501".repeat(70)));
+      console.log(pc6.bold(`Generated Skill: `) + pc6.green(pc6.bold(skillName)));
+      console.log(pc6.dim("\u2501".repeat(70)));
       log.blank();
       console.log(previewContent);
       if (hasMoreLines) {
         log.blank();
-        console.log(pc5.dim(`... ${remainingLines} more lines`));
+        console.log(pc6.dim(`... ${remainingLines} more lines`));
       }
       log.blank();
-      console.log(pc5.dim("\u2501".repeat(70)));
+      console.log(pc6.dim("\u2501".repeat(70)));
       log.blank();
     };
-    const showFullContent = () => {
-      log.blank();
-      console.log(pc5.dim("\u2501".repeat(70)));
-      console.log(pc5.bold(`Generated Skill: `) + pc5.green(pc5.bold(skillName)));
-      console.log(pc5.dim("\u2501".repeat(70)));
-      log.blank();
-      console.log(generatedContent);
-      log.blank();
-      console.log(pc5.dim("\u2501".repeat(70)));
-      log.blank();
+    const openInEditor = async () => {
+      const previewDir = join4(homedir3(), ".context7", "previews");
+      await mkdir2(previewDir, { recursive: true });
+      previewFile = join4(previewDir, `${skillName}.md`);
+      if (!previewFileWritten) {
+        await writeFile2(previewFile, generatedContent, "utf-8");
+        previewFileWritten = true;
+      }
+      const editor = process.env.EDITOR || "open";
+      await new Promise((resolve) => {
+        const child = spawn(editor, [previewFile], {
+          stdio: "inherit",
+          shell: true
+        });
+        child.on("close", () => resolve());
+      });
+    };
+    const syncFromPreviewFile = async () => {
+      if (previewFile) {
+        generatedContent = await readFile(previewFile, "utf-8");
+      }
     };
     showPreview();
     await new Promise((resolve) => setTimeout(resolve, 100));
@@ -1193,27 +1390,30 @@ async function generateCommand(options) {
       let action;
       while (true) {
         const choices = [
-          { name: `${pc5.green("\u2713")} Install skill`, value: "install" },
-          ...hasMoreLines ? [{ name: `${pc5.blue("\u2922")} View full skill`, value: "expand" }] : [],
-          { name: `${pc5.yellow("\u270E")} Request changes`, value: "feedback" },
-          { name: `${pc5.red("\u2715")} Cancel`, value: "cancel" }
+          { name: `${pc6.green("\u2713")} Install skill (save locally)`, value: "install" },
+          { name: `${pc6.blue("\u2922")} Edit skill in editor`, value: "view" },
+          { name: `${pc6.yellow("\u270E")} Request changes`, value: "feedback" },
+          { name: `${pc6.red("\u2715")} Cancel`, value: "cancel" }
         ];
         action = await select2({
           message: "What would you like to do?",
           choices
         });
-        if (action === "expand") {
-          showFullContent();
+        if (action === "view") {
+          await openInEditor();
           continue;
         }
+        await syncFromPreviewFile();
         break;
       }
       if (action === "install") {
         break;
       } else if (action === "cancel") {
+        await cleanupPreviewFile();
         log.warn("Generation cancelled");
         return;
       } else if (action === "feedback") {
+        trackEvent("gen_feedback");
         feedback = await input({
           message: "What changes would you like? (press Enter to skip)"
         });
@@ -1223,6 +1423,7 @@ async function generateCommand(options) {
         log.blank();
       }
     } catch {
+      await cleanupPreviewFile();
       log.warn("Generation cancelled");
       return;
     }
@@ -1233,7 +1434,7 @@ async function generateCommand(options) {
     return;
   }
   const targetDirs = getTargetDirs(targets);
-  const writeSpinner = ora("Writing skill files...").start();
+  const writeSpinner = ora2("Writing skill files...").start();
   let permissionError = false;
   const failedDirs = /* @__PURE__ */ new Set();
   for (const targetDir of targetDirs) {
@@ -1257,23 +1458,25 @@ async function generateCommand(options) {
     }
   }
   if (permissionError) {
-    writeSpinner.fail(pc5.red("Permission denied"));
+    writeSpinner.fail(pc6.red("Permission denied"));
     log.blank();
-    console.log(pc5.yellow("Fix permissions with:"));
+    console.log(pc6.yellow("Fix permissions with:"));
     for (const dir of failedDirs) {
       const parentDir = join4(dir, "..");
-      console.log(pc5.dim(`  sudo chown -R $(whoami) "${parentDir}"`));
+      console.log(pc6.dim(`  sudo chown -R $(whoami) "${parentDir}"`));
     }
     log.blank();
     return;
   }
-  writeSpinner.succeed(pc5.green(`Created skill in ${targetDirs.length} location(s)`));
+  writeSpinner.succeed(pc6.green(`Created skill in ${targetDirs.length} location(s)`));
+  trackEvent("gen_install");
   log.blank();
-  console.log(pc5.green(pc5.bold("Skill saved successfully")));
+  console.log(pc6.green("Skill saved successfully"));
   for (const targetDir of targetDirs) {
-    console.log(pc5.dim(`  ${targetDir}/`) + pc5.green(skillName));
+    console.log(pc6.dim(`  ${targetDir}/`) + pc6.green(skillName));
   }
   log.blank();
+  await cleanupPreviewFile();
 }
 
 // src/commands/skill.ts
@@ -1320,6 +1523,7 @@ function registerSkillAliases(program2) {
   });
 }
 async function installCommand(input2, skillName, options) {
+  trackEvent("command", { name: "install" });
   const parsed = parseSkillInput(input2);
   if (!parsed) {
     log.error(`Invalid input format: ${input2}`);
@@ -1330,17 +1534,17 @@ async function installCommand(input2, skillName, options) {
   }
   const repo = `/${parsed.owner}/${parsed.repo}`;
   log.blank();
-  const spinner = ora2(`Fetching skills from ${repo}...`).start();
+  const spinner = ora3(`Fetching skills from ${repo}...`).start();
   let selectedSkills;
   if (skillName) {
     spinner.text = `Fetching skill: ${skillName}...`;
     const skillData = await getSkill(repo, skillName);
     if (skillData.error || !skillData.name) {
       if (skillData.error === "prompt_injection_detected") {
-        spinner.fail(pc6.red(`Prompt injection detected in skill: ${skillName}`));
+        spinner.fail(pc7.red(`Prompt injection detected in skill: ${skillName}`));
         log.warn("This skill contains potentially malicious content and cannot be installed.");
       } else {
-        spinner.fail(pc6.red(`Skill not found: ${skillName}`));
+        spinner.fail(pc7.red(`Skill not found: ${skillName}`));
       }
       return;
     }
@@ -1356,14 +1560,14 @@ async function installCommand(input2, skillName, options) {
   } else {
     const data = await listProjectSkills(repo);
     if (data.error) {
-      spinner.fail(pc6.red(`Error: ${data.message || data.error}`));
+      spinner.fail(pc7.red(`Error: ${data.message || data.error}`));
       return;
     }
     if (!data.skills || data.skills.length === 0) {
-      spinner.warn(pc6.yellow(`No skills found in ${repo}`));
+      spinner.warn(pc7.yellow(`No skills found in ${repo}`));
       return;
     }
-    const skillsWithRepo = data.skills.map((s) => ({ ...s, project: repo }));
+    const skillsWithRepo = data.skills.map((s) => ({ ...s, project: repo })).sort((a, b) => (b.installCount ?? 0) - (a.installCount ?? 0));
     spinner.succeed(`Found ${data.skills.length} skill(s)`);
     if (data.blockedSkillsCount && data.blockedSkillsCount > 0) {
       log.blank();
@@ -1378,19 +1582,19 @@ async function installCommand(input2, skillName, options) {
       const indexWidth = data.skills.length.toString().length;
       const maxNameLen = Math.max(...data.skills.map((s) => s.name.length));
       const choices = skillsWithRepo.map((s, index) => {
-        const indexStr = pc6.dim(`${(index + 1).toString().padStart(indexWidth)}.`);
+        const indexStr = pc7.dim(`${(index + 1).toString().padStart(indexWidth)}.`);
         const paddedName = s.name.padEnd(maxNameLen);
         const installs = formatInstallCount(s.installCount);
         const skillUrl = `https://context7.com/skills${s.project}/${s.name}`;
-        const skillLink = terminalLink(s.name, skillUrl, pc6.white);
-        const repoLink = terminalLink(s.project, `https://github.com${s.project}`, pc6.white);
+        const skillLink = terminalLink(s.name, skillUrl, pc7.white);
+        const repoLink = terminalLink(s.project, `https://github.com${s.project}`, pc7.white);
         const metadataLines = [
-          pc6.dim("\u2500".repeat(50)),
+          pc7.dim("\u2500".repeat(50)),
           "",
-          `${pc6.yellow("Skill:")}       ${skillLink}`,
-          `${pc6.yellow("Repo:")}        ${repoLink}`,
-          `${pc6.yellow("Description:")}`,
-          pc6.white(s.description || "No description")
+          `${pc7.yellow("Skill:")}       ${skillLink}`,
+          `${pc7.yellow("Repo:")}        ${repoLink}`,
+          `${pc7.yellow("Description:")}`,
+          pc7.white(s.description || "No description")
         ];
         return {
           name: installs ? `${indexStr} ${paddedName} ${installs}` : `${indexStr} ${paddedName}`,
@@ -1399,9 +1603,11 @@ async function installCommand(input2, skillName, options) {
         };
       });
       log.blank();
+      const installsOffset = 4 + indexWidth + 1 + 1 + maxNameLen + 1 - 3;
+      const message = "Select skills:" + " ".repeat(Math.max(1, installsOffset - 14)) + pc7.dim("installs");
       try {
         selectedSkills = await checkboxWithHover({
-          message: "Select skills:",
+          message,
           choices,
           pageSize: 15,
           loop: false
@@ -1422,7 +1628,7 @@ async function installCommand(input2, skillName, options) {
     return;
   }
   const targetDirs = getTargetDirs(targets);
-  const installSpinner = ora2("Installing skills...").start();
+  const installSpinner = ora3("Installing skills...").start();
   let permissionError = false;
   const failedDirs = /* @__PURE__ */ new Set();
   const installedSkills = [];
@@ -1481,60 +1687,69 @@ async function installCommand(input2, skillName, options) {
     return;
   }
   installSpinner.succeed(`Installed ${installedSkills.length} skill(s)`);
-  trackInstalls(installedSkills, targets.ides);
+  trackEvent("install", { skills: installedSkills, ides: targets.ides });
   const installedNames = selectedSkills.map((s) => s.name);
   logInstallSummary(targets, targetDirs, installedNames);
 }
 async function searchCommand(query) {
+  trackEvent("command", { name: "search" });
   log.blank();
-  const spinner = ora2(`Searching for "${query}"...`).start();
+  const spinner = ora3(`Searching for "${query}"...`).start();
   let data;
   try {
     data = await searchSkills(query);
   } catch (err) {
-    spinner.fail(pc6.red(`Error: ${err instanceof Error ? err.message : String(err)}`));
+    spinner.fail(pc7.red(`Error: ${err instanceof Error ? err.message : String(err)}`));
     return;
   }
   if (data.error) {
-    spinner.fail(pc6.red(`Error: ${data.message || data.error}`));
+    spinner.fail(pc7.red(`Error: ${data.message || data.error}`));
     return;
   }
   if (!data.results || data.results.length === 0) {
-    spinner.warn(pc6.yellow(`No skills found matching "${query}"`));
+    spinner.warn(pc7.yellow(`No skills found matching "${query}"`));
     return;
   }
   spinner.succeed(`Found ${data.results.length} skill(s)`);
+  trackEvent("search_query", { query, resultCount: data.results.length });
   const indexWidth = data.results.length.toString().length;
   const maxNameLen = Math.max(...data.results.map((s) => s.name.length));
+  const installsColWidth = 10;
   const choices = data.results.map((s, index) => {
-    const indexStr = pc6.dim(`${(index + 1).toString().padStart(indexWidth)}.`);
+    const indexStr = pc7.dim(`${(index + 1).toString().padStart(indexWidth)}.`);
     const paddedName = s.name.padEnd(maxNameLen);
-    const installs = formatInstallCount(s.installCount);
+    const installsRaw = s.installCount ? String(s.installCount) : "-";
+    const paddedInstalls = formatInstallCount(s.installCount, pc7.dim("-")) + " ".repeat(installsColWidth - installsRaw.length);
+    const trust = formatTrustScore(s.trustScore);
     const skillLink = terminalLink(
       s.name,
       `https://context7.com/skills${s.project}/${s.name}`,
-      pc6.white
+      pc7.white
     );
-    const repoLink = terminalLink(s.project, `https://github.com${s.project}`, pc6.white);
+    const repoLink = terminalLink(s.project, `https://github.com${s.project}`, pc7.white);
     const metadataLines = [
-      pc6.dim("\u2500".repeat(50)),
+      pc7.dim("\u2500".repeat(50)),
       "",
-      `${pc6.yellow("Skill:")}       ${skillLink}`,
-      `${pc6.yellow("Repo:")}        ${repoLink}`,
-      `${pc6.yellow("Description:")}`,
-      pc6.white(s.description || "No description")
+      `${pc7.yellow("Skill:")}       ${skillLink}`,
+      `${pc7.yellow("Repo:")}        ${repoLink}`,
+      `${pc7.yellow("Description:")}`,
+      pc7.white(s.description || "No description")
     ];
     return {
-      name: installs ? `${indexStr} ${paddedName} ${installs}` : `${indexStr} ${paddedName}`,
+      name: `${indexStr} ${paddedName} ${paddedInstalls}${trust}`,
       value: s,
       description: metadataLines.join("\n")
     };
   });
   log.blank();
+  const checkboxPrefixWidth = 3;
+  const headerPad = " ".repeat(checkboxPrefixWidth + indexWidth + 1 + 1 + maxNameLen + 1);
+  const headerLine = headerPad + pc7.dim("Installs".padEnd(installsColWidth)) + pc7.dim("Trust(0-10)");
+  const message = "Select skills to install:\n" + headerLine;
   let selectedSkills;
   try {
     selectedSkills = await checkboxWithHover({
-      message: "Select skills to install:",
+      message,
       choices,
       pageSize: 15,
       loop: false
@@ -1554,7 +1769,7 @@ async function searchCommand(query) {
     return;
   }
   const targetDirs = getTargetDirs(targets);
-  const installSpinner = ora2("Installing skills...").start();
+  const installSpinner = ora3("Installing skills...").start();
   let permissionError = false;
   const failedDirs = /* @__PURE__ */ new Set();
   const installedSkills = [];
@@ -1613,11 +1828,12 @@ async function searchCommand(query) {
     return;
   }
   installSpinner.succeed(`Installed ${installedSkills.length} skill(s)`);
-  trackInstalls(installedSkills, targets.ides);
+  trackEvent("install", { skills: installedSkills, ides: targets.ides });
   const installedNames = uniqueSkills.map((s) => s.name);
   logInstallSummary(targets, targetDirs, installedNames);
 }
 async function listCommand(options) {
+  trackEvent("command", { name: "list" });
   const scope = options.global ? "global" : "project";
   const pathMap = scope === "global" ? IDE_GLOBAL_PATHS : IDE_PATHS;
   const baseDir = scope === "global" ? homedir4() : process.cwd();
@@ -1642,14 +1858,15 @@ async function listCommand(options) {
   for (const { ide, skills } of results) {
     const ideName = IDE_NAMES[ide];
     const path2 = pathMap[ide];
-    log.plain(`${pc6.bold(ideName)} ${pc6.dim(path2)}`);
+    log.plain(`${pc7.bold(ideName)} ${pc7.dim(path2)}`);
     for (const skill of skills) {
-      log.plain(`  ${pc6.green(skill)}`);
+      log.plain(`  ${pc7.green(skill)}`);
     }
     log.blank();
   }
 }
 async function removeCommand(name, options) {
+  trackEvent("command", { name: "remove" });
   const target = await promptForSingleTarget(options);
   if (!target) {
     log.warn("Cancelled");
@@ -1672,6 +1889,7 @@ async function removeCommand(name, options) {
   }
 }
 async function infoCommand(input2) {
+  trackEvent("command", { name: "info" });
   const parsed = parseSkillInput(input2);
   if (!parsed) {
     log.blank();
@@ -1682,14 +1900,14 @@ async function infoCommand(input2) {
   }
   const repo = `/${parsed.owner}/${parsed.repo}`;
   log.blank();
-  const spinner = ora2(`Fetching skills from ${repo}...`).start();
+  const spinner = ora3(`Fetching skills from ${repo}...`).start();
   const data = await listProjectSkills(repo);
   if (data.error) {
-    spinner.fail(pc6.red(`Error: ${data.message || data.error}`));
+    spinner.fail(pc7.red(`Error: ${data.message || data.error}`));
     return;
   }
   if (!data.skills || data.skills.length === 0) {
-    spinner.warn(pc6.yellow(`No skills found in ${repo}`));
+    spinner.warn(pc7.yellow(`No skills found in ${repo}`));
     return;
   }
   spinner.succeed(`Found ${data.skills.length} skill(s)`);
@@ -1701,145 +1919,13 @@ async function infoCommand(input2) {
     log.blank();
   }
   log.plain(
-    `${pc6.bold("Quick commands:")}
-  Install all: ${pc6.cyan(`ctx7 skills install ${repo} --all`)}
-  Install one: ${pc6.cyan(`ctx7 skills install ${repo} ${data.skills[0]?.name}`)}
+    `${pc7.bold("Quick commands:")}
+  Install all: ${pc7.cyan(`ctx7 skills install ${repo} --all`)}
+  Install one: ${pc7.cyan(`ctx7 skills install ${repo} ${data.skills[0]?.name}`)}
 `
   );
 }
 
-// src/commands/auth.ts
-import pc7 from "picocolors";
-import ora3 from "ora";
-import open from "open";
-var CLI_CLIENT_ID = "2veBSofhicRBguUT";
-var baseUrl2 = "https://context7.com";
-function setAuthBaseUrl(url) {
-  baseUrl2 = url;
-}
-function registerAuthCommands(program2) {
-  program2.command("login").description("Log in to Context7").option("--no-browser", "Don't open browser automatically").action(async (options) => {
-    await loginCommand(options);
-  });
-  program2.command("logout").description("Log out of Context7").action(() => {
-    logoutCommand();
-  });
-  program2.command("whoami").description("Show current login status").action(async () => {
-    await whoamiCommand();
-  });
-}
-async function loginCommand(options) {
-  const existingTokens = loadTokens();
-  if (existingTokens) {
-    const expired = isTokenExpired(existingTokens);
-    if (!expired || existingTokens.refresh_token) {
-      console.log(pc7.yellow("You are already logged in."));
-      console.log(
-        pc7.dim("Run 'ctx7 logout' first if you want to log in with a different account.")
-      );
-      return;
-    }
-    clearTokens();
-  }
-  const spinner = ora3("Preparing login...").start();
-  try {
-    const { codeVerifier, codeChallenge } = generatePKCE();
-    const state = generateState();
-    const callbackServer = createCallbackServer(state);
-    const port = await callbackServer.port;
-    const redirectUri = `http://localhost:${port}/callback`;
-    const authUrl = buildAuthorizationUrl(
-      baseUrl2,
-      CLI_CLIENT_ID,
-      redirectUri,
-      codeChallenge,
-      state
-    );
-    spinner.stop();
-    console.log("");
-    console.log(pc7.bold("Opening browser to log in..."));
-    console.log("");
-    if (options.browser) {
-      await open(authUrl);
-      console.log(pc7.dim("If the browser didn't open, visit this URL:"));
-    } else {
-      console.log(pc7.dim("Open this URL in your browser:"));
-    }
-    console.log(pc7.cyan(authUrl));
-    console.log("");
-    const waitingSpinner = ora3("Waiting for login...").start();
-    try {
-      const { code } = await callbackServer.result;
-      waitingSpinner.text = "Exchanging code for tokens...";
-      const tokens = await exchangeCodeForTokens(
-        baseUrl2,
-        code,
-        codeVerifier,
-        redirectUri,
-        CLI_CLIENT_ID
-      );
-      saveTokens(tokens);
-      callbackServer.close();
-      waitingSpinner.succeed(pc7.green("Login successful!"));
-      console.log("");
-      console.log(pc7.dim("You can now use authenticated Context7 features."));
-    } catch (error) {
-      callbackServer.close();
-      waitingSpinner.fail(pc7.red("Login failed"));
-      if (error instanceof Error) {
-        console.error(pc7.red(error.message));
-      }
-      process.exit(1);
-    }
-  } catch (error) {
-    spinner.fail(pc7.red("Login failed"));
-    if (error instanceof Error) {
-      console.error(pc7.red(error.message));
-    }
-    process.exit(1);
-  }
-}
-function logoutCommand() {
-  if (clearTokens()) {
-    console.log(pc7.green("Logged out successfully."));
-  } else {
-    console.log(pc7.yellow("You are not logged in."));
-  }
-}
-async function whoamiCommand() {
-  const tokens = loadTokens();
-  if (!tokens) {
-    console.log(pc7.yellow("Not logged in."));
-    console.log(pc7.dim("Run 'ctx7 login' to authenticate."));
-    return;
-  }
-  console.log(pc7.green("Logged in"));
-  try {
-    const userInfo = await fetchUserInfo(tokens.access_token);
-    if (userInfo.name) {
-      console.log(`${pc7.dim("Name:".padEnd(9))}${userInfo.name}`);
-    }
-    if (userInfo.email) {
-      console.log(`${pc7.dim("Email:".padEnd(9))}${userInfo.email}`);
-    }
-  } catch {
-    if (isTokenExpired(tokens) && !tokens.refresh_token) {
-      console.log(pc7.dim("(Session may be expired - run 'ctx7 login' to refresh)"));
-    }
-  }
-}
-async function fetchUserInfo(accessToken) {
-  const response = await fetch("https://clerk.context7.com/oauth/userinfo", {
-    headers: {
-      Authorization: `Bearer ${accessToken}`
-    }
-  });
-  if (!response.ok) {
-    throw new Error("Failed to fetch user info");
-  }
-  return await response.json();
-}
-
 // src/constants.ts
 import { readFileSync as readFileSync2 } from "fs";
 import { fileURLToPath } from "url";