codemaxxing 0.3.1 → 0.4.0

package/README.md

@@ -12,34 +12,34 @@ Open-source terminal coding agent. Connect **any** LLM — local or remote — a
 
 Every coding agent locks you into their API. Codemaxxing doesn't. Run it with LM Studio, Ollama, OpenRouter, OpenAI, or any OpenAI-compatible endpoint. Your machine, your model, your rules.
 
-## Quick Install (Recommended)
+## Install
 
-**Linux / macOS:**
+**If you have Node.js:**
 ```bash
-bash -c "$(curl -fsSL https://raw.githubusercontent.com/MarcosV6/codemaxxing/main/install.sh)"
+npm install -g codemaxxing
 ```
 
-**Windows (PowerShell as Administrator):**
-```powershell
-curl -fsSL -o $env:TEMP\install-codemaxxing.bat https://raw.githubusercontent.com/MarcosV6/codemaxxing/main/install.bat; & $env:TEMP\install-codemaxxing.bat
+**If you don't have Node.js:**
+
+The one-line installers below will install Node.js first, then codemaxxing.
+
+*Linux / macOS:*
+```bash
+bash -c "$(curl -fsSL https://raw.githubusercontent.com/MarcosV6/codemaxxing/main/install.sh)"
 ```
 
-**Windows (CMD as Administrator):**
+*Windows (CMD as Administrator):*
 ```
 curl -fsSL -o %TEMP%\install-codemaxxing.bat https://raw.githubusercontent.com/MarcosV6/codemaxxing/main/install.bat && %TEMP%\install-codemaxxing.bat
 ```
 
-> **Note:** Restart your terminal after installation to ensure everything works.
-
-## Manual Installation
-
-**Prerequisites:** [Node.js](https://nodejs.org) 20 or later.
-
-**NPM:**
-```bash
-npm install -g codemaxxing
+*Windows (PowerShell as Administrator):*
+```powershell
+curl -fsSL -o $env:TEMP\install-codemaxxing.bat https://raw.githubusercontent.com/MarcosV6/codemaxxing/main/install.bat; & $env:TEMP\install-codemaxxing.bat
 ```
 
+> **Windows note:** If Node.js was just installed, you may need to close and reopen your terminal, then run `npm install -g codemaxxing` manually. This is a Windows PATH limitation.
+
 ## Updating
 
 ```bash

package/dist/index.js

@@ -1,5 +1,5 @@
 #!/usr/bin/env node
-import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { jsx as _jsx, jsxs as _jsxs, Fragment as _Fragment } from "react/jsx-runtime";
 import React, { useState, useEffect, useCallback } from "react";
 import { render, Box, Text, useInput, useApp, useStdout } from "ink";
 import { EventEmitter } from "events";
@@ -13,6 +13,9 @@ import { getTheme, listThemes, THEMES, DEFAULT_THEME } from "./themes.js";
 import { PROVIDERS, getCredentials, openRouterOAuth, anthropicSetupToken, importCodexToken, importQwenToken, copilotDeviceFlow } from "./utils/auth.js";
 import { listInstalledSkills, installSkill, removeSkill, getRegistrySkills, searchRegistry, createSkillScaffold, getActiveSkills, getActiveSkillCount } from "./utils/skills.js";
 import { listServers, addServer, removeServer, getConnectedServers } from "./utils/mcp.js";
+import { detectHardware, formatBytes } from "./utils/hardware.js";
+import { getRecommendations, getFitIcon } from "./utils/models.js";
+import { isOllamaInstalled, isOllamaRunning, getOllamaInstallCommand, startOllama, pullModel } from "./utils/ollama.js";
 const VERSION = "0.1.9";
 // ── Helpers ──
 function formatTimeAgo(date) {
@@ -137,6 +140,13 @@ function App() {
     const [skillsPickerIndex, setSkillsPickerIndex] = useState(0);
     const [sessionDisabledSkills, setSessionDisabledSkills] = useState(new Set());
     const [approval, setApproval] = useState(null);
+    const [wizardScreen, setWizardScreen] = useState(null);
+    const [wizardIndex, setWizardIndex] = useState(0);
+    const [wizardHardware, setWizardHardware] = useState(null);
+    const [wizardModels, setWizardModels] = useState([]);
+    const [wizardPullProgress, setWizardPullProgress] = useState(null);
+    const [wizardPullError, setWizardPullError] = useState(null);
+    const [wizardSelectedModel, setWizardSelectedModel] = useState(null);
     // Listen for paste events from stdin interceptor
     useEffect(() => {
         const handler = ({ content, lines }) => {
@@ -174,10 +184,11 @@ function App() {
             }
             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;
             }
         }
@@ -1114,6 +1125,223 @@ 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) => addMsg("info", msg))
+                            .then(() => {
+                            addMsg("info", "✅ OpenRouter authenticated! Use /connect to connect.");
+                            setLoading(false);
+                        })
+                            .catch((err) => { 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) {
+                                    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) {
+                                    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) {
+                                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();
@@ -1344,7 +1572,12 @@ function App() {
             })(), skillsPicker === "remove" && (() => {
                 const installed = listInstalledSkills();
                 return (_jsxs(Box, { flexDirection: "column", borderStyle: "single", borderColor: theme.colors.error, paddingX: 1, marginBottom: 0, children: [_jsx(Text, { bold: true, color: theme.colors.error, children: "Remove a skill:" }), installed.map((s, i) => (_jsxs(Text, { children: [i === skillsPickerIndex ? _jsx(Text, { color: theme.colors.suggestion, bold: true, children: "▸ " }) : _jsx(Text, { children: "  " }), _jsxs(Text, { color: i === skillsPickerIndex ? theme.colors.suggestion : theme.colors.muted, children: [s.name, " \u2014 ", s.description] })] }, s.name))), _jsx(Text, { dimColor: true, children: "  ↑↓ navigate · Enter remove · Esc back" })] }));
-            })(), themePicker && (_jsxs(Box, { flexDirection: "column", borderStyle: "single", borderColor: theme.colors.border, paddingX: 1, marginBottom: 0, children: [_jsx(Text, { bold: true, color: theme.colors.secondary, children: "Choose a theme:" }), listThemes().map((key, i) => (_jsxs(Text, { children: [i === themePickerIndex ? _jsx(Text, { color: theme.colors.suggestion, bold: true, children: "▸ " }) : _jsx(Text, { children: "  " }), _jsx(Text, { color: i === themePickerIndex ? theme.colors.suggestion : theme.colors.primary, bold: true, children: key }), _jsxs(Text, { color: theme.colors.muted, children: [" — ", THEMES[key].description] }), key === theme.name.toLowerCase() ? _jsx(Text, { color: theme.colors.muted, children: " (current)" }) : null] }, key))), _jsx(Text, { dimColor: true, children: "  ↑↓ navigate · Enter select · Esc cancel" })] })), sessionPicker && (_jsxs(Box, { flexDirection: "column", borderStyle: "single", borderColor: theme.colors.secondary, paddingX: 1, marginBottom: 0, children: [_jsx(Text, { bold: true, color: theme.colors.secondary, children: "Resume a session:" }), sessionPicker.map((s, i) => (_jsxs(Text, { children: [i === sessionPickerIndex ? _jsx(Text, { color: theme.colors.suggestion, bold: true, children: "▸ " }) : _jsx(Text, { children: "  " }), _jsx(Text, { color: i === sessionPickerIndex ? theme.colors.suggestion : theme.colors.muted, children: s.display })] }, s.id))), _jsx(Text, { dimColor: true, children: "  ↑↓ navigate · Enter select · Esc cancel" })] })), deleteSessionPicker && (_jsxs(Box, { flexDirection: "column", borderStyle: "single", borderColor: theme.colors.error, paddingX: 1, marginBottom: 0, children: [_jsx(Text, { bold: true, color: theme.colors.error, children: "Delete a session:" }), deleteSessionPicker.map((s, i) => (_jsxs(Text, { children: [i === deleteSessionPickerIndex ? _jsx(Text, { color: theme.colors.suggestion, bold: true, children: "▸ " }) : _jsx(Text, { children: "  " }), _jsx(Text, { color: i === deleteSessionPickerIndex ? theme.colors.suggestion : theme.colors.muted, children: s.display })] }, s.id))), _jsx(Text, { dimColor: true, children: "  ↑↓ navigate · Enter select · Esc cancel" })] })), deleteSessionConfirm && (_jsxs(Box, { flexDirection: "column", borderStyle: "single", borderColor: theme.colors.warning, paddingX: 1, marginBottom: 0, children: [_jsxs(Text, { bold: true, color: theme.colors.warning, children: ["Delete session ", deleteSessionConfirm.id, "?"] }), _jsxs(Text, { color: theme.colors.muted, children: ["  ", deleteSessionConfirm.display] }), _jsxs(Text, { children: [_jsx(Text, { color: theme.colors.error, bold: true, children: " [y]" }), _jsx(Text, { children: "es  " }), _jsx(Text, { color: theme.colors.success, bold: true, children: "[n]" }), _jsx(Text, { children: "o" })] })] })), showSuggestions && (_jsxs(Box, { flexDirection: "column", borderStyle: "single", borderColor: theme.colors.muted, paddingX: 1, marginBottom: 0, children: [cmdMatches.slice(0, 6).map((c, i) => (_jsxs(Text, { children: [i === cmdIndex ? _jsx(Text, { color: theme.colors.suggestion, bold: true, children: "▸ " }) : _jsx(Text, { children: "  " }), _jsx(Text, { color: i === cmdIndex ? theme.colors.suggestion : theme.colors.primary, bold: true, children: c.cmd }), _jsxs(Text, { color: theme.colors.muted, children: [" — ", c.desc] })] }, i))), _jsx(Text, { dimColor: true, children: "  ↑↓ navigate · Tab select" })] })), _jsxs(Box, { borderStyle: "single", borderColor: approval ? theme.colors.warning : theme.colors.border, paddingX: 1, children: [_jsx(Text, { color: theme.colors.secondary, bold: true, children: "> " }), approval ? (_jsx(Text, { color: theme.colors.warning, children: "waiting for approval..." })) : ready && !loading ? (_jsxs(Box, { children: [pastedChunks.map((p) => (_jsxs(Text, { color: theme.colors.muted, children: ["[Pasted text #", p.id, " +", p.lines, " lines]"] }, p.id))), _jsx(TextInput, { value: input, onChange: (v) => { setInput(v); setCmdIndex(0); }, onSubmit: handleSubmit }, inputKey)] })) : (_jsx(Text, { dimColor: true, children: loading ? "waiting for response..." : "initializing..." }))] }), agent && (_jsx(Box, { paddingX: 2, children: _jsxs(Text, { dimColor: true, children: ["💬 ", agent.getContextLength(), " messages · ~", (() => {
+            })(), themePicker && (_jsxs(Box, { flexDirection: "column", borderStyle: "single", borderColor: theme.colors.border, paddingX: 1, marginBottom: 0, children: [_jsx(Text, { bold: true, color: theme.colors.secondary, children: "Choose a theme:" }), listThemes().map((key, i) => (_jsxs(Text, { children: [i === themePickerIndex ? _jsx(Text, { color: theme.colors.suggestion, bold: true, children: "▸ " }) : _jsx(Text, { children: "  " }), _jsx(Text, { color: i === themePickerIndex ? theme.colors.suggestion : theme.colors.primary, bold: true, children: key }), _jsxs(Text, { color: theme.colors.muted, children: [" — ", THEMES[key].description] }), key === theme.name.toLowerCase() ? _jsx(Text, { color: theme.colors.muted, children: " (current)" }) : null] }, key))), _jsx(Text, { dimColor: true, children: "  ↑↓ navigate · Enter select · Esc cancel" })] })), sessionPicker && (_jsxs(Box, { flexDirection: "column", borderStyle: "single", borderColor: theme.colors.secondary, paddingX: 1, marginBottom: 0, children: [_jsx(Text, { bold: true, color: theme.colors.secondary, children: "Resume a session:" }), sessionPicker.map((s, i) => (_jsxs(Text, { children: [i === sessionPickerIndex ? _jsx(Text, { color: theme.colors.suggestion, bold: true, children: "▸ " }) : _jsx(Text, { children: "  " }), _jsx(Text, { color: i === sessionPickerIndex ? theme.colors.suggestion : theme.colors.muted, children: s.display })] }, s.id))), _jsx(Text, { dimColor: true, children: "  ↑↓ navigate · Enter select · Esc cancel" })] })), deleteSessionPicker && (_jsxs(Box, { flexDirection: "column", borderStyle: "single", borderColor: theme.colors.error, paddingX: 1, marginBottom: 0, children: [_jsx(Text, { bold: true, color: theme.colors.error, children: "Delete a session:" }), deleteSessionPicker.map((s, i) => (_jsxs(Text, { children: [i === deleteSessionPickerIndex ? _jsx(Text, { color: theme.colors.suggestion, bold: true, children: "▸ " }) : _jsx(Text, { children: "  " }), _jsx(Text, { color: i === deleteSessionPickerIndex ? theme.colors.suggestion : theme.colors.muted, children: s.display })] }, s.id))), _jsx(Text, { dimColor: true, children: "  ↑↓ navigate · Enter select · Esc cancel" })] })), deleteSessionConfirm && (_jsxs(Box, { flexDirection: "column", borderStyle: "single", borderColor: theme.colors.warning, paddingX: 1, marginBottom: 0, children: [_jsxs(Text, { bold: true, color: theme.colors.warning, children: ["Delete session ", deleteSessionConfirm.id, "?"] }), _jsxs(Text, { color: theme.colors.muted, children: ["  ", deleteSessionConfirm.display] }), _jsxs(Text, { children: [_jsx(Text, { color: theme.colors.error, bold: true, children: " [y]" }), _jsx(Text, { children: "es  " }), _jsx(Text, { color: theme.colors.success, bold: true, children: "[n]" }), _jsx(Text, { children: "o" })] })] })), wizardScreen === "connection" && (_jsxs(Box, { flexDirection: "column", borderStyle: "single", borderColor: theme.colors.border, paddingX: 1, marginBottom: 0, children: [_jsx(Text, { bold: true, color: theme.colors.secondary, children: "No LLM detected. How do you want to connect?" }), _jsx(Text, { children: "" }), [
+                        { 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) => (_jsxs(Text, { children: [i === wizardIndex ? _jsx(Text, { color: theme.colors.suggestion, bold: true, children: "  \u25B8 " }) : _jsx(Text, { children: "    " }), _jsxs(Text, { color: i === wizardIndex ? theme.colors.suggestion : theme.colors.primary, bold: true, children: [item.icon, "  ", item.label] }), item.desc ? _jsxs(Text, { color: theme.colors.muted, children: [" (", item.desc, ")"] }) : null] }, item.key))), _jsx(Text, { children: "" }), _jsx(Text, { dimColor: true, children: "  \u2191\u2193 navigate \u00B7 Enter to select" })] })), wizardScreen === "models" && wizardHardware && (_jsxs(Box, { flexDirection: "column", borderStyle: "single", borderColor: theme.colors.border, paddingX: 1, marginBottom: 0, children: [_jsx(Text, { bold: true, color: theme.colors.secondary, children: "Your hardware:" }), _jsxs(Text, { color: theme.colors.muted, children: ["  CPU: ", wizardHardware.cpu.name, " (", wizardHardware.cpu.cores, " cores)"] }), _jsxs(Text, { color: theme.colors.muted, children: ["  RAM: ", formatBytes(wizardHardware.ram)] }), wizardHardware.gpu ? (_jsxs(Text, { color: theme.colors.muted, children: ["  GPU: ", wizardHardware.gpu.name, wizardHardware.gpu.vram > 0 ? ` (${formatBytes(wizardHardware.gpu.vram)})` : ""] })) : (_jsx(Text, { color: theme.colors.muted, children: "  GPU: none detected" })), _jsx(Text, { children: "" }), _jsx(Text, { bold: true, color: theme.colors.secondary, children: "Recommended models:" }), _jsx(Text, { children: "" }), wizardModels.map((m, i) => (_jsxs(Text, { children: [i === wizardIndex ? _jsx(Text, { color: theme.colors.suggestion, bold: true, children: "  \u25B8 " }) : _jsx(Text, { children: "    " }), _jsxs(Text, { children: [getFitIcon(m.fit), " "] }), _jsx(Text, { color: i === wizardIndex ? theme.colors.suggestion : theme.colors.primary, bold: true, children: m.name }), _jsxs(Text, { color: theme.colors.muted, children: ["     ~", m.size, " GB \u00B7 ", m.quality === "best" ? "Best" : m.quality === "great" ? "Great" : "Good", " quality \u00B7 ", m.speed] })] }, m.ollamaId))), wizardModels.length === 0 && (_jsx(Text, { color: theme.colors.error, children: "  No suitable models found for your hardware." })), _jsx(Text, { children: "" }), _jsx(Text, { dimColor: true, children: "  \u2191\u2193 navigate \u00B7 Enter to install \u00B7 Esc back" })] })), wizardScreen === "install-ollama" && (_jsxs(Box, { flexDirection: "column", borderStyle: "single", borderColor: theme.colors.warning, paddingX: 1, marginBottom: 0, children: [_jsx(Text, { bold: true, color: theme.colors.warning, children: "Ollama is required for local models." }), _jsx(Text, { children: "" }), _jsxs(Text, { color: theme.colors.primary, children: ["  Install with: ", _jsx(Text, { bold: true, children: getOllamaInstallCommand(wizardHardware?.os ?? "linux") })] }), _jsx(Text, { children: "" }), _jsx(Text, { dimColor: true, children: "  Run the command above, then press Enter to continue..." }), _jsx(Text, { dimColor: true, children: "  Esc to go back" })] })), wizardScreen === "pulling" && wizardSelectedModel && (_jsx(Box, { flexDirection: "column", borderStyle: "single", borderColor: theme.colors.border, paddingX: 1, marginBottom: 0, children: wizardPullError ? (_jsxs(_Fragment, { children: [_jsxs(Text, { color: theme.colors.error, bold: true, children: ["  \u274C Error: ", wizardPullError] }), _jsx(Text, { children: "" }), _jsx(Text, { dimColor: true, children: "  Press Enter to retry \u00B7 Esc to go back" })] })) : wizardPullProgress ? (_jsxs(_Fragment, { children: [_jsxs(Text, { bold: true, color: theme.colors.secondary, children: ["  Downloading ", wizardSelectedModel.name, "..."] }), wizardPullProgress.status === "downloading" || wizardPullProgress.percent > 0 ? (_jsx(_Fragment, { children: _jsxs(Text, { children: ["  ", _jsxs(Text, { color: theme.colors.primary, children: ["\u2588".repeat(Math.floor(wizardPullProgress.percent / 5)), "\u2591".repeat(20 - Math.floor(wizardPullProgress.percent / 5))] }), "  ", _jsxs(Text, { bold: true, children: [wizardPullProgress.percent, "%"] }), wizardPullProgress.completed != null && wizardPullProgress.total != null ? (_jsxs(Text, { color: theme.colors.muted, children: [" \u00B7 ", formatBytes(wizardPullProgress.completed), " / ", formatBytes(wizardPullProgress.total)] })) : null] }) })) : (_jsxs(Text, { color: theme.colors.muted, children: ["  ", wizardPullProgress.status, "..."] }))] })) : null })), showSuggestions && (_jsxs(Box, { flexDirection: "column", borderStyle: "single", borderColor: theme.colors.muted, paddingX: 1, marginBottom: 0, children: [cmdMatches.slice(0, 6).map((c, i) => (_jsxs(Text, { children: [i === cmdIndex ? _jsx(Text, { color: theme.colors.suggestion, bold: true, children: "▸ " }) : _jsx(Text, { children: "  " }), _jsx(Text, { color: i === cmdIndex ? theme.colors.suggestion : theme.colors.primary, bold: true, children: c.cmd }), _jsxs(Text, { color: theme.colors.muted, children: [" — ", c.desc] })] }, i))), _jsx(Text, { dimColor: true, children: "  ↑↓ navigate · Tab select" })] })), _jsxs(Box, { borderStyle: "single", borderColor: approval ? theme.colors.warning : theme.colors.border, paddingX: 1, children: [_jsx(Text, { color: theme.colors.secondary, bold: true, children: "> " }), approval ? (_jsx(Text, { color: theme.colors.warning, children: "waiting for approval..." })) : ready && !loading ? (_jsxs(Box, { children: [pastedChunks.map((p) => (_jsxs(Text, { color: theme.colors.muted, children: ["[Pasted text #", p.id, " +", p.lines, " lines]"] }, p.id))), _jsx(TextInput, { value: input, onChange: (v) => { setInput(v); setCmdIndex(0); }, onSubmit: handleSubmit }, inputKey)] })) : (_jsx(Text, { dimColor: true, children: loading ? "waiting for response..." : "initializing..." }))] }), agent && (_jsx(Box, { paddingX: 2, children: _jsxs(Text, { dimColor: true, children: ["💬 ", agent.getContextLength(), " messages · ~", (() => {
                             const tokens = agent.estimateTokens();
                             return tokens >= 1000 ? `${(tokens / 1000).toFixed(1)}k` : String(tokens);
                         })(), " tokens", (() => {

package/dist/utils/hardware.d.ts

@@ -0,0 +1,17 @@
+export interface HardwareInfo {
+    cpu: {
+        name: string;
+        cores: number;
+        speed: number;
+    };
+    ram: number;
+    gpu: {
+        name: string;
+        vram: number;
+    } | null;
+    os: "macos" | "linux" | "windows";
+    appleSilicon: boolean;
+}
+export declare function detectHardware(): HardwareInfo;
+/** Format bytes to human-readable string */
+export declare function formatBytes(bytes: number): string;

package/dist/utils/hardware.js

@@ -0,0 +1,120 @@
+import os from "os";
+import { execSync } from "child_process";
+function getOS() {
+    switch (process.platform) {
+        case "darwin": return "macos";
+        case "win32": return "windows";
+        default: return "linux";
+    }
+}
+function getCPU() {
+    const cpus = os.cpus();
+    return {
+        name: cpus[0]?.model?.trim() ?? "Unknown CPU",
+        cores: cpus.length,
+        speed: cpus[0]?.speed ?? 0, // MHz
+    };
+}
+function getGPU(platform) {
+    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 = gpu.sppci_model ?? gpu._name ?? "Unknown GPU";
+                // On Apple Silicon, VRAM is shared (unified memory) — report total RAM
+                const vramStr = 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() {
+    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) {
+    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`;
+}

package/dist/utils/models.d.ts

@@ -0,0 +1,17 @@
+import type { HardwareInfo } from "./hardware.js";
+export interface RecommendedModel {
+    name: string;
+    ollamaId: string;
+    size: number;
+    ramRequired: number;
+    vramOptimal: number;
+    description: string;
+    speed: string;
+    quality: "good" | "great" | "best";
+}
+export type ModelFit = "perfect" | "good" | "tight" | "skip";
+export interface ScoredModel extends RecommendedModel {
+    fit: ModelFit;
+}
+export declare function getRecommendations(hardware: HardwareInfo): ScoredModel[];
+export declare function getFitIcon(fit: ModelFit): string;

package/dist/utils/models.js

@@ -0,0 +1,113 @@
+const MODELS = [
+    {
+        name: "Qwen 2.5 Coder 3B",
+        ollamaId: "qwen2.5-coder:3b",
+        size: 2,
+        ramRequired: 8,
+        vramOptimal: 4,
+        description: "Lightweight, fast coding model",
+        speed: "~60 tok/s on M1",
+        quality: "good",
+    },
+    {
+        name: "Qwen 2.5 Coder 7B",
+        ollamaId: "qwen2.5-coder:7b",
+        size: 5,
+        ramRequired: 16,
+        vramOptimal: 8,
+        description: "Sweet spot for most machines",
+        speed: "~45 tok/s on M1",
+        quality: "great",
+    },
+    {
+        name: "Qwen 2.5 Coder 14B",
+        ollamaId: "qwen2.5-coder:14b",
+        size: 9,
+        ramRequired: 32,
+        vramOptimal: 16,
+        description: "High quality coding",
+        speed: "~25 tok/s on M1 Pro",
+        quality: "best",
+    },
+    {
+        name: "Qwen 2.5 Coder 32B",
+        ollamaId: "qwen2.5-coder:32b",
+        size: 20,
+        ramRequired: 48,
+        vramOptimal: 32,
+        description: "Premium quality, needs lots of RAM",
+        speed: "~12 tok/s on M1 Max",
+        quality: "best",
+    },
+    {
+        name: "DeepSeek Coder V2 16B",
+        ollamaId: "deepseek-coder-v2:16b",
+        size: 9,
+        ramRequired: 32,
+        vramOptimal: 16,
+        description: "Strong alternative for coding",
+        speed: "~30 tok/s on M1 Pro",
+        quality: "great",
+    },
+    {
+        name: "CodeLlama 7B",
+        ollamaId: "codellama:7b",
+        size: 4,
+        ramRequired: 16,
+        vramOptimal: 8,
+        description: "Meta's coding model",
+        speed: "~40 tok/s on M1",
+        quality: "good",
+    },
+    {
+        name: "StarCoder2 7B",
+        ollamaId: "starcoder2:7b",
+        size: 4,
+        ramRequired: 16,
+        vramOptimal: 8,
+        description: "Good for code completion",
+        speed: "~40 tok/s on M1",
+        quality: "good",
+    },
+];
+function scoreModel(model, ramGB, vramGB) {
+    if (ramGB < model.ramRequired)
+        return "skip";
+    const ramHeadroom = ramGB - model.ramRequired;
+    const hasGoodVRAM = vramGB >= model.vramOptimal;
+    if (hasGoodVRAM && ramHeadroom >= 4)
+        return "perfect";
+    if (hasGoodVRAM || ramHeadroom >= 8)
+        return "good";
+    if (ramHeadroom >= 0)
+        return "tight";
+    return "skip";
+}
+const qualityOrder = { best: 3, great: 2, good: 1 };
+const fitOrder = { perfect: 4, good: 3, tight: 2, skip: 1 };
+export function getRecommendations(hardware) {
+    const ramGB = hardware.ram / (1024 * 1024 * 1024);
+    const vramGB = hardware.gpu?.vram ? hardware.gpu.vram / (1024 * 1024 * 1024) : 0;
+    // Apple Silicon uses unified memory — VRAM = RAM
+    const effectiveVRAM = hardware.appleSilicon ? ramGB : vramGB;
+    const scored = MODELS.map((m) => ({
+        ...m,
+        fit: scoreModel(m, ramGB, effectiveVRAM),
+    }));
+    // Sort: perfect first, then by quality descending
+    scored.sort((a, b) => {
+        const fitDiff = (fitOrder[b.fit] ?? 0) - (fitOrder[a.fit] ?? 0);
+        if (fitDiff !== 0)
+            return fitDiff;
+        return (qualityOrder[b.quality] ?? 0) - (qualityOrder[a.quality] ?? 0);
+    });
+    return scored;
+}
+export function getFitIcon(fit) {
+    switch (fit) {
+        case "perfect": return "\u2B50"; // ⭐
+        case "good": return "\u2705"; // ✅
+        case "tight": return "\u26A0\uFE0F"; // ⚠️
+        case "skip": return "\u274C"; // ❌
+    }
+}

package/dist/utils/ollama.d.ts

@@ -0,0 +1,22 @@
+/** Check if ollama binary exists on PATH */
+export declare function isOllamaInstalled(): boolean;
+/** Check if ollama server is responding */
+export declare function isOllamaRunning(): Promise<boolean>;
+/** Get the install command for the user's OS */
+export declare function getOllamaInstallCommand(os: "macos" | "linux" | "windows"): string;
+/** Start ollama serve in background */
+export declare function startOllama(): void;
+export interface PullProgress {
+    status: string;
+    total?: number;
+    completed?: number;
+    percent: number;
+}
+/**
+ * Pull a model from Ollama registry.
+ * Calls onProgress with download updates.
+ * Returns a promise that resolves when complete.
+ */
+export declare function pullModel(modelId: string, onProgress?: (progress: PullProgress) => void): Promise<void>;
+/** List models installed in Ollama */
+export declare function listInstalledModels(): Promise<string[]>;