codemaxxing 0.3.0 → 0.4.0

package/src/index.tsx

@@ -12,6 +12,10 @@ import { isGitRepo, getBranch, getStatus, getDiff, undoLastCommit } from "./util
 import { getTheme, listThemes, THEMES, DEFAULT_THEME, type Theme } from "./themes.js";
 import { PROVIDERS, getCredentials, openRouterOAuth, anthropicSetupToken, importCodexToken, importQwenToken, copilotDeviceFlow, saveApiKey } from "./utils/auth.js";
 import { listInstalledSkills, installSkill, removeSkill, getRegistrySkills, searchRegistry, createSkillScaffold, getActiveSkills, getActiveSkillCount } from "./utils/skills.js";
+import { listServers, addServer, removeServer, getAllMCPTools, getConnectedServers } from "./utils/mcp.js";
+import { detectHardware, formatBytes, type HardwareInfo } from "./utils/hardware.js";
+import { getRecommendations, getFitIcon, type ScoredModel } from "./utils/models.js";
+import { isOllamaInstalled, isOllamaRunning, getOllamaInstallCommand, startOllama, pullModel, type PullProgress } from "./utils/ollama.js";
 
 const VERSION = "0.1.9";
 
@@ -58,6 +62,11 @@ const SLASH_COMMANDS = [
   { cmd: "/lint", desc: "show auto-lint status" },
   { cmd: "/lint on", desc: "enable auto-lint" },
   { cmd: "/lint off", desc: "disable auto-lint" },
+  { cmd: "/mcp", desc: "show MCP servers" },
+  { cmd: "/mcp tools", desc: "list MCP tools" },
+  { cmd: "/mcp add", desc: "add MCP server" },
+  { cmd: "/mcp remove", desc: "remove MCP server" },
+  { cmd: "/mcp reconnect", desc: "reconnect MCP servers" },
   { cmd: "/quit", desc: "exit" },
 ];
 
@@ -166,6 +175,16 @@ function App() {
     resolve: (decision: "yes" | "no" | "always") => void;
   } | null>(null);
 
+  // ── Setup Wizard State ──
+  type WizardScreen = "connection" | "models" | "install-ollama" | "pulling" | null;
+  const [wizardScreen, setWizardScreen] = useState<WizardScreen>(null);
+  const [wizardIndex, setWizardIndex] = useState(0);
+  const [wizardHardware, setWizardHardware] = useState<HardwareInfo | null>(null);
+  const [wizardModels, setWizardModels] = useState<ScoredModel[]>([]);
+  const [wizardPullProgress, setWizardPullProgress] = useState<PullProgress | null>(null);
+  const [wizardPullError, setWizardPullError] = useState<string | null>(null);
+  const [wizardSelectedModel, setWizardSelectedModel] = useState<ScoredModel | null>(null);
+
   // Listen for paste events from stdin interceptor
   useEffect(() => {
     const handler = ({ content, lines }: { content: string; lines: number }) => {
@@ -204,10 +223,11 @@ function App() {
         setConnectionInfo([...info]);
       } else {
         info.push("✗ No local LLM server found.");
-        info.push("  /connect  — retry after starting LM Studio or Ollama");
-        info.push("  /login    — authenticate with a cloud provider");
         setConnectionInfo([...info]);
         setReady(true);
+        // Show the setup wizard on first run
+        setWizardScreen("connection");
+        setWizardIndex(0);
         return;
       }
     } else {
@@ -287,6 +307,9 @@ function App() {
       onLintResult: (file, errors) => {
         addMsg("info", `🔍 Lint errors in ${file}:\n${errors}`);
       },
+      onMCPStatus: (server, status) => {
+        addMsg("info", `🔌 MCP ${server}: ${status}`);
+      },
       contextCompressionThreshold: config.defaults.contextCompressionThreshold,
       onToolApproval: (name, args, diff) => {
         return new Promise((resolve) => {
@@ -306,6 +329,13 @@ function App() {
       setConnectionInfo([...info]);
     }
 
+    // Show MCP server count
+    const mcpCount = a.getMCPServerCount();
+    if (mcpCount > 0) {
+      info.push(`🔌 ${mcpCount} MCP server${mcpCount > 1 ? "s" : ""} connected`);
+      setConnectionInfo([...info]);
+    }
+
     setAgent(a);
     setModelName(provider.model);
     providerRef.current = { baseUrl: provider.baseUrl, apiKey: provider.apiKey };
@@ -419,6 +449,11 @@ function App() {
         "  /lint      — show auto-lint status & detected linter",
         "  /lint on   — enable auto-lint",
         "  /lint off  — disable auto-lint",
+        "  /mcp       — show MCP servers & status",
+        "  /mcp tools — list all MCP tools",
+        "  /mcp add   — add MCP server to global config",
+        "  /mcp remove — remove MCP server",
+        "  /mcp reconnect — reconnect all MCP servers",
         "  /quit      — exit",
       ].join("\n"));
       return;
@@ -579,6 +614,71 @@ function App() {
       return;
     }
 
+    // ── MCP commands (partially work without agent) ──
+    if (trimmed === "/mcp" || trimmed === "/mcp list") {
+      const servers = listServers(process.cwd());
+      if (servers.length === 0) {
+        addMsg("info", "🔌 No MCP servers configured.\n  Add one: /mcp add <name> <command> [args...]");
+      } else {
+        const lines = servers.map((s) => {
+          const status = s.connected ? `✔ connected (${s.toolCount} tools)` : "✗ not connected";
+          return `  ${s.connected ? "●" : "○"} ${s.name} [${s.source}] — ${s.command}\n    ${status}`;
+        });
+        addMsg("info", `🔌 MCP Servers:\n${lines.join("\n")}`);
+      }
+      return;
+    }
+    if (trimmed === "/mcp tools") {
+      const servers = getConnectedServers();
+      if (servers.length === 0) {
+        addMsg("info", "🔌 No MCP servers connected.");
+        return;
+      }
+      const lines: string[] = [];
+      for (const server of servers) {
+        lines.push(`${server.name} (${server.tools.length} tools):`);
+        for (const tool of server.tools) {
+          lines.push(`  • ${tool.name} — ${tool.description ?? "(no description)"}`);
+        }
+      }
+      addMsg("info", `🔌 MCP Tools:\n${lines.join("\n")}`);
+      return;
+    }
+    if (trimmed.startsWith("/mcp add ")) {
+      const parts = trimmed.replace("/mcp add ", "").trim().split(/\s+/);
+      if (parts.length < 2) {
+        addMsg("info", "Usage: /mcp add <name> <command> [args...]\n  Example: /mcp add github npx -y @modelcontextprotocol/server-github");
+        return;
+      }
+      const [name, command, ...cmdArgs] = parts;
+      const result = addServer(name, { command, args: cmdArgs.length > 0 ? cmdArgs : undefined });
+      addMsg(result.ok ? "info" : "error", result.ok ? `✅ ${result.message}` : `✗ ${result.message}`);
+      return;
+    }
+    if (trimmed.startsWith("/mcp remove ")) {
+      const name = trimmed.replace("/mcp remove ", "").trim();
+      if (!name) {
+        addMsg("info", "Usage: /mcp remove <name>");
+        return;
+      }
+      const result = removeServer(name);
+      addMsg(result.ok ? "info" : "error", result.ok ? `✅ ${result.message}` : `✗ ${result.message}`);
+      return;
+    }
+    if (trimmed === "/mcp reconnect") {
+      if (!agent) {
+        addMsg("info", "⚠ No agent connected. Connect first.");
+        return;
+      }
+      addMsg("info", "🔌 Reconnecting MCP servers...");
+      await agent.reconnectMCP();
+      const count = agent.getMCPServerCount();
+      addMsg("info", count > 0
+        ? `✅ ${count} MCP server${count > 1 ? "s" : ""} reconnected.`
+        : "No MCP servers connected.");
+      return;
+    }
+
     // Commands below require an active LLM connection
     if (!agent) {
       addMsg("info", "⚠ No LLM connected. Use /login to authenticate with a provider, or start a local server.");
@@ -1055,6 +1155,222 @@ function App() {
       return;
     }
 
+    // ── Setup Wizard Navigation ──
+    if (wizardScreen) {
+      if (wizardScreen === "connection") {
+        const items = ["local", "openrouter", "apikey", "existing"];
+        if (key.upArrow) {
+          setWizardIndex((prev) => (prev - 1 + items.length) % items.length);
+          return;
+        }
+        if (key.downArrow) {
+          setWizardIndex((prev) => (prev + 1) % items.length);
+          return;
+        }
+        if (key.escape) {
+          setWizardScreen(null);
+          return;
+        }
+        if (key.return) {
+          const selected = items[wizardIndex];
+          if (selected === "local") {
+            // Scan hardware and show model picker
+            const hw = detectHardware();
+            setWizardHardware(hw);
+            const recs = getRecommendations(hw).filter(m => m.fit !== "skip");
+            setWizardModels(recs);
+            setWizardScreen("models");
+            setWizardIndex(0);
+          } else if (selected === "openrouter") {
+            setWizardScreen(null);
+            addMsg("info", "Starting OpenRouter OAuth — opening browser...");
+            setLoading(true);
+            setSpinnerMsg("Waiting for authorization...");
+            openRouterOAuth((msg: string) => addMsg("info", msg))
+              .then(() => {
+                addMsg("info", "✅ OpenRouter authenticated! Use /connect to connect.");
+                setLoading(false);
+              })
+              .catch((err: any) => { addMsg("error", `OAuth failed: ${err.message}`); setLoading(false); });
+          } else if (selected === "apikey") {
+            setWizardScreen(null);
+            setLoginPicker(true);
+            setLoginPickerIndex(0);
+          } else if (selected === "existing") {
+            setWizardScreen(null);
+            addMsg("info", "Start your LLM server, then type /connect to retry.");
+          }
+          return;
+        }
+        return;
+      }
+
+      if (wizardScreen === "models") {
+        const models = wizardModels;
+        if (key.upArrow) {
+          setWizardIndex((prev) => (prev - 1 + models.length) % models.length);
+          return;
+        }
+        if (key.downArrow) {
+          setWizardIndex((prev) => (prev + 1) % models.length);
+          return;
+        }
+        if (key.escape) {
+          setWizardScreen("connection");
+          setWizardIndex(0);
+          return;
+        }
+        if (key.return) {
+          const selected = models[wizardIndex];
+          if (selected) {
+            setWizardSelectedModel(selected);
+            // Check if Ollama is installed
+            if (!isOllamaInstalled()) {
+              setWizardScreen("install-ollama");
+            } else {
+              // Start pulling the model
+              setWizardScreen("pulling");
+              setWizardPullProgress({ status: "starting", percent: 0 });
+              setWizardPullError(null);
+
+              (async () => {
+                try {
+                  // Ensure ollama is running
+                  const running = await isOllamaRunning();
+                  if (!running) {
+                    setWizardPullProgress({ status: "Starting Ollama server...", percent: 0 });
+                    startOllama();
+                    // Wait for it to come up
+                    for (let i = 0; i < 15; i++) {
+                      await new Promise(r => setTimeout(r, 1000));
+                      if (await isOllamaRunning()) break;
+                    }
+                    if (!(await isOllamaRunning())) {
+                      setWizardPullError("Could not start Ollama server. Run 'ollama serve' manually, then press Enter.");
+                      return;
+                    }
+                  }
+
+                  await pullModel(selected.ollamaId, (p) => {
+                    setWizardPullProgress(p);
+                  });
+
+                  setWizardPullProgress({ status: "success", percent: 100 });
+
+                  // Wait briefly then connect
+                  await new Promise(r => setTimeout(r, 500));
+                  setWizardScreen(null);
+                  setWizardPullProgress(null);
+                  setWizardSelectedModel(null);
+                  addMsg("info", `✅ ${selected.name} installed! Connecting...`);
+                  await connectToProvider(true);
+                } catch (err: any) {
+                  setWizardPullError(err.message);
+                }
+              })();
+            }
+          }
+          return;
+        }
+        return;
+      }
+
+      if (wizardScreen === "install-ollama") {
+        if (key.escape) {
+          setWizardScreen("models");
+          setWizardIndex(0);
+          return;
+        }
+        if (key.return) {
+          // User says they installed it — check and proceed
+          if (isOllamaInstalled()) {
+            const selected = wizardSelectedModel;
+            if (selected) {
+              setWizardScreen("pulling");
+              setWizardPullProgress({ status: "starting", percent: 0 });
+              setWizardPullError(null);
+
+              (async () => {
+                try {
+                  const running = await isOllamaRunning();
+                  if (!running) {
+                    setWizardPullProgress({ status: "Starting Ollama server...", percent: 0 });
+                    startOllama();
+                    for (let i = 0; i < 15; i++) {
+                      await new Promise(r => setTimeout(r, 1000));
+                      if (await isOllamaRunning()) break;
+                    }
+                    if (!(await isOllamaRunning())) {
+                      setWizardPullError("Could not start Ollama server. Run 'ollama serve' manually, then press Enter.");
+                      return;
+                    }
+                  }
+                  await pullModel(selected.ollamaId, (p) => setWizardPullProgress(p));
+                  setWizardPullProgress({ status: "success", percent: 100 });
+                  await new Promise(r => setTimeout(r, 500));
+                  setWizardScreen(null);
+                  setWizardPullProgress(null);
+                  setWizardSelectedModel(null);
+                  addMsg("info", `✅ ${selected.name} installed! Connecting...`);
+                  await connectToProvider(true);
+                } catch (err: any) {
+                  setWizardPullError(err.message);
+                }
+              })();
+            }
+          } else {
+            addMsg("info", "Ollama not found yet. Install it and press Enter again.");
+          }
+          return;
+        }
+        return;
+      }
+
+      if (wizardScreen === "pulling") {
+        // Allow retry on error
+        if (wizardPullError && key.return) {
+          const selected = wizardSelectedModel;
+          if (selected) {
+            setWizardPullError(null);
+            setWizardPullProgress({ status: "retrying", percent: 0 });
+            (async () => {
+              try {
+                const running = await isOllamaRunning();
+                if (!running) {
+                  startOllama();
+                  for (let i = 0; i < 15; i++) {
+                    await new Promise(r => setTimeout(r, 1000));
+                    if (await isOllamaRunning()) break;
+                  }
+                }
+                await pullModel(selected.ollamaId, (p) => setWizardPullProgress(p));
+                setWizardPullProgress({ status: "success", percent: 100 });
+                await new Promise(r => setTimeout(r, 500));
+                setWizardScreen(null);
+                setWizardPullProgress(null);
+                setWizardSelectedModel(null);
+                addMsg("info", `✅ ${selected.name} installed! Connecting...`);
+                await connectToProvider(true);
+              } catch (err: any) {
+                setWizardPullError(err.message);
+              }
+            })();
+          }
+          return;
+        }
+        if (wizardPullError && key.escape) {
+          setWizardScreen("models");
+          setWizardIndex(0);
+          setWizardPullError(null);
+          setWizardPullProgress(null);
+          return;
+        }
+        return; // Ignore keys while pulling
+      }
+
+      return;
+    }
+
     // Theme picker navigation
     if (themePicker) {
       const themeKeys = listThemes();
@@ -1516,6 +1832,101 @@ function App() {
         </Box>
       )}
 
+      {/* ═══ SETUP WIZARD ═══ */}
+      {wizardScreen === "connection" && (
+        <Box flexDirection="column" borderStyle="single" borderColor={theme.colors.border} paddingX={1} marginBottom={0}>
+          <Text bold color={theme.colors.secondary}>No LLM detected. How do you want to connect?</Text>
+          <Text>{""}</Text>
+          {[
+            { key: "local",      icon: "\uD83D\uDDA5\uFE0F",  label: "Set up a local model", desc: "free, runs on your machine" },
+            { key: "openrouter", icon: "\uD83C\uDF10", label: "OpenRouter", desc: "200+ cloud models, browser login" },
+            { key: "apikey",     icon: "\uD83D\uDD11", label: "Enter API key manually", desc: "" },
+            { key: "existing",   icon: "\u2699\uFE0F",  label: "I already have a server running", desc: "" },
+          ].map((item, i) => (
+            <Text key={item.key}>
+              {i === wizardIndex ? <Text color={theme.colors.suggestion} bold>{"  \u25B8 "}</Text> : <Text>{"    "}</Text>}
+              <Text color={i === wizardIndex ? theme.colors.suggestion : theme.colors.primary} bold>{item.icon}  {item.label}</Text>
+              {item.desc ? <Text color={theme.colors.muted}>{" ("}{item.desc}{")"}</Text> : null}
+            </Text>
+          ))}
+          <Text>{""}</Text>
+          <Text dimColor>{"  \u2191\u2193 navigate \u00B7 Enter to select"}</Text>
+        </Box>
+      )}
+
+      {wizardScreen === "models" && wizardHardware && (
+        <Box flexDirection="column" borderStyle="single" borderColor={theme.colors.border} paddingX={1} marginBottom={0}>
+          <Text bold color={theme.colors.secondary}>Your hardware:</Text>
+          <Text color={theme.colors.muted}>{"  CPU: "}{wizardHardware.cpu.name}{" ("}{wizardHardware.cpu.cores}{" cores)"}</Text>
+          <Text color={theme.colors.muted}>{"  RAM: "}{formatBytes(wizardHardware.ram)}</Text>
+          {wizardHardware.gpu ? (
+            <Text color={theme.colors.muted}>{"  GPU: "}{wizardHardware.gpu.name}{wizardHardware.gpu.vram > 0 ? ` (${formatBytes(wizardHardware.gpu.vram)})` : ""}</Text>
+          ) : (
+            <Text color={theme.colors.muted}>{"  GPU: none detected"}</Text>
+          )}
+          <Text>{""}</Text>
+          <Text bold color={theme.colors.secondary}>Recommended models:</Text>
+          <Text>{""}</Text>
+          {wizardModels.map((m, i) => (
+            <Text key={m.ollamaId}>
+              {i === wizardIndex ? <Text color={theme.colors.suggestion} bold>{"  \u25B8 "}</Text> : <Text>{"    "}</Text>}
+              <Text>{getFitIcon(m.fit)} </Text>
+              <Text color={i === wizardIndex ? theme.colors.suggestion : theme.colors.primary} bold>{m.name}</Text>
+              <Text color={theme.colors.muted}>{"     ~"}{m.size}{" GB \u00B7 "}{m.quality === "best" ? "Best" : m.quality === "great" ? "Great" : "Good"}{" quality \u00B7 "}{m.speed}</Text>
+            </Text>
+          ))}
+          {wizardModels.length === 0 && (
+            <Text color={theme.colors.error}>{"  No suitable models found for your hardware."}</Text>
+          )}
+          <Text>{""}</Text>
+          <Text dimColor>{"  \u2191\u2193 navigate \u00B7 Enter to install \u00B7 Esc back"}</Text>
+        </Box>
+      )}
+
+      {wizardScreen === "install-ollama" && (
+        <Box flexDirection="column" borderStyle="single" borderColor={theme.colors.warning} paddingX={1} marginBottom={0}>
+          <Text bold color={theme.colors.warning}>Ollama is required for local models.</Text>
+          <Text>{""}</Text>
+          <Text color={theme.colors.primary}>{"  Install with: "}<Text bold>{getOllamaInstallCommand(wizardHardware?.os ?? "linux")}</Text></Text>
+          <Text>{""}</Text>
+          <Text dimColor>{"  Run the command above, then press Enter to continue..."}</Text>
+          <Text dimColor>{"  Esc to go back"}</Text>
+        </Box>
+      )}
+
+      {wizardScreen === "pulling" && wizardSelectedModel && (
+        <Box flexDirection="column" borderStyle="single" borderColor={theme.colors.border} paddingX={1} marginBottom={0}>
+          {wizardPullError ? (
+            <>
+              <Text color={theme.colors.error} bold>{"  \u274C Error: "}{wizardPullError}</Text>
+              <Text>{""}</Text>
+              <Text dimColor>{"  Press Enter to retry \u00B7 Esc to go back"}</Text>
+            </>
+          ) : wizardPullProgress ? (
+            <>
+              <Text bold color={theme.colors.secondary}>{"  Downloading "}{wizardSelectedModel.name}{"..."}</Text>
+              {wizardPullProgress.status === "downloading" || wizardPullProgress.percent > 0 ? (
+                <>
+                  <Text>
+                    {"  "}
+                    <Text color={theme.colors.primary}>
+                      {"\u2588".repeat(Math.floor(wizardPullProgress.percent / 5))}
+                      {"\u2591".repeat(20 - Math.floor(wizardPullProgress.percent / 5))}
+                    </Text>
+                    {"  "}<Text bold>{wizardPullProgress.percent}%</Text>
+                    {wizardPullProgress.completed != null && wizardPullProgress.total != null ? (
+                      <Text color={theme.colors.muted}>{" \u00B7 "}{formatBytes(wizardPullProgress.completed)}{" / "}{formatBytes(wizardPullProgress.total)}</Text>
+                    ) : null}
+                  </Text>
+                </>
+              ) : (
+                <Text color={theme.colors.muted}>{"  "}{wizardPullProgress.status}...</Text>
+              )}
+            </>
+          ) : null}
+        </Box>
+      )}
+
       {/* ═══ COMMAND SUGGESTIONS ═══ */}
       {showSuggestions && (
         <Box flexDirection="column" borderStyle="single" borderColor={theme.colors.muted} paddingX={1} marginBottom={0}>

package/src/utils/hardware.ts

@@ -0,0 +1,131 @@
+import os from "os";
+import { execSync } from "child_process";
+
+export interface HardwareInfo {
+  cpu: { name: string; cores: number; speed: number };
+  ram: number; // bytes
+  gpu: { name: string; vram: number } | null; // vram in bytes, null if no GPU
+  os: "macos" | "linux" | "windows";
+  appleSilicon: boolean;
+}
+
+function getOS(): "macos" | "linux" | "windows" {
+  switch (process.platform) {
+    case "darwin": return "macos";
+    case "win32": return "windows";
+    default: return "linux";
+  }
+}
+
+function getCPU(): { name: string; cores: number; speed: number } {
+  const cpus = os.cpus();
+  return {
+    name: cpus[0]?.model?.trim() ?? "Unknown CPU",
+    cores: cpus.length,
+    speed: cpus[0]?.speed ?? 0, // MHz
+  };
+}
+
+function getGPU(platform: "macos" | "linux" | "windows"): { name: string; vram: number } | null {
+  try {
+    if (platform === "macos") {
+      const raw = execSync("system_profiler SPDisplaysDataType -json", {
+        encoding: "utf-8",
+        timeout: 5000,
+        stdio: ["pipe", "pipe", "pipe"],
+      });
+      const data = JSON.parse(raw);
+      const displays = data?.SPDisplaysDataType;
+      if (Array.isArray(displays) && displays.length > 0) {
+        const gpu = displays[0];
+        const name: string = gpu.sppci_model ?? gpu._name ?? "Unknown GPU";
+        // On Apple Silicon, VRAM is shared (unified memory) — report total RAM
+        const vramStr: string = gpu["spdisplays_vram"] ?? gpu["spdisplays_vram_shared"] ?? "";
+        let vram = 0;
+        if (vramStr) {
+          const match = vramStr.match(/(\d+)\s*(GB|MB)/i);
+          if (match) {
+            vram = parseInt(match[1]) * (match[2].toUpperCase() === "GB" ? 1024 * 1024 * 1024 : 1024 * 1024);
+          }
+        }
+        // Apple Silicon unified memory — use total RAM as VRAM
+        if (vram === 0 && name.toLowerCase().includes("apple")) {
+          vram = os.totalmem();
+        }
+        return { name, vram };
+      }
+    }
+
+    if (platform === "linux") {
+      // Try NVIDIA first
+      try {
+        const raw = execSync("nvidia-smi --query-gpu=name,memory.total --format=csv,noheader", {
+          encoding: "utf-8",
+          timeout: 5000,
+          stdio: ["pipe", "pipe", "pipe"],
+        });
+        const line = raw.trim().split("\n")[0];
+        if (line) {
+          const parts = line.split(",").map(s => s.trim());
+          const name = parts[0] ?? "NVIDIA GPU";
+          const memMatch = (parts[1] ?? "").match(/(\d+)/);
+          const vram = memMatch ? parseInt(memMatch[1]) * 1024 * 1024 : 0; // MiB to bytes
+          return { name, vram };
+        }
+      } catch {
+        // No NVIDIA, try lspci
+        try {
+          const raw = execSync("lspci | grep -i vga", {
+            encoding: "utf-8",
+            timeout: 5000,
+            stdio: ["pipe", "pipe", "pipe"],
+          });
+          const line = raw.trim().split("\n")[0];
+          if (line) {
+            const name = line.split(":").slice(2).join(":").trim() || "Unknown GPU";
+            return { name, vram: 0 };
+          }
+        } catch { /* no lspci */ }
+      }
+    }
+
+    if (platform === "windows") {
+      try {
+        const raw = execSync("wmic path win32_VideoController get Name,AdapterRAM /format:csv", {
+          encoding: "utf-8",
+          timeout: 5000,
+          stdio: ["pipe", "pipe", "pipe"],
+        });
+        const lines = raw.trim().split("\n").filter(l => l.trim() && !l.startsWith("Node"));
+        if (lines.length > 0) {
+          const parts = lines[0].split(",");
+          const adapterRAM = parseInt(parts[1] ?? "0");
+          const name = parts[2]?.trim() ?? "Unknown GPU";
+          return { name, vram: isNaN(adapterRAM) ? 0 : adapterRAM };
+        }
+      } catch { /* no wmic */ }
+    }
+  } catch {
+    // GPU detection failed
+  }
+  return null;
+}
+
+export function detectHardware(): HardwareInfo {
+  const platform = getOS();
+  const cpu = getCPU();
+  const ram = os.totalmem();
+  const gpu = getGPU(platform);
+
+  // Detect Apple Silicon
+  const appleSilicon = platform === "macos" && /apple\s+m/i.test(cpu.name);
+
+  return { cpu, ram, gpu, os: platform, appleSilicon };
+}
+
+/** Format bytes to human-readable string */
+export function formatBytes(bytes: number): string {
+  if (bytes >= 1024 * 1024 * 1024) return `${Math.round(bytes / (1024 * 1024 * 1024))} GB`;
+  if (bytes >= 1024 * 1024) return `${Math.round(bytes / (1024 * 1024))} MB`;
+  return `${Math.round(bytes / 1024)} KB`;
+}