First pass at pulling the v1.5 CLI, TUI, and Launcher clients into v2.

clients/launcher/src/index.ts

@@ -0,0 +1,60 @@
+#!/usr/bin/env node
+
+import { dirname, join } from "node:path";
+import { fileURLToPath, pathToFileURL } from "node:url";
+import { Command } from "commander";
+
+const launcherDir = dirname(fileURLToPath(import.meta.url));
+
+function clientEntry(client: "web" | "cli" | "tui"): string {
+  return pathToFileURL(
+    join(launcherDir, "..", "..", client, "build", "index.js"),
+  ).href;
+}
+
+const program = new Command();
+
+program
+  .name("mcp-inspector")
+  .description("MCP Inspector – run web UI, CLI, or TUI")
+  .option("--web", "Run web UI (default)")
+  .option("--cli", "Run CLI")
+  .option("--tui", "Run TUI")
+  .allowUnknownOption();
+
+program.parseOptions(process.argv);
+const opts = program.opts() as { web?: boolean; cli?: boolean; tui?: boolean };
+
+const helpOnly = process.argv.includes("-h") || process.argv.includes("--help");
+const modeFlagSet = opts.web || opts.cli || opts.tui;
+
+if (helpOnly && !modeFlagSet) {
+  program.outputHelp();
+  console.log(
+    "\nAll other arguments are forwarded to the selected app. Use --web, --cli, or --tui then pass app-specific options.",
+  );
+  process.exit(0);
+}
+
+const mode = opts.tui ? "tui" : opts.cli ? "cli" : "web";
+const modeFlag = opts.tui ? "--tui" : opts.cli ? "--cli" : "--web";
+// Forward argv without the launcher's mode flag so the app's Commander doesn't see unknown option
+const forwardedArgv = process.argv.filter((arg) => arg !== modeFlag);
+
+async function run(): Promise<void> {
+  if (mode === "web") {
+    const { runWeb } = await import(clientEntry("web"));
+    await runWeb(forwardedArgv);
+  } else if (mode === "cli") {
+    const { runCli } = await import(clientEntry("cli"));
+    await runCli(forwardedArgv);
+  } else {
+    const { runTui } = await import(clientEntry("tui"));
+    await runTui(forwardedArgv);
+  }
+}
+
+run().catch((err: unknown) => {
+  console.error("Error running MCP Inspector:", err);
+  process.exit(1);
+});