codemaxxing 0.3.0 → 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/agent.d.ts

@@ -1,3 +1,4 @@
+import { type ConnectedServer } from "./utils/mcp.js";
 import type { ProviderConfig } from "./config.js";
 export interface AgentOptions {
     provider: ProviderConfig;
@@ -13,6 +14,7 @@ export interface AgentOptions {
     onContextCompressed?: (oldTokens: number, newTokens: number) => void;
     onArchitectPlan?: (plan: string) => void;
     onLintResult?: (file: string, errors: string) => void;
+    onMCPStatus?: (server: string, status: string) => void;
     contextCompressionThreshold?: number;
 }
 export declare class CodingAgent {
@@ -41,6 +43,7 @@ export declare class CodingAgent {
     private architectModel;
     private autoLintEnabled;
     private detectedLinter;
+    private mcpServers;
     constructor(options: AgentOptions);
     /**
      * Initialize the agent — call this after constructor to build async context
@@ -124,5 +127,9 @@ export declare class CodingAgent {
      * Run the architect model to generate a plan, then feed to editor model
      */
     private architectChat;
+    getMCPServerCount(): number;
+    getMCPServers(): ConnectedServer[];
+    disconnectMCP(): Promise<void>;
+    reconnectMCP(): Promise<void>;
     reset(): void;
 }

package/dist/agent.js

@@ -6,6 +6,7 @@ import { buildProjectContext, getSystemPrompt, loadProjectRules } from "./utils/
 import { isGitRepo, autoCommit } from "./utils/git.js";
 import { buildSkillPrompts, getActiveSkillCount } from "./utils/skills.js";
 import { createSession, saveMessage, updateTokenEstimate, updateSessionCost, loadMessages } from "./utils/sessions.js";
+import { loadMCPConfig, connectToServers, disconnectAll, getAllMCPTools, parseMCPToolName, callMCPTool } from "./utils/mcp.js";
 // Tools that can modify your project — require approval
 const DANGEROUS_TOOLS = new Set(["write_file", "run_command"]);
 // Cost per 1M tokens (input/output) for common models
@@ -78,6 +79,7 @@ export class CodingAgent {
     architectModel = null;
     autoLintEnabled = true;
     detectedLinter = null;
+    mcpServers = [];
     constructor(options) {
         this.options = options;
         this.providerType = options.provider.type || "openai";
@@ -113,6 +115,15 @@ export class CodingAgent {
         this.systemPrompt = await getSystemPrompt(context, skillPrompts, rules?.content ?? "");
         // Detect project linter
         this.detectedLinter = detectLinter(this.cwd);
+        // Connect to MCP servers
+        const mcpConfig = loadMCPConfig(this.cwd);
+        if (Object.keys(mcpConfig.mcpServers).length > 0) {
+            this.mcpServers = await connectToServers(mcpConfig, this.options.onMCPStatus);
+            if (this.mcpServers.length > 0) {
+                const mcpTools = getAllMCPTools(this.mcpServers);
+                this.tools = [...FILE_TOOLS, ...mcpTools];
+            }
+        }
         this.messages = [
             { role: "system", content: this.systemPrompt },
         ];
@@ -305,7 +316,15 @@ export class CodingAgent {
                         }
                     }
                 }
-                const result = await executeTool(toolCall.name, args, this.cwd);
+                // Route to MCP or built-in tool
+                const mcpParsed = parseMCPToolName(toolCall.name);
+                let result;
+                if (mcpParsed) {
+                    result = await callMCPTool(mcpParsed.serverName, mcpParsed.toolName, args);
+                }
+                else {
+                    result = await executeTool(toolCall.name, args, this.cwd);
+                }
                 this.options.onToolResult?.(toolCall.name, result);
                 // Auto-commit after successful write_file (only if enabled)
                 if (this.gitEnabled && this.autoCommitEnabled && toolCall.name === "write_file" && result.startsWith("✅")) {
@@ -502,7 +521,15 @@ export class CodingAgent {
                         }
                     }
                 }
-                const result = await executeTool(toolCall.name, args, this.cwd);
+                // Route to MCP or built-in tool
+                const mcpParsed = parseMCPToolName(toolCall.name);
+                let result;
+                if (mcpParsed) {
+                    result = await callMCPTool(mcpParsed.serverName, mcpParsed.toolName, args);
+                }
+                else {
+                    result = await executeTool(toolCall.name, args, this.cwd);
+                }
                 this.options.onToolResult?.(toolCall.name, result);
                 // Auto-commit after successful write_file
                 if (this.gitEnabled && this.autoCommitEnabled && toolCall.name === "write_file" && result.startsWith("✅")) {
@@ -738,6 +765,28 @@ export class CodingAgent {
         const editorPrompt = `## Architect Plan\n${plan}\n\n## Original Request\n${userMessage}\n\nExecute the plan above. Follow it step by step.`;
         return this.chat(editorPrompt);
     }
+    getMCPServerCount() {
+        return this.mcpServers.length;
+    }
+    getMCPServers() {
+        return this.mcpServers;
+    }
+    async disconnectMCP() {
+        await disconnectAll();
+        this.mcpServers = [];
+        this.tools = FILE_TOOLS;
+    }
+    async reconnectMCP() {
+        await this.disconnectMCP();
+        const mcpConfig = loadMCPConfig(this.cwd);
+        if (Object.keys(mcpConfig.mcpServers).length > 0) {
+            this.mcpServers = await connectToServers(mcpConfig, this.options.onMCPStatus);
+            if (this.mcpServers.length > 0) {
+                const mcpTools = getAllMCPTools(this.mcpServers);
+                this.tools = [...FILE_TOOLS, ...mcpTools];
+            }
+        }
+    }
     reset() {
         const systemMsg = this.messages[0];
         this.messages = [systemMsg];

package/dist/exec.js

@@ -6,6 +6,7 @@
  */
 import { CodingAgent } from "./agent.js";
 import { loadConfig, applyOverrides, detectLocalProvider } from "./config.js";
+import { disconnectAll } from "./utils/mcp.js";
 function parseExecArgs(argv) {
     const args = {
         prompt: "",
@@ -124,9 +125,16 @@ export async function runExec(argv) {
             process.stderr.write(`⚠ Denied ${name} (use --auto-approve to allow)\n`);
             return "no";
         },
+        onMCPStatus: (server, status) => {
+            process.stderr.write(`MCP ${server}: ${status}\n`);
+        },
     });
     try {
         await agent.init();
+        const mcpCount = agent.getMCPServerCount();
+        if (mcpCount > 0) {
+            process.stderr.write(`MCP: ${mcpCount} server${mcpCount > 1 ? "s" : ""} connected\n`);
+        }
         await agent.send(args.prompt);
         if (!args.json) {
             // Ensure newline at end of output
@@ -142,9 +150,11 @@ export async function runExec(argv) {
             };
             process.stdout.write(JSON.stringify(output, null, 2) + "\n");
         }
+        await disconnectAll();
         process.exit(hasChanges ? 0 : 2);
     }
     catch (err) {
+        await disconnectAll();
         process.stderr.write(`Error: ${err.message}\n`);
         if (args.json) {
             process.stdout.write(JSON.stringify({ error: err.message }, null, 2) + "\n");

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";
@@ -12,6 +12,10 @@ import { isGitRepo, getBranch, getStatus, getDiff, undoLastCommit } from "./util
 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) {
@@ -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" },
 ];
 const SPINNER_FRAMES = ["⣾", "⣽", "⣻", "⢿", "⡿", "⣟", "⣯", "⣷"];
@@ -131,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 }) => {
@@ -168,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;
             }
         }
@@ -246,6 +263,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) => {
@@ -262,6 +282,12 @@ function App() {
             info.push(`📋 ${rulesSource} loaded`);
             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 };
@@ -367,6 +393,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;
@@ -534,6 +565,71 @@ function App() {
             addMsg("info", "🔍 Auto-lint OFF");
             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 = [];
+            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.");
@@ -1029,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();
@@ -1259,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;