ctx7 0.4.4 → 0.4.5

package/README.md

@@ -1,8 +1,6 @@
 # ctx7
 
-CLI for [Context7](https://context7.com) - query up-to-date library documentation and manage AI coding skills.
-
-Skills are reusable prompt instructions that enhance your AI coding assistant with specialized capabilities like working with specific frameworks, libraries, or coding patterns.
+CLI for [Context7](https://context7.com) - query up-to-date library documentation and configure Context7 for AI coding agents.
 
 ## Installation
 
@@ -41,22 +39,6 @@ ctx7 docs /facebook/react "useEffect cleanup"
 ctx7 docs /vercel/next.js "middleware"
 ```
 
-### Skills
-
-```bash
-# Search for skills
-ctx7 skills search pdf
-
-# Install a skill
-ctx7 skills install /anthropics/skills pdf
-
-# Generate a custom skill with AI
-ctx7 skills generate
-
-# List installed skills
-ctx7 skills list --claude
-```
-
 ## Usage
 
 ### Find a library
@@ -133,42 +115,9 @@ ctx7 remove --claude --mcp
 
 If you installed the CLI itself globally with `npm install -g ctx7`, remove that separately with `npm uninstall -g ctx7`. If you use `npx ctx7`, there is no permanent CLI install to remove.
 
-### Generate skills
-
-Generate custom skills tailored to your use case using AI. Requires authentication.
-
-```bash
-# Log in first
-ctx7 login
-
-# Generate a skill (interactive)
-ctx7 skills generate
-
-# Short aliases
-ctx7 skills gen
-ctx7 skills g
-
-# Generate and install to a specific client
-ctx7 skills generate --cursor
-ctx7 skills generate --claude
-ctx7 skills generate --universal
-
-# Generate globally
-ctx7 skills generate --global
-```
-
-The generate flow:
-
-1. Describe the expertise you want (e.g., "OAuth authentication with NextAuth.js")
-2. Select relevant libraries from search results
-3. Answer 3 clarifying questions to focus the skill
-4. Review the generated skill, request changes if needed, then install
-
-Weekly generation limits apply: free accounts get 6 generations/week, Pro accounts get 10.
-
 ### Authentication
 
-Log in to access skill generation and other authenticated features.
+Log in to access authenticated setup and higher documentation rate limits.
 
 ```bash
 # Log in (opens browser for OAuth)
@@ -181,79 +130,9 @@ ctx7 whoami
 ctx7 logout
 ```
 
-### Install skills
-
-Install skills from a project repository to your AI coding assistant's skills directory.
-
-```bash
-# Install all skills from a project (interactive selection)
-ctx7 skills install /anthropics/skills
-
-# Install a specific skill
-ctx7 skills install /anthropics/skills pdf
-
-# Install multiple skills at once
-ctx7 skills install /anthropics/skills pdf commit
-
-# Install to a specific client
-ctx7 skills install /anthropics/skills pdf --cursor
-ctx7 skills install /anthropics/skills pdf --claude
-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
-
-Find skills across all indexed projects in the registry.
-
-```bash
-ctx7 skills search pdf
-ctx7 skills search typescript
-ctx7 skills search react testing
-```
-
-### List installed skills
-
-View skills installed in your project or globally.
-
-```bash
-ctx7 skills list
-ctx7 skills list --claude
-ctx7 skills list --cursor
-ctx7 skills list --universal
-ctx7 skills list --global
-```
-
-### Show skill information
-
-Get details about available skills in a project.
-
-```bash
-ctx7 skills info /anthropics/skills
-```
-
-### Remove a skill
-
-Uninstall a skill from your project.
-
-```bash
-ctx7 skills remove pdf
-ctx7 skills remove pdf --claude
-ctx7 skills remove pdf --universal
-ctx7 skills remove pdf --global
-```
-
 ## Supported Clients
 
-The CLI automatically detects which AI coding assistants you have installed and offers to install skills for them:
+The CLI automatically detects which AI coding assistants you have installed and configures Context7 for them:
 
 | Client                                                              | Skills Directory  |
 | ------------------------------------------------------------------- | ----------------- |
@@ -262,24 +141,13 @@ The CLI automatically detects which AI coding assistants you have installed and
 | Cursor                                                              | `.cursor/skills/` |
 | Antigravity                                                         | `.agent/skills/`  |
 
-## Shortcuts
-
-For faster usage, the CLI provides short aliases:
-
-```bash
-ctx7 si /anthropics/skills pdf   # skills install
-ctx7 ss pdf                       # skills search
-ctx7 skills gen                   # skills generate
-ctx7 skills g                     # skills generate
-```
-
 ## Disabling Telemetry
 
 The CLI collects anonymous usage data to help improve the product. To disable telemetry, set the `CTX7_TELEMETRY_DISABLED` environment variable:
 
 ```bash
 # For a single command
-CTX7_TELEMETRY_DISABLED=1 ctx7 skills search pdf
+CTX7_TELEMETRY_DISABLED=1 ctx7 docs /facebook/react "useEffect examples"
 
 # Or export in your shell profile (~/.bashrc, ~/.zshrc, etc.)
 export CTX7_TELEMETRY_DISABLED=1
@@ -287,4 +155,4 @@ export CTX7_TELEMETRY_DISABLED=1
 
 ## Learn More
 
-Visit [context7.com](https://context7.com) to browse the skills registry and discover available skills.
+Visit [context7.com](https://context7.com) for documentation lookup and setup guides.

package/dist/index.js

@@ -1911,6 +1911,11 @@ async function detectProjectDependencies(cwd) {
 }
 
 // src/commands/skill.ts
+var SKILL_HUB_DEPRECATION_WARNING = "Warning: Skill commands are deprecated and will stop working in the next major release.";
+function warnSkillHubDeprecated() {
+  console.error(pc7.yellow(SKILL_HUB_DEPRECATION_WARNING));
+  console.error("");
+}
 function logInstallSummary(targets, targetDirs, skillNames) {
   log.blank();
   const hasUniversal = targets.ides.some((ide) => ide === "universal");
@@ -1934,7 +1939,9 @@ function logInstallSummary(targets, targetDirs, skillNames) {
   log.blank();
 }
 function registerSkillCommands(program2) {
-  const skill = program2.command("skills").alias("skill").description("Manage AI coding skills");
+  const skill = program2.command("skills", { hidden: true }).alias("skill").description("Manage AI coding skills").hook("preAction", () => {
+    warnSkillHubDeprecated();
+  });
   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("--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);
@@ -1957,12 +1964,15 @@ 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("--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) => {
+    warnSkillHubDeprecated();
     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) => {
+    warnSkillHubDeprecated();
     await searchCommand(keywords.join(" "));
   });
   program2.command("ssg", { hidden: true }).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("Suggest skills (alias for: skills suggest)").action(async (options) => {
+    warnSkillHubDeprecated();
     await suggestCommand(options);
   });
 }
@@ -2053,7 +2063,7 @@ async function installCommand(input2, skillName, options) {
         const paddedName = s.name.padEnd(maxNameLen);
         const popularity = formatPopularity(s.installCount) + " ".repeat(popularityColWidth - 4);
         const trust = formatTrust(s.trustScore);
-        const skillUrl = `https://context7.com/skills${s.project}/${s.name}`;
+        const skillUrl = s.url || `https://github.com${s.project}`;
         const skillLink = terminalLink(s.name, skillUrl, pc7.white);
         const repoLink = terminalLink(s.project, `https://github.com${s.project}`, pc7.white);
         const metadataLines = [
@@ -2204,11 +2214,7 @@ async function searchCommand(query) {
     const displayName = nameWithRepo(s) + " ".repeat(maxNameLen - rawLen);
     const popularity = formatPopularity(s.installCount) + " ".repeat(popularityColWidth - 4);
     const trust = formatTrust(s.trustScore);
-    const skillLink = terminalLink(
-      s.name,
-      `https://context7.com/skills${s.project}/${s.name}`,
-      pc7.white
-    );
+    const skillLink = terminalLink(s.name, s.url || `https://github.com${s.project}`, pc7.white);
     const repoLink = terminalLink(s.project, `https://github.com${s.project}`, pc7.white);
     const metadataLines = [
       pc7.dim("\u2500".repeat(50)),
@@ -2513,11 +2519,7 @@ async function suggestCommand(options) {
     const trustLabel = getTrustLabel(s.trustScore);
     const trust = formatTrust(s.trustScore) + " ".repeat(trustColWidth - trustLabel.length);
     const matched = pc7.yellow(s.matchedDep.padEnd(maxMatchedLen));
-    const skillLink = terminalLink(
-      s.name,
-      `https://context7.com/skills${s.project}/${s.name}`,
-      pc7.white
-    );
+    const skillLink = terminalLink(s.name, s.url || `https://github.com${s.project}`, pc7.white);
     const repoLink = terminalLink(s.project, `https://github.com${s.project}`, pc7.white);
     const metadataLines = [
       pc7.dim("\u2500".repeat(50)),
@@ -2651,6 +2653,7 @@ var SETUP_AGENT_NAMES = {
   cursor: "Cursor",
   opencode: "OpenCode",
   codex: "Codex",
+  antigravity: "Antigravity",
   gemini: "Gemini CLI"
 };
 var AUTH_MODE_LABELS = {
@@ -2789,6 +2792,33 @@ var agents = {
       globalPaths: [join7(homedir5(), ".codex")]
     }
   },
+  // Antigravity is built on Gemini infrastructure and shares ~/.gemini/. Per
+  // the official Codelabs guide, Antigravity 2.0/IDE/CLI read MCP servers from
+  // ~/.gemini/config/mcp_config.json globally; there is no project-level MCP
+  // config, so projectPaths is empty and setupAgent falls back to global.
+  antigravity: {
+    name: "antigravity",
+    displayName: "Antigravity",
+    mcp: {
+      projectPaths: [],
+      globalPaths: [join7(homedir5(), ".gemini", "config", "mcp_config.json")],
+      configKey: "mcpServers",
+      buildEntry: (auth, transport) => transport === "stdio" ? stdioEntry(auth) : withHeaders({ serverUrl: mcpUrl(auth) }, auth)
+    },
+    rule: {
+      kind: "append",
+      file: (scope) => scope === "global" ? join7(homedir5(), ".gemini", "GEMINI.md") : "GEMINI.md",
+      sectionMarker: "<!-- context7 -->"
+    },
+    skill: {
+      name: "context7-mcp",
+      dir: (scope) => scope === "global" ? join7(homedir5(), ".agent", "skills") : join7(".agent", "skills")
+    },
+    detect: {
+      projectPaths: [".agent"],
+      globalPaths: [join7(homedir5(), ".gemini", "antigravity"), join7(homedir5(), ".agent")]
+    }
+  },
   gemini: {
     name: "gemini",
     displayName: "Gemini CLI",
@@ -3187,11 +3217,12 @@ function getSelectedAgents(options) {
   if (options.cursor) agents2.push("cursor");
   if (options.opencode) agents2.push("opencode");
   if (options.codex) agents2.push("codex");
+  if (options.antigravity) agents2.push("antigravity");
   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("--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)").option("--stdio", "Configure the MCP server as a local stdio process (default: HTTP)").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("--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)").option("--stdio", "Configure the MCP server as a local stdio process (default: HTTP)").action(async (options) => {
     await setupCommand(options);
   });
 }
@@ -3232,7 +3263,7 @@ async function resolveAuth(options) {
 }
 async function resolveMode(options) {
   if (options.cli) return "cli";
-  if (options.mcp || options.yes || options.oauth || options.apiKey || options.stdio) return "mcp";
+  if (options.mcp || options.yes || options.oauth || options.stdio) return "mcp";
   return select3({
     message: "How should your agent access Context7?",
     choices: [
@@ -3343,7 +3374,7 @@ function resolveEntryToWrite(agent, auth, transport, existingEntry) {
 }
 async function setupAgent(agentName, auth, transport, scope) {
   const agent = getAgent(agentName);
-  const mcpCandidates = scope === "global" ? agent.mcp.globalPaths : agent.mcp.projectPaths.map((p) => join8(process.cwd(), p));
+  const mcpCandidates = scope === "global" || agent.mcp.projectPaths.length === 0 ? agent.mcp.globalPaths : agent.mcp.projectPaths.map((p) => join8(process.cwd(), p));
   const mcpPath = await resolveMcpPath(mcpCandidates);
   let mcpStatus;
   try {
@@ -3545,7 +3576,7 @@ var MODE_LABELS = {
   cli: "CLI + Skills"
 };
 function registerRemoveCommand(program2) {
-  program2.command("remove").alias("uninstall").description("Remove Context7 setup from your AI coding agent").option("--claude", "Remove from Claude Code").option("--cursor", "Remove from Cursor").option("--opencode", "Remove from OpenCode").option("--codex", "Remove from Codex").option("--gemini", "Remove from Gemini CLI").option("--all", "Remove both MCP setup and CLI + Skills setup").option("--mcp", "Remove MCP setup").option("--cli", "Remove CLI + Skills setup").option("-p, --project", "Remove from the current project instead of global config").option("-y, --yes", "Skip confirmation prompts").action(async (options) => {
+  program2.command("remove").alias("uninstall").description("Remove Context7 setup from your AI coding agent").option("--claude", "Remove from Claude Code").option("--cursor", "Remove from Cursor").option("--opencode", "Remove from OpenCode").option("--codex", "Remove from Codex").option("--antigravity", "Remove from Antigravity").option("--gemini", "Remove from Gemini CLI").option("--all", "Remove both MCP setup and CLI + Skills setup").option("--mcp", "Remove MCP setup").option("--cli", "Remove CLI + Skills setup").option("-p, --project", "Remove from the current project instead of global config").option("-y, --yes", "Skip confirmation prompts").action(async (options) => {
     await removeCommand2(options);
   });
 }
@@ -3555,6 +3586,7 @@ function getSelectedAgents2(options) {
   if (options.cursor) agents2.push("cursor");
   if (options.opencode) agents2.push("opencode");
   if (options.codex) agents2.push("codex");
+  if (options.antigravity) agents2.push("antigravity");
   if (options.gemini) agents2.push("gemini");
   return agents2;
 }
@@ -3606,7 +3638,7 @@ async function resolveAgents2(options, scope) {
   if (detected.length > 0 && options.yes) return detected;
   if (detected.length === 0) {
     log.warn(
-      "No Context7 setup detected. Pass --claude, --cursor, --opencode, --codex, or --gemini."
+      "No Context7 setup detected. Pass --claude, --cursor, --opencode, --codex, --antigravity, or --gemini."
     );
     return [];
   }
@@ -3635,6 +3667,7 @@ async function pathExists2(path2) {
 }
 async function hasMcpConfig(agentName, scope) {
   const agent = getAgent(agentName);
+  if (scope === "project" && agent.mcp.projectPaths.length === 0) return false;
   const candidates = scope === "global" ? agent.mcp.globalPaths : agent.mcp.projectPaths.map((path2) => join9(process.cwd(), path2));
   const mcpPath = await resolveMcpPath(candidates);
   if (mcpPath.endsWith(".toml")) {
@@ -3722,6 +3755,9 @@ async function resolveModes(options, agents2, scope) {
 }
 async function uninstallMcp(agentName, scope) {
   const agent = getAgent(agentName);
+  if (scope === "project" && agent.mcp.projectPaths.length === 0) {
+    return { status: "not found", path: "" };
+  }
   const mcpCandidates = scope === "global" ? agent.mcp.globalPaths : agent.mcp.projectPaths.map((path2) => join9(process.cwd(), path2));
   const mcpPath = await resolveMcpPath(mcpCandidates);
   try {
@@ -4364,7 +4400,7 @@ var brand = {
   dim: pc12.dim
 };
 var program = new Command();
-program.name("ctx7").description("Context7 CLI - Manage AI coding skills and documentation context").version(VERSION).option("--base-url <url>").hook("preAction", (thisCommand) => {
+program.name("ctx7").description("Context7 CLI - Fetch documentation context and configure Context7").version(VERSION).option("--base-url <url>").hook("preAction", (thisCommand) => {
   const opts = thisCommand.opts();
   if (opts.baseUrl) {
     setBaseUrl(opts.baseUrl);
@@ -4379,21 +4415,10 @@ program.name("ctx7").description("Context7 CLI - Manage AI coding skills and doc
   "after",
   `
 Examples:
-  ${brand.dim("# Search for skills")}
-  ${brand.primary("npx ctx7 skills search pdf")}
-  ${brand.primary("npx ctx7 skills search react hooks")}
-
-  ${brand.dim("# Install from a repository")}
-  ${brand.primary("npx ctx7 skills install /anthropics/skills")}
-  ${brand.primary("npx ctx7 skills install /anthropics/skills pdf")}
-
-  ${brand.dim("# Install to specific client")}
-  ${brand.primary("npx ctx7 skills install /anthropics/skills --cursor")}
-  ${brand.primary("npx ctx7 skills install /anthropics/skills --global")}
-
-  ${brand.dim("# List and manage installed skills")}
-  ${brand.primary("npx ctx7 skills list --claude")}
-  ${brand.primary("npx ctx7 skills remove pdf")}
+  ${brand.dim("# Configure Context7 for your coding agent")}
+  ${brand.primary("npx ctx7 setup")}
+  ${brand.primary("npx ctx7 setup --mcp")}
+  ${brand.primary("npx ctx7 setup --cli")}
 
   ${brand.dim("# Remove Context7 setup")}
   ${brand.primary("npx ctx7 remove --cursor")}
@@ -4404,8 +4429,6 @@ Examples:
   ${brand.dim("# Query library documentation")}
   ${brand.primary('npx ctx7 library react "how to use hooks"')}
   ${brand.primary('npx ctx7 docs /facebook/react "useEffect examples"')}
-
-Visit ${brand.primary("https://context7.com")} to browse skills
 `
 );
 registerSkillCommands(program);
@@ -4419,14 +4442,13 @@ program.action(() => {
   console.log("");
   const banner = figlet.textSync("Context7", { font: "ANSI Shadow" });
   console.log(brand.primary(banner));
-  console.log(brand.dim("  The open agent skills ecosystem"));
+  console.log(brand.dim("  Documentation context for AI coding agents"));
   console.log("");
   console.log("  Quick start:");
-  console.log(`    ${brand.primary("npx ctx7 skills search pdf")}`);
-  console.log(`    ${brand.primary("npx ctx7 skills install /anthropics/skills")}`);
+  console.log(`    ${brand.primary("npx ctx7 setup")}`);
+  console.log(`    ${brand.primary('npx ctx7 docs /facebook/react "useEffect examples"')}`);
   console.log("");
   console.log(`  Run ${brand.primary("npx ctx7 --help")} for all commands and options`);
-  console.log(`  Visit ${brand.primary("https://context7.com")} to browse skills`);
   console.log("");
 });
 await program.parseAsync();