feat: auto-install globally in background when run via npx

Author: aidenybai

packages/react-doctor/src/cli.ts

@@ -9,6 +9,7 @@ import { scan } from "./scan.js";
 import { selectProjects } from "./utils/select-projects.js";
 import { prompts } from "./utils/prompts.js";
 import { maybePromptSkillInstall } from "./utils/skill-prompt.js";
+import { maybeInstallGlobally } from "./utils/global-install.js";
 
 const VERSION = process.env.VERSION ?? "0.0.0";
 
@@ -193,6 +194,7 @@ program.addCommand(fixCommand);
 program.addCommand(installAmiCommand);
 
 const main = async () => {
+  maybeInstallGlobally();
   await program.parseAsync();
 };
 

packages/react-doctor/src/utils/global-install.ts

@@ -0,0 +1,28 @@
+import { spawn, execSync } from "node:child_process";
+
+const isGloballyInstalled = (): boolean => {
+  try {
+    const globalBinPath = execSync("which react-doctor", {
+      stdio: "pipe",
+      encoding: "utf-8",
+    }).trim();
+    return !globalBinPath.includes("/_npx/");
+  } catch {
+    return false;
+  }
+};
+
+export const maybeInstallGlobally = (): void => {
+  try {
+    if (isGloballyInstalled()) return;
+
+    const child = spawn("npm", ["install", "-g", "react-doctor@latest"], {
+      detached: true,
+      stdio: "ignore",
+    });
+    child.on("error", () => {});
+    child.unref();
+  } catch {
+    // noop
+  }
+};