ctx7 0.4.4 → 0.5.0

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

@@ -1155,17 +1155,88 @@ function buildAuthorizationUrl(baseUrl3, clientId, redirectUri, codeChallenge, s
   url.searchParams.set("response_type", "code");
   return url.toString();
 }
+var DEVICE_CODE_GRANT = "urn:ietf:params:oauth:grant-type:device_code";
+var DEFAULT_DEVICE_POLL_INTERVAL_SECONDS = 5;
+function shouldUseDeviceFlow() {
+  if (process.env.SSH_CONNECTION || process.env.SSH_CLIENT || process.env.SSH_TTY) return true;
+  if (process.platform === "linux" && !process.env.DISPLAY && !process.env.WAYLAND_DISPLAY) {
+    return true;
+  }
+  return false;
+}
+async function startDeviceAuthorization(baseUrl3, clientId) {
+  const params = new URLSearchParams({ client_id: clientId });
+  try {
+    const hostname2 = os.hostname();
+    if (hostname2) params.set("hostname", hostname2);
+  } catch {
+  }
+  const response = await fetch(`${baseUrl3}/api/oauth/device/code`, {
+    method: "POST",
+    headers: { "Content-Type": "application/x-www-form-urlencoded" },
+    body: params.toString()
+  });
+  if (!response.ok) {
+    const err = await response.json().catch(() => ({}));
+    throw new Error(err.error_description || err.error || "Failed to start device authorization");
+  }
+  return await response.json();
+}
+async function pollDeviceToken(baseUrl3, clientId, deviceCode) {
+  let response;
+  try {
+    response = await fetch(`${baseUrl3}/api/oauth/device/token`, {
+      method: "POST",
+      headers: { "Content-Type": "application/x-www-form-urlencoded" },
+      body: new URLSearchParams({
+        grant_type: DEVICE_CODE_GRANT,
+        device_code: deviceCode,
+        client_id: clientId
+      }).toString()
+    });
+  } catch (error) {
+    return {
+      status: "transient",
+      errorMessage: error instanceof Error ? error.message : "network error"
+    };
+  }
+  if (response.ok) {
+    const tokens = await response.json();
+    return { status: "approved", tokens };
+  }
+  if (response.status >= 500) {
+    const err2 = await response.json().catch(() => ({}));
+    return {
+      status: "transient",
+      errorMessage: err2.error_description || err2.error || `HTTP ${response.status}`
+    };
+  }
+  const err = await response.json().catch(() => ({}));
+  switch (err.error) {
+    case "authorization_pending":
+      return { status: "pending" };
+    case "slow_down":
+      return { status: "slow_down" };
+    case "access_denied":
+      return { status: "denied" };
+    case "expired_token":
+      return { status: "expired" };
+    default:
+      throw new Error(err.error_description || err.error || "Device token poll failed");
+  }
+}
 
 // src/commands/auth.ts
 import pc4 from "picocolors";
 import ora from "ora";
 import open from "open";
+import boxen from "boxen";
 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) => {
+  program2.command("login").description("Log in to Context7").option("--no-browser", "Don't open browser automatically").option("--device", "Force device-code flow (use on SSH / headless hosts)").action(async (options) => {
     await loginCommand(options);
   });
   program2.command("logout").description("Log out of Context7").action(() => {
@@ -1175,7 +1246,131 @@ function registerAuthCommands(program2) {
     await whoamiCommand();
   });
 }
-async function performLogin(openBrowser = true) {
+function renderDeviceCodeBox(userCode, verificationUri, verificationUriComplete) {
+  const codeLine = `${pc4.dim("Your one-time code:")}
+
+    ${pc4.green(pc4.bold(userCode))}`;
+  const linkLine = verificationUriComplete ? `${pc4.dim("Open this link to approve:")}
+${pc4.cyan(verificationUriComplete)}
+
+${pc4.dim("Or visit")} ${pc4.cyan(verificationUri)} ${pc4.dim("and enter the code above.")}` : `${pc4.dim("Visit:")} ${pc4.cyan(verificationUri)}`;
+  return boxen(`${codeLine}
+
+${linkLine}`, {
+    title: "Sign in to Context7",
+    titleAlignment: "left",
+    padding: 1,
+    margin: { top: 1, bottom: 1, left: 2, right: 2 },
+    borderStyle: "round",
+    borderColor: "gray"
+  });
+}
+function waitForEnter(prompt) {
+  if (!process.stdin.isTTY) return Promise.resolve();
+  return new Promise((resolve3) => {
+    process.stdout.write(`  ${pc4.dim(prompt)} `);
+    const onData = (chunk) => {
+      if (chunk[0] === 3) {
+        process.stdin.removeListener("data", onData);
+        process.stdin.setRawMode?.(false);
+        process.stdin.pause();
+        process.stdout.write("\n");
+        process.exit(130);
+      }
+      process.stdin.removeListener("data", onData);
+      process.stdin.setRawMode?.(false);
+      process.stdin.pause();
+      process.stdout.write("\n");
+      resolve3();
+    };
+    process.stdin.setRawMode?.(true);
+    process.stdin.resume();
+    process.stdin.on("data", onData);
+  });
+}
+async function announceIdentity(accessToken) {
+  try {
+    const whoami = await fetchWhoami(accessToken);
+    const name = whoami.email || whoami.name;
+    if (!name) return "Login successful!";
+    const team = whoami.teamspace?.name;
+    return team ? `Logged in as ${pc4.bold(name)} ${pc4.dim(`(${team})`)}` : `Logged in as ${pc4.bold(name)}`;
+  } catch {
+    return "Login successful!";
+  }
+}
+async function performDeviceLogin(openBrowser = true) {
+  const spinner = ora("Preparing login...").start();
+  let authorization;
+  try {
+    authorization = await startDeviceAuthorization(baseUrl2, CLI_CLIENT_ID);
+  } catch (error) {
+    spinner.fail(pc4.red("Login failed"));
+    if (error instanceof Error) console.error(pc4.red(error.message));
+    return null;
+  }
+  spinner.stop();
+  console.log(
+    renderDeviceCodeBox(
+      authorization.user_code,
+      authorization.verification_uri,
+      authorization.verification_uri_complete
+    )
+  );
+  const target = authorization.verification_uri_complete ?? authorization.verification_uri;
+  if (openBrowser) {
+    await waitForEnter("Press Enter to open the browser, or Ctrl-C to quit...");
+    try {
+      await open(target);
+    } catch {
+      console.log(pc4.dim(`  Couldn't open a browser \u2014 visit the link above manually.`));
+    }
+  } else {
+    console.log(pc4.dim("  Open the link above in any browser to continue."));
+    console.log("");
+  }
+  const waitingSpinner = ora({ text: "Waiting for authorization...", indent: 2 }).start();
+  const deadline = Date.now() + authorization.expires_in * 1e3;
+  let intervalMs = (authorization.interval ?? DEFAULT_DEVICE_POLL_INTERVAL_SECONDS) * 1e3;
+  while (Date.now() < deadline) {
+    await new Promise((resolve3) => setTimeout(resolve3, intervalMs));
+    try {
+      const result = await pollDeviceToken(baseUrl2, CLI_CLIENT_ID, authorization.device_code);
+      if (result.status === "approved" && result.tokens) {
+        saveTokens(result.tokens);
+        const successText = await announceIdentity(result.tokens.access_token);
+        waitingSpinner.succeed(pc4.green(successText));
+        return result.tokens.access_token;
+      }
+      if (result.status === "slow_down") {
+        intervalMs += 5e3;
+        continue;
+      }
+      if (result.status === "denied") {
+        waitingSpinner.fail(pc4.red("Authorization denied."));
+        return null;
+      }
+      if (result.status === "expired") {
+        waitingSpinner.fail(pc4.red("Code expired. Run login again."));
+        return null;
+      }
+      if (result.status === "transient") {
+        intervalMs += 5e3;
+        continue;
+      }
+    } catch (error) {
+      waitingSpinner.fail(pc4.red("Login failed"));
+      if (error instanceof Error) console.error(pc4.red(error.message));
+      return null;
+    }
+  }
+  waitingSpinner.fail(pc4.red("Code expired without approval."));
+  return null;
+}
+async function performLogin(openBrowser = true, forceDevice = false) {
+  if (forceDevice || shouldUseDeviceFlow()) {
+    return performDeviceLogin(openBrowser);
+  }
   const spinner = ora("Preparing login...").start();
   try {
     const { codeVerifier, codeChallenge } = generatePKCE();
@@ -1242,7 +1437,7 @@ async function loginCommand(options) {
     return;
   }
   clearTokens();
-  const token = await performLogin(options.browser);
+  const token = await performLogin(options.browser, options.device ?? false);
   if (!token) {
     process.exit(1);
   }
@@ -1911,6 +2106,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 +2134,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 +2159,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 +2258,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 +2409,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 +2714,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 +2848,7 @@ var SETUP_AGENT_NAMES = {
   cursor: "Cursor",
   opencode: "OpenCode",
   codex: "Codex",
+  antigravity: "Antigravity",
   gemini: "Gemini CLI"
 };
 var AUTH_MODE_LABELS = {
@@ -2789,6 +2987,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 +3412,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 +3458,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 +3569,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 +3771,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 +3781,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 +3833,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 +3862,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 +3950,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 +4595,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 +4610,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 +4624,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 +4637,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();