nia-wizard 0.1.2 → 0.1.3

package/dist/bin.js

@@ -4,7 +4,7 @@ import {
   runMCPAdd,
   runMCPRemove,
   runWizard
-} from "./chunk-Y3PXW4WX.js";
+} from "./chunk-KC437AQI.js";
 
 // src/bin.ts
 import yargs from "yargs";

package/dist/{chunk-Y3PXW4WX.js → chunk-KC437AQI.js}

@@ -166,6 +166,18 @@ function getDefaultServerConfig(apiKey, mode) {
 // src/steps/add-mcp-server-to-clients/MCPClient.ts
 var SERVER_NAME = "nia";
 var MCPClient = class {
+  /**
+   * Documentation URL for this client's MCP setup
+   */
+  docsUrl;
+  /**
+   * Special notes for this client (e.g., alternative install methods)
+   */
+  note;
+  /**
+   * Whether this client uses CLI commands instead of config files
+   */
+  usesCLI;
   /**
    * Check if server is already installed
    */
@@ -486,6 +498,7 @@ import * as os from "os";
 import * as fs2 from "fs";
 var CursorMCPClient = class extends MCPClient {
   name = "Cursor";
+  docsUrl = "https://cursor.com/docs/context/mcp";
   async isClientSupported() {
     const platform = process.platform;
     if (platform !== "darwin" && platform !== "win32") {
@@ -509,6 +522,7 @@ var CursorMCPClient = class extends MCPClient {
       return getRemoteServerConfig(apiKey);
     }
     return {
+      type: "stdio",
       command: "pipx",
       args: ["run", "--no-cache", "nia-mcp-server"],
       env: {
@@ -525,6 +539,8 @@ import * as os2 from "os";
 import * as fs3 from "fs";
 var ClaudeDesktopMCPClient = class extends MCPClient {
   name = "Claude Desktop";
+  docsUrl = "https://modelcontextprotocol.io/quickstart/user";
+  note = "Only supports local (stdio) mode";
   async isClientSupported() {
     const platform = process.platform;
     if (platform !== "darwin" && platform !== "win32") {
@@ -585,6 +601,8 @@ import * as os3 from "os";
 import * as path4 from "path";
 var ClaudeCodeMCPClient = class extends MCPClient {
   name = "Claude Code";
+  docsUrl = "https://docs.anthropic.com/en/docs/claude-code/mcp-servers";
+  usesCLI = true;
   claudeBinaryPath = null;
   async isClientSupported() {
     try {
@@ -682,6 +700,7 @@ import * as os4 from "os";
 import * as fs5 from "fs";
 var VSCodeMCPClient = class extends MCPClient {
   name = "VS Code";
+  docsUrl = "https://code.visualstudio.com/docs/copilot/chat/mcp-servers";
   async isClientSupported() {
     const platform = process.platform;
     if (platform !== "darwin" && platform !== "win32" && platform !== "linux") {
@@ -744,6 +763,7 @@ import * as os5 from "os";
 import * as fs6 from "fs";
 var WindsurfMCPClient = class extends MCPClient {
   name = "Windsurf";
+  docsUrl = "https://docs.windsurf.com/windsurf/cascade/mcp";
   async isClientSupported() {
     const platform = process.platform;
     if (platform !== "darwin" && platform !== "win32" && platform !== "linux") {
@@ -797,6 +817,8 @@ import * as os6 from "os";
 import * as fs7 from "fs";
 var ZedMCPClient = class extends MCPClient {
   name = "Zed";
+  docsUrl = "https://zed.dev/docs/ai/mcp";
+  note = "Only supports local (stdio) mode";
   async isClientSupported() {
     const platform = process.platform;
     if (platform !== "darwin" && platform !== "linux") {
@@ -845,6 +867,7 @@ import * as os7 from "os";
 import * as fs8 from "fs";
 var ClineMCPClient = class extends MCPClient {
   name = "Cline";
+  docsUrl = "https://docs.cline.bot/mcp/configuring-mcp-servers";
   async isClientSupported() {
     const configPath = await this.getConfigPath();
     const configDir = path8.dirname(configPath);
@@ -893,6 +916,9 @@ var ClineMCPClient = class extends MCPClient {
 import { execSync as execSync2, spawnSync } from "child_process";
 var CodexMCPClient = class extends MCPClient {
   name = "Codex CLI";
+  docsUrl = "https://developers.openai.com/codex/mcp/";
+  usesCLI = true;
+  note = "Only supports local mode, uses CLI configuration";
   async isClientSupported() {
     try {
       execSync2("codex --version", { stdio: "ignore" });
@@ -965,6 +991,7 @@ import * as os8 from "os";
 import * as fs9 from "fs";
 var ContinueMCPClient = class extends MCPClient {
   name = "Continue.dev";
+  docsUrl = "https://docs.continue.dev/customize/mcp-tools";
   async isClientSupported() {
     const configPath = await this.getConfigPath();
     const configDir = path9.dirname(configPath);
@@ -1016,6 +1043,8 @@ import * as os9 from "os";
 import * as fs10 from "fs";
 var JetBrainsMCPClient = class extends MCPClient {
   name = "JetBrains";
+  docsUrl = "https://www.jetbrains.com/help/idea/mcp-server.html";
+  note = "Only supports local (stdio) mode";
   async isClientSupported() {
     const homeDir = os9.homedir();
     const possibleDirs = [
@@ -1051,6 +1080,7 @@ import * as os10 from "os";
 import * as fs11 from "fs";
 var AntigravityMCPClient = class extends MCPClient {
   name = "Google Antigravity";
+  docsUrl = "https://developers.google.com/gemini-code-assist/docs/use-mcp-servers";
   async isClientSupported() {
     const configPath = await this.getConfigPath();
     const configDir = path11.dirname(configPath);
@@ -1088,6 +1118,7 @@ import * as os11 from "os";
 import * as fs12 from "fs";
 var TraeMCPClient = class extends MCPClient {
   name = "Trae";
+  docsUrl = "https://docs.trae.ai/ide/model-context-protocol";
   async isClientSupported() {
     const configPath = await this.getConfigPath();
     const configDir = path12.dirname(configPath);
@@ -1128,6 +1159,7 @@ import * as os12 from "os";
 import * as fs13 from "fs";
 var RooCodeMCPClient = class extends MCPClient {
   name = "Roo Code";
+  docsUrl = "https://docs.roocode.com/features/mcp/using-mcp-in-roo";
   async isClientSupported() {
     const configPath = await this.getConfigPath();
     const configDir = path13.dirname(configPath);
@@ -1166,6 +1198,7 @@ import * as os13 from "os";
 import * as fs14 from "fs";
 var KiloCodeMCPClient = class extends MCPClient {
   name = "Kilo Code";
+  docsUrl = "https://kilo.ai/docs/features/mcp/using-mcp-in-kilo-code";
   async isClientSupported() {
     const configPath = await this.getConfigPath();
     const configDir = path14.dirname(configPath);
@@ -1208,6 +1241,7 @@ import * as os14 from "os";
 import * as fs15 from "fs";
 var GeminiCLIMCPClient = class extends MCPClient {
   name = "Gemini CLI";
+  docsUrl = "https://googlegemini.com/docs/gemini-cli/tools/mcp-server";
   async isClientSupported() {
     const configPath = await this.getConfigPath();
     const configDir = path15.dirname(configPath);
@@ -1249,6 +1283,8 @@ import * as os15 from "os";
 import * as fs16 from "fs";
 var OpencodeMCPClient = class extends MCPClient {
   name = "Opencode";
+  docsUrl = "https://opencode.ai/docs/mcp-servers/";
+  note = "Also available as dedicated plugin: bunx nia-opencode@latest install (Demo: https://x.com/arlanr/status/1879212916125777962)";
   async isClientSupported() {
     const configPath = await this.getConfigPath();
     const configDir = path16.dirname(configPath);
@@ -1289,6 +1325,7 @@ import * as os16 from "os";
 import * as fs17 from "fs";
 var QodoGenMCPClient = class extends MCPClient {
   name = "Qodo Gen";
+  docsUrl = "https://docs.qodo.ai/qodo-documentation/qodo-gen/tools-mcps/agentic-tools-mcps";
   async isClientSupported() {
     const configPath = await this.getConfigPath();
     const configDir = path17.dirname(configPath);
@@ -1326,6 +1363,7 @@ import * as os17 from "os";
 import * as fs18 from "fs";
 var QwenCoderMCPClient = class extends MCPClient {
   name = "Qwen Coder";
+  docsUrl = "https://qwenlm.github.io/blog/qwen2.5-coder-family/";
   async isClientSupported() {
     const configPath = await this.getConfigPath();
     const configDir = path18.dirname(configPath);
@@ -1367,6 +1405,7 @@ import * as os18 from "os";
 import * as fs19 from "fs";
 var VisualStudioMCPClient = class extends MCPClient {
   name = "Visual Studio 2022";
+  docsUrl = "https://learn.microsoft.com/en-us/visualstudio/ide/mcp-servers";
   async isClientSupported() {
     if (process.platform !== "win32") {
       return false;
@@ -1409,6 +1448,7 @@ import * as os19 from "os";
 import * as fs20 from "fs";
 var CrushMCPClient = class extends MCPClient {
   name = "Crush";
+  docsUrl = "https://github.com/charmbracelet/crush";
   async isClientSupported() {
     const configPath = await this.getConfigPath();
     const configDir = path20.dirname(configPath);
@@ -1449,6 +1489,7 @@ import * as fs21 from "fs";
 var COPILOT_TOOLS = ["index", "search", "manage_resource", "nia_web_search", "nia_deep_research_agent"];
 var CopilotCLIMCPClient = class extends MCPClient {
   name = "Copilot CLI";
+  docsUrl = "https://docs.github.com/en/copilot/how-tos/provide-context/use-mcp/extend-copilot-chat-with-mcp";
   async isClientSupported() {
     const configPath = await this.getConfigPath();
     const configDir = path21.dirname(configPath);
@@ -1488,6 +1529,7 @@ var CopilotCLIMCPClient = class extends MCPClient {
 };
 var CopilotAgentMCPClient = class extends MCPClient {
   name = "Copilot Coding Agent";
+  docsUrl = "https://docs.github.com/en/copilot/how-tos/provide-context/use-mcp/extend-copilot-chat-with-mcp";
   async isClientSupported() {
     return fs21.existsSync(".github");
   }
@@ -1526,6 +1568,8 @@ import * as path22 from "path";
 import * as os21 from "os";
 var AugmentMCPClient = class extends MCPClient {
   name = "Augment Code";
+  docsUrl = "https://docs.augmentcode.com/setup-augment/mcp";
+  note = "Only supports local (stdio) mode";
   async isClientSupported() {
     return false;
   }
@@ -1561,6 +1605,8 @@ import * as os22 from "os";
 import * as fs22 from "fs";
 var KiroMCPClient = class extends MCPClient {
   name = "Kiro";
+  docsUrl = "https://kiro.dev/docs/mcp/";
+  note = "Only supports local (stdio) mode";
   async isClientSupported() {
     const configPath = await this.getConfigPath();
     const configDir = path23.dirname(configPath);
@@ -1595,6 +1641,8 @@ import * as os23 from "os";
 import * as fs23 from "fs";
 var LMStudioMCPClient = class extends MCPClient {
   name = "LM Studio";
+  docsUrl = "https://lmstudio.ai/docs/app/mcp";
+  note = "Only supports local (stdio) mode";
   async isClientSupported() {
     const configPath = await this.getConfigPath();
     const configDir = path24.dirname(configPath);
@@ -1627,6 +1675,8 @@ import * as os24 from "os";
 import * as fs24 from "fs";
 var BoltAIMCPClient = class extends MCPClient {
   name = "BoltAI";
+  docsUrl = "https://docs.boltai.com/docs/plugins/mcp-servers";
+  note = "Only supports local (stdio) mode, macOS only";
   async isClientSupported() {
     if (process.platform !== "darwin") {
       return false;
@@ -1662,6 +1712,8 @@ import * as os25 from "os";
 import * as fs25 from "fs";
 var PerplexityMCPClient = class extends MCPClient {
   name = "Perplexity Desktop";
+  docsUrl = "https://docs.perplexity.ai/guides/mcp-server";
+  note = "Only supports local (stdio) mode, macOS only";
   async isClientSupported() {
     if (process.platform !== "darwin") {
       return false;
@@ -1697,6 +1749,8 @@ import * as os26 from "os";
 import * as fs26 from "fs";
 var WarpMCPClient = class extends MCPClient {
   name = "Warp";
+  docsUrl = "https://docs.warp.dev/knowledge-and-collaboration/mcp";
+  note = "Only supports local (stdio) mode";
   async isClientSupported() {
     const configPath = await this.getConfigPath();
     const configDir = path27.dirname(configPath);
@@ -1731,6 +1785,8 @@ import * as os27 from "os";
 import * as fs27 from "fs";
 var AmazonQMCPClient = class extends MCPClient {
   name = "Amazon Q Developer CLI";
+  docsUrl = "https://docs.aws.amazon.com/amazonq/latest/qdeveloper-ug/command-line-mcp-configuration.html";
+  note = "Only supports local (stdio) mode";
   async isClientSupported() {
     const configPath = await this.getConfigPath();
     const configDir = path28.dirname(configPath);
@@ -1761,6 +1817,9 @@ var AmazonQMCPClient = class extends MCPClient {
 import { execSync as execSync3, spawnSync as spawnSync2 } from "child_process";
 var FactoryMCPClient = class extends MCPClient {
   name = "Factory";
+  docsUrl = "https://docs.factory.ai/cli/configuration/mcp";
+  usesCLI = true;
+  note = "Uses droid CLI for configuration";
   async isClientSupported() {
     try {
       execSync3("droid --version", { stdio: "ignore" });
@@ -1843,6 +1902,9 @@ var FactoryMCPClient = class extends MCPClient {
 import { execSync as execSync4, spawnSync as spawnSync3 } from "child_process";
 var AmpMCPClient = class extends MCPClient {
   name = "Amp";
+  docsUrl = "https://ampcode.com/docs/customize/mcp";
+  usesCLI = true;
+  note = "Only supports remote mode, uses CLI configuration";
   async isClientSupported() {
     try {
       execSync4("amp --version", { stdio: "ignore" });
@@ -1914,6 +1976,8 @@ import * as os28 from "os";
 import * as fs28 from "fs";
 var VibeMCPClient = class extends MCPClient {
   name = "Mistral Vibe CLI";
+  docsUrl = "https://github.com/mistralai/mistral-vibe?tab=readme-ov-file#mcp-server-configuration";
+  note = "Only supports remote mode, uses TOML config";
   async isClientSupported() {
     const configPath = await this.getConfigPath();
     return fs28.existsSync(configPath);
@@ -1991,6 +2055,44 @@ Authorization = "Bearer ${apiKey}"
 };
 
 // src/steps/add-mcp-server-to-clients/index.ts
+function getAllClients() {
+  return [
+    // Core / popular clients first
+    new CursorMCPClient(),
+    new ClaudeCodeMCPClient(),
+    new ClaudeDesktopMCPClient(),
+    new VSCodeMCPClient(),
+    new WindsurfMCPClient(),
+    new ClineMCPClient(),
+    new ContinueMCPClient(),
+    new ZedMCPClient(),
+    new JetBrainsMCPClient(),
+    // Additional clients
+    new AntigravityMCPClient(),
+    new TraeMCPClient(),
+    new RooCodeMCPClient(),
+    new KiloCodeMCPClient(),
+    new GeminiCLIMCPClient(),
+    new OpencodeMCPClient(),
+    new QodoGenMCPClient(),
+    new QwenCoderMCPClient(),
+    new VisualStudioMCPClient(),
+    new CrushMCPClient(),
+    new CopilotCLIMCPClient(),
+    new CopilotAgentMCPClient(),
+    new AugmentMCPClient(),
+    new KiroMCPClient(),
+    new LMStudioMCPClient(),
+    new BoltAIMCPClient(),
+    new PerplexityMCPClient(),
+    new WarpMCPClient(),
+    new AmazonQMCPClient(),
+    new CodexMCPClient(),
+    new FactoryMCPClient(),
+    new AmpMCPClient(),
+    new VibeMCPClient()
+  ];
+}
 async function getSupportedClients() {
   const allClients = [
     // Core / popular clients first
@@ -2387,11 +2489,118 @@ function dependenciesReady() {
 }
 
 // src/run.ts
+async function runManualMode() {
+  const allClients = getAllClients();
+  const selectedName = await abortIfCancelled(
+    clack_default.select({
+      message: "Select a coding agent to view its configuration:",
+      options: allClients.map((client2) => ({
+        value: client2.name,
+        label: client2.name,
+        hint: client2.note || void 0
+      }))
+    })
+  );
+  const client = allClients.find((c) => c.name === selectedName);
+  if (!client) {
+    clack_default.log.error("Client not found");
+    return;
+  }
+  console.log("");
+  clack_default.log.info(chalk3.bold(`Configuration for ${client.name}`));
+  console.log("");
+  if (client.docsUrl) {
+    console.log(chalk3.cyan("  Documentation:"));
+    console.log(`    ${chalk3.underline(client.docsUrl)}`);
+    console.log("");
+  }
+  if (client.note) {
+    console.log(chalk3.yellow("  Note:"));
+    console.log(`    ${client.note}`);
+    console.log("");
+  }
+  let configPath = "";
+  try {
+    configPath = await client.getConfigPath();
+    console.log(chalk3.cyan("  Config file path:"));
+    console.log(`    ${configPath}`);
+    console.log("");
+  } catch {
+    if (client.usesCLI) {
+      console.log(chalk3.cyan("  Configuration method:"));
+      console.log(`    Uses CLI commands (no config file)`);
+      console.log("");
+    }
+  }
+  const exampleApiKey = "nk_YOUR_API_KEY_HERE";
+  console.log(chalk3.cyan("  Local mode config (stdio):"));
+  const localConfig = client.getServerConfig(exampleApiKey, "local");
+  console.log(chalk3.dim("    Add this to your config file under the servers section:"));
+  console.log("");
+  console.log(chalk3.green(`    "${client.name === "Cursor" ? "mcpServers" : client.getServerPropertyName()}": {`));
+  console.log(chalk3.green(`      "nia": ${JSON.stringify(localConfig, null, 6).split("\n").map((line, i) => i === 0 ? line : "      " + line).join("\n")}`));
+  console.log(chalk3.green(`    }`));
+  console.log("");
+  console.log(chalk3.cyan("  Remote mode config (HTTP):"));
+  const remoteConfig = client.getServerConfig(exampleApiKey, "remote");
+  console.log(chalk3.dim("    Add this to your config file under the servers section:"));
+  console.log("");
+  console.log(chalk3.green(`    "${client.name === "Cursor" ? "mcpServers" : client.getServerPropertyName()}": {`));
+  console.log(chalk3.green(`      "nia": ${JSON.stringify(remoteConfig, null, 6).split("\n").map((line, i) => i === 0 ? line : "      " + line).join("\n")}`));
+  console.log(chalk3.green(`    }`));
+  console.log("");
+  if (client.usesCLI) {
+    console.log(chalk3.cyan("  CLI commands:"));
+    if (client.name === "Claude Code") {
+      console.log(chalk3.dim("    Local mode:"));
+      console.log(`      claude mcp add nia -e "NIA_API_KEY=${exampleApiKey}" -e "NIA_API_URL=https://apigcp.trynia.ai/" -s user -- pipx run --no-cache nia-mcp-server`);
+      console.log("");
+      console.log(chalk3.dim("    Remote mode:"));
+      console.log(`      claude mcp add --transport http nia ${REMOTE_MCP_URL} --header "Authorization: Bearer ${exampleApiKey}" -s user`);
+    } else if (client.name === "Codex CLI") {
+      console.log(chalk3.dim("    Local mode:"));
+      console.log(`      codex mcp add nia --env "NIA_API_KEY=${exampleApiKey}" --env "NIA_API_URL=https://apigcp.trynia.ai/" -- pipx run --no-cache nia-mcp-server`);
+    } else if (client.name === "Factory") {
+      console.log(chalk3.dim("    Local mode:"));
+      console.log(`      droid mcp add nia "pipx run --no-cache nia-mcp-server" --env "NIA_API_KEY=${exampleApiKey}" --env "NIA_API_URL=https://apigcp.trynia.ai/"`);
+      console.log("");
+      console.log(chalk3.dim("    Remote mode:"));
+      console.log(`      droid mcp add nia ${REMOTE_MCP_URL} --type http --header "Authorization: Bearer ${exampleApiKey}"`);
+    } else if (client.name === "Amp") {
+      console.log(chalk3.dim("    Remote mode:"));
+      console.log(`      amp mcp add nia --header "Authorization=Bearer ${exampleApiKey}" ${REMOTE_MCP_URL}`);
+    }
+    console.log("");
+  }
+  clack_default.outro(chalk3.dim("Press Enter to exit"));
+}
 async function runWizard(options) {
   if (options.debug) {
     enableDebug();
   }
   printWelcome();
+  const wizardMode = await abortIfCancelled(
+    clack_default.select({
+      message: "What would you like to do?",
+      options: [
+        {
+          value: "install",
+          label: "Install Nia MCP Server",
+          hint: "Automatically configure your coding agents"
+        },
+        {
+          value: "manual",
+          label: "Manual Setup (View Config)",
+          hint: "View configuration for manual setup or troubleshooting"
+        }
+      ],
+      initialValue: "install"
+    })
+  );
+  if (wizardMode === "manual") {
+    await runManualMode();
+    return;
+  }
   const apiKey = await getApiKey(options.apiKey);
   let mode;
   if (options.local !== void 0) {
@@ -2535,4 +2744,4 @@ export {
   runMCPAdd,
   runMCPRemove
 };
-//# sourceMappingURL=chunk-Y3PXW4WX.js.map
+//# sourceMappingURL=chunk-KC437AQI.js.map