doc2mcp 0.1.15 → 0.1.17

package/README.md

@@ -1,6 +1,6 @@
 <div align="center">
 
-<img src="./assets/doc2mcp-cli-banner.png" alt="doc2mcp — turn any docs site into a hosted MCP server from your terminal" width="100%" />
+<img src="https://doc2mcp.site/doc2mcp-cli-banner.png" alt="doc2mcp — turn any docs site into a hosted MCP server from your terminal" width="100%" />
 
 # doc2mcp
 
@@ -13,7 +13,7 @@ Point it at a docs URL, and doc2mcp crawls, analyzes, and serves it as a token-s
 [![node](https://img.shields.io/node/v/doc2mcp?color=8b5cf6&logo=node.js)](https://nodejs.org)
 [![license](https://img.shields.io/npm/l/doc2mcp?color=8b5cf6)](https://github.com/gautammanak1/doc2mcp/blob/main/LICENSE)
 
-[Website](https://doc2mcp.site) · [Playground](https://doc2mcp.site/playground) · [Docs](https://doc2mcp.site/docs) · [CLI guide](https://doc2mcp.site/docs/cli)
+[Website](https://doc2mcp.site) · [CLI](https://doc2mcp.site/cli) · [Docs](https://doc2mcp.site/docs) · [CLI guide](https://doc2mcp.site/docs/cli)
 
 </div>
 
@@ -51,11 +51,13 @@ doc2mcp https://docs.stripe.com
 
 # 3. When it's ready, pick your editor — the MCP is installed for you
 #    ✔ Cursor   ✔ VS Code   ✔ Claude Desktop   ✔ Windsurf
+
+# 4. Chat with your docs without leaving the terminal
+doc2mcp chat
 ```
 
-That's it. The same hosted pipeline powers the [website](https://doc2mcp.site) and the
-[Playground](https://doc2mcp.site/playground), so a project you create in the CLI shows up in your
-dashboard and marketplace too.
+That's it. The same hosted pipeline powers the [website](https://doc2mcp.site), so a project you
+create in the CLI shows up in your dashboard and marketplace too.
 
 ## Commands
 
@@ -67,6 +69,7 @@ dashboard and marketplace too.
 | [`doc2mcp whoami`](#doc2mcp-whoami) | Show the account you're signed in as |
 | [`doc2mcp list`](#doc2mcp-list) | List the MCP projects on your account |
 | [`doc2mcp install <projectId>`](#doc2mcp-install-projectid) | Install an existing MCP into your editors |
+| [`doc2mcp chat [projectId]`](#doc2mcp-chat-projectid) | Chat with your docs in the terminal (AI answers from your MCP) |
 | `doc2mcp --version` | Print the installed CLI version |
 | `doc2mcp --help` | Show usage and all commands |
 
@@ -92,7 +95,7 @@ Tips:
 - Point at the **docs** URL (`https://docs.stripe.com`), not the marketing homepage.
 - The URL must start with `http://` or `https://`.
 - Conversions count against your plan's monthly limit (free includes 5/month), shared with the
-  website, Playground, and chat.
+  website and chat.
 
 ---
 
@@ -161,6 +164,29 @@ You'll be prompted to choose which detected clients to write to:
 
 Existing config is merged, not overwritten.
 
+---
+
+### `doc2mcp chat [projectId]`
+
+Chat with your docs **right from the terminal**. doc2mcp answers natural-language questions from
+the crawled documentation — with cited sources — using the project's hosted MCP (the same
+`ask_documentation` tool your editor calls). This is the Playground experience, in your shell.
+
+```bash
+# Interactive: choose a project, then ask anything
+doc2mcp chat
+
+# Skip the picker by passing a project ID
+doc2mcp chat prj_123abc
+
+# One-shot answer (handy in scripts / CI)
+doc2mcp chat prj_123abc -m "How do I authenticate requests?"
+```
+
+- With no arguments, you pick from your `ready` projects.
+- Type `/exit` (or press Esc) to leave an interactive session.
+- Each answer lists the source pages it used so you can verify it.
+
 ## Configuration
 
 | Setting | Default | Notes |
@@ -175,7 +201,7 @@ Existing config is merged, not overwritten.
 | `command not found: doc2mcp` | You installed locally or your shell cached PATH. Reinstall with `npm i -g doc2mcp`, then run `hash -r` or open a new terminal. You can also use `npx doc2mcp <url>`. |
 | Browser doesn't open on `login` | Copy the printed URL into your browser manually, then approve. |
 | `login` can't reach the server | Confirm you're online; for self-hosting set `DOC2MCP_API_URL` to your instance. |
-| "Limit reached" | You've hit your plan's monthly conversion limit (shared across CLI, web, and Playground). |
+| "Limit reached" | You've hit your plan's monthly conversion limit (shared across CLI and web). |
 | Editor doesn't pick up the MCP | Fully restart the editor after install so it reloads MCP config. |
 
 ## How it works
@@ -209,7 +235,7 @@ already exists).
 
 - 📦 npm: https://www.npmjs.com/package/doc2mcp
 - 🌐 Website: https://doc2mcp.site
-- 🕹️ Playground: https://doc2mcp.site/playground
+- 🖥️ CLI page: https://doc2mcp.site/cli
 - 📚 Docs: https://doc2mcp.site/docs
 - 🧭 CLI guide: https://doc2mcp.site/docs/cli
 

package/dist/index.js

@@ -2,7 +2,7 @@
 
 // src/index.ts
 import { Command } from "commander";
-import pc6 from "picocolors";
+import pc7 from "picocolors";
 
 // src/commands/account.ts
 import pc from "picocolors";
@@ -73,8 +73,10 @@ async function runWhoami() {
 `);
 }
 
-// src/commands/convert.ts
-import pc5 from "picocolors";
+// src/commands/chat.ts
+import { cancel, intro, isCancel, outro, select, text } from "@clack/prompts";
+import ora2 from "ora";
+import pc4 from "picocolors";
 
 // src/api.ts
 import pc2 from "picocolors";
@@ -88,14 +90,14 @@ var ApiError = class extends Error {
   }
 };
 async function parseJson(response) {
-  const text = await response.text();
-  if (!text) {
+  const text2 = await response.text();
+  if (!text2) {
     return null;
   }
   try {
-    return JSON.parse(text);
+    return JSON.parse(text2);
   } catch {
-    return { raw: text };
+    return { raw: text2 };
   }
 }
 async function apiFetch(path, options = {}) {
@@ -230,9 +232,151 @@ async function ensureLoggedIn() {
   }
 }
 
+// src/commands/chat.ts
+async function pickProject(explicitId) {
+  if (explicitId) {
+    return await apiFetch(`/api/cli/projects/${explicitId}`);
+  }
+  const data = await apiFetch(
+    "/api/cli/projects"
+  );
+  const ready = data.projects.filter((p) => p.status === "ready");
+  if (ready.length === 0) {
+    process.stdout.write(
+      `${pc4.yellow("No ready MCP projects yet.")} Create one: ${pc4.bold("doc2mcp <docs-url>")}
+`
+    );
+    return null;
+  }
+  const choice = await select({
+    message: "Which docs do you want to chat with?",
+    options: ready.map((p) => ({
+      value: p.id,
+      label: p.name,
+      hint: p.sourceUrl ?? void 0
+    }))
+  });
+  if (isCancel(choice)) {
+    cancel("Cancelled.");
+    return null;
+  }
+  return await apiFetch(`/api/cli/projects/${choice}`);
+}
+async function askDocs(mcp, question) {
+  const response = await fetch(mcp.url, {
+    method: "POST",
+    headers: {
+      "Content-Type": "application/json",
+      Authorization: `Bearer ${mcp.token}`
+    },
+    body: JSON.stringify({
+      jsonrpc: "2.0",
+      id: 1,
+      method: "tools/call",
+      params: { name: "ask_documentation", arguments: { question } }
+    })
+  });
+  const payload = await response.json();
+  if (!response.ok || payload.error) {
+    throw new ApiError(
+      payload.error?.message ?? `MCP request failed (${response.status})`,
+      response.status,
+      payload
+    );
+  }
+  const raw = payload.result?.content?.[0]?.text ?? "";
+  try {
+    return JSON.parse(raw);
+  } catch {
+    return { question, answer: raw };
+  }
+}
+function renderAnswer(answer) {
+  process.stdout.write(`
+${pc4.cyan("\u25C6")} ${answer.answer.trim()}
+`);
+  if (answer.sources && answer.sources.length > 0) {
+    process.stdout.write(`
+${pc4.dim("Sources:")}
+`);
+    for (const source of answer.sources.slice(0, 6)) {
+      process.stdout.write(`  ${pc4.dim("\u2022")} ${source.title} ${pc4.dim(source.url)}
+`);
+    }
+  }
+  process.stdout.write("\n");
+}
+async function answerOnce(mcp, question) {
+  const spinner = ora2("Thinking\u2026").start();
+  try {
+    const answer = await askDocs(mcp, question);
+    spinner.stop();
+    renderAnswer(answer);
+  } catch (error) {
+    spinner.fail("Failed to get an answer");
+    printError(error);
+  }
+}
+async function runChat(projectId, options = {}) {
+  try {
+    await ensureLoggedIn();
+    const detail = await pickProject(projectId);
+    if (!detail) {
+      return;
+    }
+    if (!detail.mcp) {
+      process.stderr.write(
+        `${pc4.red("That project is not ready yet.")} Check: ${pc4.bold("doc2mcp list")}
+`
+      );
+      process.exitCode = 1;
+      return;
+    }
+    const { mcp } = detail;
+    if (options.message) {
+      await answerOnce(mcp, options.message);
+      return;
+    }
+    intro(
+      `${pc4.bold(`Chatting with ${detail.project.name}`)} ${pc4.dim("\u2014 ask anything about these docs")}`
+    );
+    process.stdout.write(
+      `${pc4.dim("Type your question. Use /exit to leave.")}
+`
+    );
+    let active = true;
+    while (active) {
+      const question = await text({
+        message: "You",
+        placeholder: "How do I authenticate requests?"
+      });
+      if (isCancel(question)) {
+        active = false;
+        break;
+      }
+      const trimmed = String(question).trim();
+      if (!trimmed) {
+        continue;
+      }
+      if (trimmed === "/exit" || trimmed === "/quit") {
+        active = false;
+        break;
+      }
+      await answerOnce(mcp, trimmed);
+    }
+    outro(pc4.dim("Bye \u2014 your docs MCP stays live for your editor."));
+  } catch (error) {
+    printError(error);
+    process.exitCode = 1;
+  }
+}
+
+// src/commands/convert.ts
+import pc6 from "picocolors";
+
 // src/commands/install.ts
 import { confirm, multiselect } from "@clack/prompts";
-import pc4 from "picocolors";
+import pc5 from "picocolors";
 
 // src/installers/detect.ts
 import { access } from "fs/promises";
@@ -358,28 +502,35 @@ function mergeVscodeMcp(existing, incoming) {
 }
 
 // src/installers/install.ts
+function unwrapConfig(value) {
+  const nested = value.config;
+  if (nested && typeof nested === "object" && !Array.isArray(nested)) {
+    return nested;
+  }
+  return value;
+}
 async function installToClient(client, configPath, payload) {
   if (client === "cursor") {
     const existing = await readJsonFile(configPath);
-    const merged = mergeMcpServers(existing, payload.cursor);
+    const merged = mergeMcpServers(existing, unwrapConfig(payload.cursor));
     await writeJsonFile(configPath, merged);
     return;
   }
   if (client === "vscode") {
     const existing = await readJsonFile(configPath);
-    const merged = mergeVscodeMcp(existing, payload.vscode);
+    const merged = mergeVscodeMcp(existing, unwrapConfig(payload.vscode));
     await writeJsonFile(configPath, merged);
     return;
   }
   if (client === "windsurf") {
     const existing = await readJsonFile(configPath);
-    const merged = mergeMcpServers(existing, payload.windsurf);
+    const merged = mergeMcpServers(existing, unwrapConfig(payload.windsurf));
     await writeJsonFile(configPath, merged);
     return;
   }
   if (client === "claude") {
     const existing = await readJsonFile(configPath);
-    const merged = mergeMcpServers(existing, payload.claude);
+    const merged = mergeMcpServers(existing, unwrapConfig(payload.claude));
     await writeJsonFile(configPath, merged);
   }
 }
@@ -412,8 +563,8 @@ async function promptInstall(install) {
     }
     await installToClient(client.id, client.configPath, install);
     process.stdout.write(
-      `${pc4.green("Installed")} ${client.label}
-${pc4.dim(client.configPath)}
+      `${pc5.green("Installed")} ${client.label}
+${pc5.dim(client.configPath)}
 `
     );
   }
@@ -423,7 +574,7 @@ async function runInstallCommand(projectId) {
     await ensureLoggedIn();
     const detail = await apiFetch(`/api/cli/projects/${projectId}`);
     if (!detail.install) {
-      process.stderr.write(`${pc4.red("Project is not ready or missing install bundle.")}
+      process.stderr.write(`${pc5.red("Project is not ready or missing install bundle.")}
 `);
       process.exitCode = 1;
       return;
@@ -444,19 +595,19 @@ function sleep2(ms) {
 function printStatus(detail) {
   const { project } = detail;
   process.stdout.write(
-    `\r${pc5.cyan("Status:")} ${project.status.padEnd(12)} ${pc5.dim(project.name)}`
+    `\r${pc6.cyan("Status:")} ${project.status.padEnd(12)} ${pc6.dim(project.name)}`
   );
 }
 async function runConvert(sourceUrl) {
   try {
     await ensureLoggedIn();
-    process.stdout.write(`${pc5.bold("Converting")} ${sourceUrl}
+    process.stdout.write(`${pc6.bold("Converting")} ${sourceUrl}
 `);
     const created = await apiFetch("/api/cli/convert", {
       method: "POST",
       body: JSON.stringify({ sourceUrl })
     });
-    process.stdout.write(`${pc5.dim("Project:")} ${created.id}
+    process.stdout.write(`${pc6.dim("Project:")} ${created.id}
 `);
     let delayMs = 2e3;
     const terminal = /* @__PURE__ */ new Set(["ready", "error"]);
@@ -478,29 +629,29 @@ async function runConvert(sourceUrl) {
     if (finalDetail.project.status === "error") {
       const lastLog = finalDetail.project.logs.at(-1);
       process.stderr.write(
-        `${pc5.red("Conversion failed.")}${lastLog ? ` ${lastLog.message}` : ""}
+        `${pc6.red("Conversion failed.")}${lastLog ? ` ${lastLog.message}` : ""}
 `
       );
       process.exitCode = 1;
       return;
     }
     if (!finalDetail.mcp || !finalDetail.install) {
-      process.stderr.write(`${pc5.red("MCP ready but missing install bundle.")}
+      process.stderr.write(`${pc6.red("MCP ready but missing install bundle.")}
 `);
       process.exitCode = 1;
       return;
     }
     process.stdout.write(`
-${pc5.green("MCP ready")}
+${pc6.green("MCP ready")}
 `);
-    process.stdout.write(`${pc5.bold("Server:")} ${finalDetail.mcp.serverName}
+    process.stdout.write(`${pc6.bold("Server:")} ${finalDetail.mcp.serverName}
 `);
-    process.stdout.write(`${pc5.bold("URL:")} ${finalDetail.mcp.url}
+    process.stdout.write(`${pc6.bold("URL:")} ${finalDetail.mcp.url}
 `);
-    process.stdout.write(`${pc5.bold("Token:")} ${finalDetail.mcp.token}
+    process.stdout.write(`${pc6.bold("Token:")} ${finalDetail.mcp.token}
 `);
     process.stdout.write(
-      `${pc5.dim("Also listed in the doc2mcp marketplace when ready.")}
+      `${pc6.dim("Also listed in the doc2mcp marketplace when ready.")}
 `
     );
     await promptInstall(finalDetail.install);
@@ -514,16 +665,16 @@ async function runList() {
     await ensureLoggedIn();
     const data = await apiFetch("/api/cli/projects");
     if (data.projects.length === 0) {
-      process.stdout.write(`${pc5.dim("No projects yet.")}
+      process.stdout.write(`${pc6.dim("No projects yet.")}
 `);
       return;
     }
     for (const project of data.projects) {
       process.stdout.write(
-        `${pc5.bold(project.name)} ${pc5.dim(`[${project.status}]`)} ${project.source}
+        `${pc6.bold(project.name)} ${pc6.dim(`[${project.status}]`)} ${project.source}
 `
       );
-      process.stdout.write(`  ${pc5.dim(project.id)} ${project.sourceUrl ?? ""}
+      process.stdout.write(`  ${pc6.dim(project.id)} ${project.sourceUrl ?? ""}
 `);
     }
   } catch (error) {
@@ -534,7 +685,7 @@ async function runList() {
 
 // src/index.ts
 var program = new Command();
-program.name("doc2mcp").description("Generate documentation MCP servers from your terminal").version("0.1.15", "-v, --version", "Print the installed CLI version");
+program.name("doc2mcp").description("Generate documentation MCP servers from your terminal").version("0.1.17", "-v, --version", "Print the installed CLI version");
 program.command("login").description("Authorize the CLI via browser").action(async () => {
   await runLogin();
 });
@@ -550,6 +701,9 @@ program.command("list").description("List your MCP projects").action(async () =>
 program.command("install <projectId>").description("Install an existing MCP into Cursor, VS Code, Claude, or Windsurf").action(async (projectId) => {
   await runInstallCommand(projectId);
 });
+program.command("chat [projectId]").description("Chat with your docs in the terminal (AI answers from your MCP)").option("-m, --message <text>", "Ask a single question and exit").action(async (projectId, options) => {
+  await runChat(projectId, options);
+});
 program.argument("[url]", "Documentation URL to convert").action(async (url) => {
   if (!url) {
     program.help();
@@ -562,7 +716,7 @@ program.argument("[url]", "Documentation URL to convert").action(async (url) =>
     }
   } catch {
     process.stderr.write(
-      `${pc6.red("Error:")} Invalid URL. Example: doc2mcp https://docs.example.com
+      `${pc7.red("Error:")} Invalid URL. Example: doc2mcp https://docs.example.com
 `
     );
     process.exitCode = 1;
@@ -572,7 +726,7 @@ program.argument("[url]", "Documentation URL to convert").action(async (url) =>
 });
 program.parseAsync(process.argv).catch((error) => {
   const message = error instanceof Error ? error.message : "Unknown error";
-  process.stderr.write(`${pc6.red("Error:")} ${message}
+  process.stderr.write(`${pc7.red("Error:")} ${message}
 `);
   process.exit(1);
 });

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "doc2mcp",
-  "version": "0.1.15",
+  "version": "0.1.17",
   "description": "Turn any documentation site into a hosted MCP server from your terminal — for Cursor, Claude, VS Code, Windsurf, and OpenAI agents.",
   "type": "module",
   "bin": {