ctx7 0.3.9 → 0.3.11

package/README.md

@@ -177,6 +177,12 @@ ctx7 skills install /anthropics/skills pdf --universal
 
 # Install globally (home directory instead of current project)
 ctx7 skills install /anthropics/skills pdf --global
+
+# Install non-interactively
+ctx7 skills install /anthropics/skills pdf --global --universal --yes
+
+# Install to all supported agent locations
+ctx7 skills install /anthropics/skills pdf --all-agents
 ```
 
 ### Search for skills

package/dist/index.js

@@ -29,6 +29,7 @@ function parseSkillInput(input2) {
 }
 
 // src/utils/github.ts
+import { execSync } from "child_process";
 var GITHUB_API = "https://api.github.com";
 var GITHUB_RAW = "https://raw.githubusercontent.com";
 function parseGitHubUrl(url) {
@@ -69,6 +70,115 @@ function parseGitHubUrl(url) {
     return null;
   }
 }
+function getGitHubToken() {
+  const envToken = process.env.GITHUB_TOKEN || process.env.GH_TOKEN;
+  if (envToken) return envToken;
+  try {
+    return execSync("gh auth token", { stdio: ["pipe", "pipe", "ignore"] }).toString().trim();
+  } catch {
+    return void 0;
+  }
+}
+function parseSkillFrontmatter(content) {
+  const frontmatterMatch = content.match(/^---\s*\n([\s\S]*?)\n---/);
+  if (!frontmatterMatch) return null;
+  const frontmatter = frontmatterMatch[1];
+  const nameMatch = frontmatter.match(/^name:\s*(.+)$/m);
+  if (!nameMatch) return null;
+  const name = nameMatch[1].trim().replace(/^["']|["']$/g, "").toLowerCase();
+  let description = "";
+  const multiLineMatch = frontmatter.match(/^description:\s*([|>])-?\s*$/m);
+  if (multiLineMatch) {
+    const descLineIndex = frontmatter.indexOf("description:");
+    const lines = frontmatter.slice(descLineIndex).split("\n").slice(1);
+    const indentedLines = [];
+    for (const line of lines) {
+      if (line.trim() === "") {
+        indentedLines.push("");
+        continue;
+      }
+      if (/^\s+/.test(line)) {
+        indentedLines.push(line);
+      } else {
+        break;
+      }
+    }
+    const firstNonEmpty = indentedLines.find((l) => l.trim().length > 0);
+    const indent = firstNonEmpty?.match(/^(\s+)/)?.[1].length ?? 0;
+    description = indentedLines.map((line) => line.slice(indent)).join(" ").replace(/\s+/g, " ").trim();
+  } else {
+    const singleMatch = frontmatter.match(/^description:\s*(.+)$/m);
+    if (singleMatch) {
+      const value = singleMatch[1].trim();
+      if (!["|", ">", "|-", ">-"].includes(value)) {
+        description = value.replace(/^["']|["']$/g, "");
+      }
+    }
+  }
+  if (!description) return null;
+  return { name, description };
+}
+function getGitHubHeaders() {
+  const ghToken = getGitHubToken();
+  return {
+    Accept: "application/vnd.github.v3+json",
+    "User-Agent": "context7-cli",
+    ...ghToken && { Authorization: `token ${ghToken}` }
+  };
+}
+async function fetchRepoTree(owner, repo, branch, headers) {
+  const treeUrl = `${GITHUB_API}/repos/${owner}/${repo}/git/trees/${branch}?recursive=1`;
+  const response = await fetch(treeUrl, { headers });
+  if (!response.ok) return null;
+  return await response.json();
+}
+async function fetchDefaultBranch(owner, repo, headers) {
+  const response = await fetch(`${GITHUB_API}/repos/${owner}/${repo}`, { headers });
+  if (!response.ok) return { status: response.status };
+  const data = await response.json();
+  return { branch: data.default_branch };
+}
+async function listSkillsFromGitHub(project) {
+  try {
+    const parts = project.split("/").filter(Boolean);
+    if (parts.length < 2) return { status: "error", error: "Invalid project format" };
+    const [owner, repo] = parts;
+    const headers = getGitHubHeaders();
+    const branchResult = await fetchDefaultBranch(owner, repo, headers);
+    if ("status" in branchResult) return { status: "repo_not_found" };
+    const treeData = await fetchRepoTree(owner, repo, branchResult.branch, headers);
+    if (!treeData) return { status: "error", error: "Could not fetch repository tree" };
+    const skillMdFiles = treeData.tree.filter(
+      (item) => item.type === "blob" && item.path.toLowerCase().endsWith("skill.md")
+    );
+    const skills = [];
+    for (const item of skillMdFiles) {
+      const rawUrl = `${GITHUB_RAW}/${owner}/${repo}/${branchResult.branch}/${item.path}`;
+      const response = await fetch(rawUrl, { headers });
+      if (!response.ok) continue;
+      const content = await response.text();
+      const meta = parseSkillFrontmatter(content);
+      if (!meta) continue;
+      const skillDir = item.path.split("/").slice(0, -1).join("/");
+      skills.push({
+        name: meta.name,
+        description: meta.description,
+        url: `https://github.com/${owner}/${repo}/tree/${branchResult.branch}/${skillDir}`,
+        project
+      });
+    }
+    return { status: "ok", skills };
+  } catch (err) {
+    const message = err instanceof Error ? err.message : String(err);
+    return { status: "error", error: message };
+  }
+}
+async function getSkillFromGitHub(project, skillName) {
+  const result = await listSkillsFromGitHub(project);
+  if (result.status !== "ok") return result;
+  const skill = result.skills.find((s) => s.name === skillName.toLowerCase());
+  return { ...result, skill };
+}
 async function downloadSkillFromGitHub(skill) {
   try {
     const parsed = parseGitHubUrl(skill.url);
@@ -76,17 +186,11 @@ async function downloadSkillFromGitHub(skill) {
       return { files: [], error: `Invalid GitHub URL: ${skill.url}` };
     }
     const { owner, repo, branch, path: skillPath } = parsed;
-    const treeUrl = `${GITHUB_API}/repos/${owner}/${repo}/git/trees/${branch}?recursive=1`;
-    const treeResponse = await fetch(treeUrl, {
-      headers: {
-        Accept: "application/vnd.github.v3+json",
-        "User-Agent": "context7-cli"
-      }
-    });
-    if (!treeResponse.ok) {
-      return { files: [], error: `GitHub API error: ${treeResponse.status}` };
+    const ghHeaders = getGitHubHeaders();
+    const treeData = await fetchRepoTree(owner, repo, branch, ghHeaders);
+    if (!treeData) {
+      return { files: [], error: `GitHub API error` };
     }
-    const treeData = await treeResponse.json();
     const skillFiles = treeData.tree.filter(
       (item) => item.type === "blob" && item.path.startsWith(skillPath + "/")
     );
@@ -96,7 +200,7 @@ async function downloadSkillFromGitHub(skill) {
     const files = [];
     for (const item of skillFiles) {
       const rawUrl = `${GITHUB_RAW}/${owner}/${repo}/${branch}/${item.path}`;
-      const fileResponse = await fetch(rawUrl);
+      const fileResponse = await fetch(rawUrl, { headers: ghHeaders });
       if (!fileResponse.ok) {
         console.warn(`Failed to fetch ${item.path}: ${fileResponse.status}`);
         continue;
@@ -167,11 +271,19 @@ async function suggestSkills(dependencies, accessToken) {
 async function downloadSkill(project, skillName) {
   const skillData = await getSkill(project, skillName);
   if (skillData.error) {
-    return {
-      skill: { name: skillName, description: "", url: "", project },
-      files: [],
-      error: skillData.message || skillData.error
-    };
+    const ghResult = await getSkillFromGitHub(project, skillName);
+    if (ghResult.status !== "ok" || !ghResult.skill) {
+      return {
+        skill: { name: skillName, description: "", url: "", project },
+        files: [],
+        error: skillData.message || skillData.error
+      };
+    }
+    const { files: files2, error: error2 } = await downloadSkillFromGitHub(ghResult.skill);
+    if (error2) {
+      return { skill: ghResult.skill, files: [], error: error2 };
+    }
+    return { skill: ghResult.skill, files: files2 };
   }
   const skill = {
     name: skillData.name,
@@ -511,6 +623,9 @@ var DEFAULT_CONFIG = {
 
 // src/utils/ide.ts
 function getSelectedIdes(options) {
+  if (options.allAgents) {
+    return ["universal", ...VENDOR_SPECIFIC_AGENTS];
+  }
   const ides = [];
   if (options.claude) ides.push("claude");
   if (options.cursor) ides.push("cursor");
@@ -519,7 +634,7 @@ function getSelectedIdes(options) {
   return ides;
 }
 function hasExplicitIdeOption(options) {
-  return !!(options.claude || options.cursor || options.universal || options.antigravity);
+  return !!(options.allAgents || options.claude || options.cursor || options.universal || options.antigravity);
 }
 async function detectVendorSpecificAgents(scope) {
   const baseDir = scope === "global" ? homedir() : process.cwd();
@@ -1775,7 +1890,7 @@ function logInstallSummary(targets, targetDirs, skillNames) {
 function registerSkillCommands(program2) {
   const skill = program2.command("skills").alias("skill").description("Manage AI coding skills");
   registerGenerateCommand(skill);
-  skill.command("install").alias("i").alias("add").argument("<repository>", "GitHub repository (/owner/repo)").argument("[skill]", "Specific skill name to install").option("--all", "Install all skills without prompting").option("--global", "Install globally instead of current directory").option("--claude", "Claude Code (.claude/skills/)").option("--cursor", "Cursor (.cursor/skills/)").option("--universal", "Universal (.agents/skills/)").option("--antigravity", "Antigravity (.agent/skills/)").description("Install skills from a repository").action(async (project, skillName, options) => {
+  skill.command("install").alias("i").alias("add").argument("<repository>", "GitHub repository (/owner/repo)").argument("[skill]", "Specific skill name to install").option("--all", "Install all skills without prompting").option("--all-agents", "Install to all supported agent locations").option("-y, --yes", "Skip confirmation prompts").option("--global", "Install globally instead of current directory").option("--claude", "Claude Code (.claude/skills/)").option("--cursor", "Cursor (.cursor/skills/)").option("--universal", "Universal (.agents/skills/)").option("--antigravity", "Antigravity (.agent/skills/)").description("Install skills from a repository").action(async (project, skillName, options) => {
     await installCommand(project, skillName, options);
   });
   skill.command("search").alias("s").argument("<keywords...>", "Search keywords").description("Search for skills across all indexed repositories").action(async (keywords) => {
@@ -1795,7 +1910,7 @@ function registerSkillCommands(program2) {
   });
 }
 function registerSkillAliases(program2) {
-  program2.command("si", { hidden: true }).argument("<repository>", "GitHub repository (/owner/repo)").argument("[skill]", "Specific skill name to install").option("--all", "Install all skills without prompting").option("--global", "Install globally instead of current directory").option("--claude", "Claude Code (.claude/skills/)").option("--cursor", "Cursor (.cursor/skills/)").option("--universal", "Universal (.agents/skills/)").option("--antigravity", "Antigravity (.agent/skills/)").description("Install skills (alias for: skills install)").action(async (project, skillName, options) => {
+  program2.command("si", { hidden: true }).argument("<repository>", "GitHub repository (/owner/repo)").argument("[skill]", "Specific skill name to install").option("--all", "Install all skills without prompting").option("--all-agents", "Install to all supported agent locations").option("-y, --yes", "Skip confirmation prompts").option("--global", "Install globally instead of current directory").option("--claude", "Claude Code (.claude/skills/)").option("--cursor", "Cursor (.cursor/skills/)").option("--universal", "Universal (.agents/skills/)").option("--antigravity", "Antigravity (.agent/skills/)").description("Install skills (alias for: skills install)").action(async (project, skillName, options) => {
     await installCommand(project, skillName, options);
   });
   program2.command("ss", { hidden: true }).argument("<keywords...>", "Search keywords").description("Search for skills (alias for: skills search)").action(async (keywords) => {
@@ -1826,23 +1941,45 @@ async function installCommand(input2, skillName, options) {
       if (skillData.error === "prompt_injection_detected") {
         spinner.fail(pc7.red(`Prompt injection detected in skill: ${skillName}`));
         log.warn("This skill contains potentially malicious content and cannot be installed.");
-      } else {
+        return;
+      }
+      spinner.text = `Fetching skill from GitHub: ${skillName}...`;
+      const ghResult = await getSkillFromGitHub(repo, skillName);
+      if (ghResult.status === "repo_not_found") {
+        spinner.fail(pc7.red(`Repository not found: ${repo}`));
+        return;
+      }
+      if (ghResult.status !== "ok" || !ghResult.skill) {
         spinner.fail(pc7.red(`Skill not found: ${skillName}`));
+        return;
       }
-      return;
+      spinner.succeed(`Found skill: ${skillName}`);
+      selectedSkills = [ghResult.skill];
+    } else {
+      spinner.succeed(`Found skill: ${skillName}`);
+      selectedSkills = [
+        {
+          name: skillData.name,
+          description: skillData.description,
+          url: skillData.url,
+          project: repo
+        }
+      ];
     }
-    spinner.succeed(`Found skill: ${skillName}`);
-    selectedSkills = [
-      {
-        name: skillData.name,
-        description: skillData.description,
-        url: skillData.url,
-        project: repo
-      }
-    ];
   } else {
-    const data = await listProjectSkills(repo);
-    if (data.error) {
+    let data = await listProjectSkills(repo);
+    if ((data.error || !data.skills || data.skills.length === 0) && !data.blockedSkillsCount) {
+      spinner.text = `Fetching skills from GitHub...`;
+      const ghResult = await listSkillsFromGitHub(repo);
+      if (ghResult.status === "repo_not_found") {
+        spinner.fail(pc7.red(`Repository not found: ${repo}`));
+        return;
+      }
+      if (ghResult.status === "ok" && ghResult.skills.length > 0) {
+        data = { project: repo, skills: ghResult.skills };
+      }
+    }
+    if (data.error && (!data.skills || data.skills.length === 0)) {
       spinner.fail(pc7.red(`Error: ${data.message || data.error}`));
       return;
     }
@@ -2438,7 +2575,8 @@ var SETUP_AGENT_NAMES = {
   claude: "Claude Code",
   cursor: "Cursor",
   opencode: "OpenCode",
-  codex: "Codex"
+  codex: "Codex",
+  gemini: "Gemini CLI"
 };
 var AUTH_MODE_LABELS = {
   oauth: "OAuth",
@@ -2557,6 +2695,29 @@ var agents = {
       projectPaths: [".codex"],
       globalPaths: [join8(homedir5(), ".codex")]
     }
+  },
+  gemini: {
+    name: "gemini",
+    displayName: "Gemini CLI",
+    mcp: {
+      projectPaths: [join8(".gemini", "settings.json")],
+      globalPaths: [join8(homedir5(), ".gemini", "settings.json")],
+      configKey: "mcpServers",
+      buildEntry: (auth) => withHeaders({ httpUrl: mcpUrl(auth) }, auth)
+    },
+    rule: {
+      kind: "append",
+      file: (scope) => scope === "global" ? join8(homedir5(), ".gemini", "GEMINI.md") : "GEMINI.md",
+      sectionMarker: "<!-- context7 -->"
+    },
+    skill: {
+      name: "context7-mcp",
+      dir: (scope) => scope === "global" ? join8(homedir5(), ".gemini", "skills") : join8(".gemini", "skills")
+    },
+    detect: {
+      projectPaths: [".gemini"],
+      globalPaths: [join8(homedir5(), ".gemini")]
+    }
   }
 };
 function getAgent(name) {
@@ -2597,7 +2758,7 @@ Do not use for: refactoring, writing scripts from scratch, debugging business lo
 
 ## Steps
 
-1. \`resolve-library-id\` with the library name and the user's question
+1. \`resolve-library-id\` with the library name and the user's question. Use the official library name with proper punctuation (e.g., "Next.js" not "nextjs", "Customer.io" not "customerio", "Three.js" not "threejs")
 2. Pick the best match by: exact name match, description relevance, code snippet count, source reputation (High/Medium preferred), and benchmark score (higher is better). Use version-specific IDs when the user mentions a version
 3. \`query-docs\` with the selected library ID and the user's full question (not single words)
 4. Answer using the fetched docs
@@ -2775,10 +2936,11 @@ function getSelectedAgents(options) {
   if (options.cursor) agents2.push("cursor");
   if (options.opencode) agents2.push("opencode");
   if (options.codex) agents2.push("codex");
+  if (options.gemini) agents2.push("gemini");
   return agents2;
 }
 function registerSetupCommand(program2) {
-  program2.command("setup").description("Set up Context7 for your AI coding agent").option("--claude", "Set up for Claude Code").option("--cursor", "Set up for Cursor").option("--universal", "Set up for Universal (.agents/skills)").option("--antigravity", "Set up for Antigravity (.agent/skills)").option("--opencode", "Set up for OpenCode").option("--codex", "Set up for Codex").option("--mcp", "Set up MCP server mode").option("--cli", "Set up CLI + Skills mode (no MCP server)").option("-p, --project", "Configure for current project instead of globally").option("-y, --yes", "Skip confirmation prompts").option("--api-key <key>", "Use API key authentication").option("--oauth", "Use OAuth endpoint (IDE handles auth flow)").action(async (options) => {
+  program2.command("setup").description("Set up Context7 for your AI coding agent").option("--claude", "Set up for Claude Code").option("--cursor", "Set up for Cursor").option("--universal", "Set up for Universal (.agents/skills)").option("--antigravity", "Set up for Antigravity (.agent/skills)").option("--opencode", "Set up for OpenCode").option("--codex", "Set up for Codex").option("--gemini", "Set up for Gemini CLI").option("--mcp", "Set up MCP server mode").option("--cli", "Set up CLI + Skills mode (no MCP server)").option("-p, --project", "Configure for current project instead of globally").option("-y, --yes", "Skip confirmation prompts").option("--api-key <key>", "Use API key authentication").option("--oauth", "Use OAuth endpoint (IDE handles auth flow)").action(async (options) => {
     await setupCommand(options);
   });
 }
@@ -3007,6 +3169,11 @@ async function setupMcp(agents2, options, scope) {
     const skillIcon = r.skillStatus === "installed" ? pc8.green("+") : pc8.dim("~");
     log.plain(`    ${skillIcon} Skill ${r.skillStatus}`);
     log.plain(`      ${pc8.dim(r.skillPath)}`);
+    if (r.skillStatus.includes("EACCES")) {
+      log.plain(
+        `      ${pc8.yellow("tip:")} fix permissions with: ${pc8.cyan(`sudo chown -R $(whoami) ${dirname5(dirname5(r.skillPath))}`)}`
+      );
+    }
   }
   log.blank();
   trackEvent("setup", { agents: agents2, scope, authMode: auth.mode });
@@ -3062,6 +3229,11 @@ async function setupCli(options) {
     const skillIcon = r.skillStatus === "installed" ? pc8.green("+") : pc8.dim("~");
     log.plain(`    ${skillIcon} Skill ${r.skillStatus}`);
     log.plain(`      ${pc8.dim(r.skillPath)}`);
+    if (r.skillStatus.includes("EACCES")) {
+      log.plain(
+        `      ${pc8.yellow("tip:")} fix permissions with: ${pc8.cyan(`sudo chown -R $(whoami) ${dirname5(dirname5(r.skillPath))}`)}`
+      );
+    }
     const ruleIcon = r.ruleStatus === "installed" || r.ruleStatus === "updated" ? pc8.green("+") : pc8.dim("~");
     log.plain(`    ${ruleIcon} Rule ${r.ruleStatus}`);
     log.plain(`      ${pc8.dim(r.rulePath)}`);