feat(docs): track cli command copies via global writeText hook

CopyTracker monkey-patches navigator.clipboard.writeText once at app
boot to fire PostHog cli_command_copied for every programmatic copy —
covering Fumadocs' built-in code-block button, custom-code-block,
code-showcase, framework-overview, and any future copy widget without
per-component instrumentation. Reo's own writeText patch continues to
function alongside this one.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>

Author: BenTaylorDev

docs/lib/providers/copy-tracker.tsx

@@ -0,0 +1,30 @@
+"use client";
+
+import { useEffect } from "react";
+import { usePostHog } from "posthog-js/react";
+import { trackCommandCopy } from "@/lib/track-command-copy";
+
+export function CopyTracker() {
+  const posthog = usePostHog();
+
+  useEffect(() => {
+    if (typeof navigator === "undefined" || !navigator.clipboard?.writeText) return;
+    const original = navigator.clipboard.writeText.bind(navigator.clipboard);
+    navigator.clipboard.writeText = async function (text: string) {
+      try {
+        trackCommandCopy(posthog, {
+          command: text,
+          location: typeof window !== "undefined" ? window.location.pathname : undefined,
+        });
+      } catch {
+        // Never let analytics break the underlying copy.
+      }
+      return original(text);
+    };
+    return () => {
+      navigator.clipboard.writeText = original;
+    };
+  }, [posthog]);
+
+  return null;
+}

docs/lib/providers/providers-wrapper.tsx

@@ -3,6 +3,7 @@
 import React, { Suspense } from "react";
 import { PostHogProvider } from "@/lib/providers/posthog-provider";
 import { ScarfPixel } from "./scarf-pixel";
+import { CopyTracker } from "./copy-tracker";
 import { useRB2B } from "@/lib/hooks/use-rb2b";
 import { useGoogleAnalytics } from "../hooks/use-google-analytics";
 import { ThemeOverride } from "@/components/theme-override";
@@ -13,7 +14,10 @@ export function ProvidersWrapper({ children }: { children: React.ReactNode }) {
 
   return (
     <Suspense fallback={null}>
-      <PostHogProvider>{children}</PostHogProvider>
+      <PostHogProvider>
+        <CopyTracker />
+        {children}
+      </PostHogProvider>
       <ThemeOverride />
       <ScarfPixel />
     </Suspense>

docs/lib/track-command-copy.ts

@@ -0,0 +1,54 @@
+import type { PostHog } from "posthog-js";
+
+const KNOWN_INSTALL_TYPES = [
+  "npx",
+  "npm",
+  "pnpm",
+  "yarn",
+  "bun",
+  "pip",
+  "uv",
+  "poetry",
+  "cargo",
+  "go",
+  "docker",
+  "curl",
+  "brew",
+] as const;
+
+export type InstallType = (typeof KNOWN_INSTALL_TYPES)[number] | "code";
+
+const MAX_COMMAND_LENGTH = 240;
+
+function inferInstallType(command: string): InstallType {
+  const firstToken = command.trim().split(/\s+/)[0]?.toLowerCase();
+  if (!firstToken) return "code";
+  return (KNOWN_INSTALL_TYPES as readonly string[]).includes(firstToken)
+    ? (firstToken as InstallType)
+    : "code";
+}
+
+export type TrackCommandCopyArgs = {
+  command: string;
+  product?: string;
+  location?: string;
+};
+
+export function trackCommandCopy(
+  posthog: PostHog | undefined,
+  { command, product, location }: TrackCommandCopyArgs,
+) {
+  if (!posthog) return;
+  const trimmed = command.trim();
+  if (!trimmed) return;
+  const truncated =
+    trimmed.length > MAX_COMMAND_LENGTH
+      ? trimmed.slice(0, MAX_COMMAND_LENGTH) + "…"
+      : trimmed;
+  posthog.capture("cli_command_copied", {
+    command: truncated,
+    install_type: inferInstallType(trimmed),
+    ...(product ? { product } : {}),
+    ...(location ? { location } : {}),
+  });
+}