pudu-ai 0.2.3 → 0.2.5

package/README.md

@@ -43,6 +43,8 @@ npx pudu-ai hardware
 npx pudu-ai models
 npx pudu-ai models add-path ~/Models
 npx pudu-ai recommend
+npx pudu-ai recommend --install --yes
+npx pudu-ai recommend --link opencode --yes
 npx pudu-ai tasks
 npx pudu-ai tasks --for code,image,transcription --lang es
 npx pudu-ai benchmark

package/dist/cli/index.js

@@ -29,6 +29,7 @@ function parseArgs(argv) {
   const forIndex = args2.findIndex((a) => a === "--for");
   const scopeIndex = args2.findIndex((a) => a === "--scope");
   const priorityIndex = args2.findIndex((a) => a === "--priority");
+  const linkIndex = args2.findIndex((a) => a === "--link");
   return {
     command: isKnown ? command : "dashboard",
     positional: isKnown ? rest.slice(1) : rest,
@@ -45,7 +46,9 @@ function parseArgs(argv) {
     forKinds: forIndex >= 0 ? args2[forIndex + 1] : void 0,
     scope: scopeIndex >= 0 ? args2[scopeIndex + 1] : void 0,
     priority: priorityIndex >= 0 ? args2[priorityIndex + 1] : void 0,
-    yes: flags.has("--yes")
+    yes: flags.has("--yes"),
+    install: flags.has("--install"),
+    link: linkIndex >= 0 ? args2[linkIndex + 1] : void 0
   };
 }
 
@@ -843,6 +846,14 @@ var en = {
   compatible: "COMPATIBLE (catalog, estimated)",
   recommended: "RECOMMENDED FOR THIS MACHINE",
   recommendedHint: "Estimated values come from CanIRun.ai by midudev (canirun.ai \xB7 midu.dev) or a local fallback \u2014 not measured",
+  recommendKeys: "[\u2191\u2193] model  [I] ollama pull if grade S\u2013B  [O] OpenCode  [E] Hermes  [W] OpenClaw  [Esc] back",
+  recommendCliHint: "Install: npx pudu-ai recommend --install --yes   Link: npx pudu-ai recommend --link opencode --yes",
+  agentsTitle: "CODING AGENTS",
+  agentMissing: "not installed \u2014 select to install via ollama launch if the model is eligible",
+  installGradeBlock: "Grade {grade} is too low to pull. Need S, A, or B.",
+  linkingTool: "Linking {tool} with {model}\u2026",
+  modelPulled: "Pulled {model} with Ollama.",
+  installNone: "No recommended model has grade S\u2013B to install.",
   credits: "Measured: llama-bench + OS telemetry. Estimated: CanIRun.ai by midudev (https://canirun.ai, https://github.com/midudev/canirun.ai, https://midu.dev). Labelled separately; never mixed.",
   noModels: "No local models detected",
   notTested: "Not tested",
@@ -950,6 +961,8 @@ Usage:
   npx pudu-ai models
   npx pudu-ai models add-path ~/Models
   npx pudu-ai recommend
+  npx pudu-ai recommend --install --yes
+  npx pudu-ai recommend --link opencode --yes
   npx pudu-ai tasks
   npx pudu-ai tasks --for code,image --scope all --priority speed
   npx pudu-ai benchmark [model]
@@ -1005,6 +1018,14 @@ var es = {
   compatible: "COMPATIBLES (cat\xE1logo, estimado)",
   recommended: "RECOMENDADOS PARA ESTE EQUIPO",
   recommendedHint: "Los valores estimados vienen de CanIRun.ai de midudev (canirun.ai \xB7 midu.dev) o de un fallback local \u2014 no son mediciones",
+  recommendKeys: "[\u2191\u2193] modelo  [I] ollama pull si nota S\u2013B  [O] OpenCode  [E] Hermes  [W] OpenClaw  [Esc] atr\xE1s",
+  recommendCliHint: "Instalar: npx pudu-ai recommend --install --yes   Vincular: npx pudu-ai recommend --link opencode --yes",
+  agentsTitle: "AGENTES DE C\xD3DIGO",
+  agentMissing: "no instalado \u2014 selecci\xF3nalo para instalar con ollama launch si el modelo es elegible",
+  installGradeBlock: "La nota {grade} es baja para hacer pull. Hace falta S, A o B.",
+  linkingTool: "Vinculando {tool} con {model}\u2026",
+  modelPulled: "Descargado {model} con Ollama.",
+  installNone: "Ning\xFAn modelo recomendado tiene nota S\u2013B para instalar.",
   credits: "Medido: llama-bench + telemetr\xEDa del SO. Estimado: CanIRun.ai de midudev (https://canirun.ai, https://github.com/midudev/canirun.ai, https://midu.dev). Se etiquetan por separado; nunca se mezclan.",
   noModels: "No se detectaron modelos locales",
   notTested: "Sin probar",
@@ -1112,6 +1133,8 @@ Uso:
   npx pudu-ai models
   npx pudu-ai models add-path ~/Models
   npx pudu-ai recommend
+  npx pudu-ai recommend --install --yes
+  npx pudu-ai recommend --link opencode --yes
   npx pudu-ai tasks
   npx pudu-ai tasks --for code,image --scope all --priority speed
   npx pudu-ai benchmark [model]
@@ -1358,15 +1381,33 @@ async function listBenchmarks() {
   return records;
 }
 
+// src/integrations/agents.ts
+var AGENTS = [
+  { id: "opencode", label: "OpenCode", bin: "opencode" },
+  { id: "hermes", label: "Hermes", bin: "hermes" },
+  { id: "openclaw", label: "OpenClaw", bin: "openclaw" }
+];
+async function detectAgents() {
+  const out = [];
+  for (const agent of AGENTS) {
+    out.push({
+      ...agent,
+      detected: Boolean(await commandExists(agent.bin))
+    });
+  }
+  return out;
+}
+
 // src/session/load.ts
 async function loadSession(options) {
   const hardware = await detectHardware();
-  const [runtimes2, models, catalogState, history, llamaBench] = await Promise.all([
+  const [runtimes2, models, catalogState, history, llamaBench, agents] = await Promise.all([
     detectRuntimes(),
     discoverLocalModels(),
     loadCatalog(options.network),
     listBenchmarks(),
-    commandExists("llama-bench").then(Boolean)
+    commandExists("llama-bench").then(Boolean),
+    detectAgents()
   ]);
   const rows = [];
   for (const local of models) {
@@ -1385,7 +1426,8 @@ async function loadSession(options) {
     recommendations,
     history,
     llamaBench,
-    networkUsed: catalogState.networkUsed
+    networkUsed: catalogState.networkUsed,
+    agents
   };
 }
 
@@ -1885,8 +1927,8 @@ function setLogLevel(next) {
 import { render } from "ink";
 
 // src/tui/App.tsx
-import { Box as Box9, Text as Text9, useApp, useInput as useInput3 } from "ink";
-import { useMemo as useMemo2, useState as useState3 } from "react";
+import { Box as Box9, Text as Text9, useApp as useApp2, useInput as useInput4 } from "ink";
+import { useMemo as useMemo2, useState as useState4 } from "react";
 
 // src/tui/views/Dashboard.tsx
 import { Box, Text } from "ink";
@@ -1924,6 +1966,27 @@ var GRADE_MEANING = {
   F: "Not recommended"
 };
 
+// src/tui/theme.ts
+function gradeColor(grade) {
+  if (grade === "S" || grade === "A") return "green";
+  if (grade === "B") return "yellow";
+  if (grade === "C") return "magenta";
+  if (grade === "D" || grade === "F") return "red";
+  return "gray";
+}
+function bar(percent, width = 10) {
+  if (percent === void 0 || Number.isNaN(percent)) return `${"\u2591".repeat(width)} N/A`;
+  const filled = Math.max(0, Math.min(width, Math.round(percent / 100 * width)));
+  return `${"\u2588".repeat(filled)}${"\u2591".repeat(width - filled)}`;
+}
+function sparkline(values, width = 24) {
+  const glyphs = ["\u2581", "\u2582", "\u2583", "\u2584", "\u2585", "\u2586", "\u2587", "\u2588"];
+  if (!values.length) return glyphs[0].repeat(width);
+  const slice = values.slice(-width);
+  const max = Math.max(...slice, 1);
+  return slice.map((v) => glyphs[Math.min(glyphs.length - 1, Math.floor(v / max * (glyphs.length - 1)))]).join("").padStart(width, glyphs[0]);
+}
+
 // src/tui/views/Dashboard.tsx
 import { jsx, jsxs } from "react/jsx-runtime";
 function Dashboard({ session }) {
@@ -1963,7 +2026,7 @@ function Dashboard({ session }) {
     ] }),
     /* @__PURE__ */ jsxs(Box, { marginTop: 1, flexDirection: "column", children: [
       /* @__PURE__ */ jsx(Text, { bold: true, color: "cyan", children: t("runtimes") }),
-      session.runtimes.map((r) => /* @__PURE__ */ jsxs(Text, { children: [
+      session.runtimes.map((r) => /* @__PURE__ */ jsxs(Text, { color: r.detected ? "green" : "gray", children: [
         r.detected ? "\u2713" : "\u25CB",
         " ",
         r.label.padEnd(14),
@@ -1975,12 +2038,12 @@ function Dashboard({ session }) {
       /* @__PURE__ */ jsx(Text, { bold: true, color: "cyan", children: t("installedModels") }),
       session.rows.length === 0 && /* @__PURE__ */ jsx(Text, { dimColor: true, children: t("noModels") }),
       session.rows.map((row) => /* @__PURE__ */ jsxs(Text, { children: [
-        row.local.name.padEnd(20),
+        /* @__PURE__ */ jsx(Text, { color: "green", children: row.local.name.padEnd(20) }),
         " ",
         row.local.sizeBytes ? formatBytes(row.local.sizeBytes) : "N/A",
-        "  ",
-        row.compatibility?.grade ?? "\u2014",
-        "  ",
+        " ",
+        /* @__PURE__ */ jsx(Text, { color: gradeColor(row.compatibility?.grade), bold: true, children: row.compatibility?.grade ?? "\u2014" }),
+        " ",
         row.lastBenchmark?.benchmark.generationTokensPerSecond ? formatTokensPerSec(row.lastBenchmark.benchmark.generationTokensPerSecond) : t("notTested")
       ] }, row.local.id))
     ] }),
@@ -1988,11 +2051,11 @@ function Dashboard({ session }) {
       /* @__PURE__ */ jsx(Text, { bold: true, color: "cyan", children: t("recommended") }),
       /* @__PURE__ */ jsx(Text, { dimColor: true, children: t("recommendedHint") }),
       session.recommendations.map((rec) => /* @__PURE__ */ jsxs(Text, { children: [
-        rec.useCase.padEnd(12),
+        /* @__PURE__ */ jsx(Text, { color: "magenta", children: rec.useCase.padEnd(12) }),
         " ",
         rec.model.name.padEnd(22),
         " ",
-        rec.grade,
+        /* @__PURE__ */ jsx(Text, { color: gradeColor(rec.grade), bold: true, children: rec.grade }),
         " ",
         GRADE_MEANING[rec.grade]
       ] }, `${rec.useCase}-${rec.model.id}`)),
@@ -2004,13 +2067,31 @@ function Dashboard({ session }) {
 // src/tui/views/Models.tsx
 import { Box as Box2, Text as Text2 } from "ink";
 
+// src/cli/color.ts
+var enabled = () => !process.env.NO_COLOR && process.stdout.isTTY;
+var wrap = (open, close = 39) => (text) => enabled() ? `\x1B[${open}m${text}\x1B[${close}m` : text;
+var cyan = wrap(36);
+var green = wrap(32);
+var yellow = wrap(33);
+var red = wrap(31);
+var magenta = wrap(35);
+var bold = wrap(1, 22);
+var dim = wrap(2, 22);
+function gradeAnsi(grade) {
+  if (grade === "S" || grade === "A") return green(grade);
+  if (grade === "B") return yellow(grade);
+  if (grade === "C") return magenta(grade);
+  if (grade === "D" || grade === "F") return red(grade);
+  return grade;
+}
+
 // src/cli/text.ts
 function hardwareText(session) {
   const h = session.hardware;
   const ram = formatBytes(h.memory.totalBytes, 0);
   const avail = h.memory.availableBytes ? formatBytes(h.memory.availableBytes) : "N/A";
   return [
-    t("machine"),
+    bold(cyan(t("machine"))),
     `  ${h.machineModel ?? t("unknownMachine")}`,
     `  ${h.cpu.name ?? t("cpuNa")}`,
     `  CPU           ${h.cpu.physicalCores ?? "N/A"} cores (${h.cpu.performanceCores ?? "?"}P / ${h.cpu.efficiencyCores ?? "?"}E)`,
@@ -2022,18 +2103,22 @@ function hardwareText(session) {
 }
 function runtimesText(session) {
   return [
-    t("runtimes"),
-    ...session.runtimes.map((r) => `  ${r.detected ? "\u2713" : "\u25CB"} ${r.label.padEnd(14)} ${r.detected ? r.version ?? t("detected") : t("notDetected")}`)
+    bold(cyan(t("runtimes"))),
+    ...session.runtimes.map((r) => {
+      const mark = r.detected ? green("\u2713") : dim("\u25CB");
+      const state = r.detected ? green(r.version ?? t("detected")) : dim(t("notDetected"));
+      return `  ${mark} ${r.label.padEnd(14)} ${state}`;
+    })
   ].join("\n");
 }
 function modelsText(session) {
-  const lines = [t("installedModels"), "MODEL                 INSTALLED   FIT       EST. SPEED     MEASURED"];
+  const lines = [bold(cyan(t("installedModels"))), dim("MODEL                 INSTALLED   FIT       EST. SPEED     MEASURED")];
   for (const row of session.rows) {
     const fit = row.compatibility?.grade ?? "\u2014";
     const est = row.compatibility?.estimatedTokensPerSecond ? `~${formatNumber(row.compatibility.estimatedTokensPerSecond)} t/s` : "\u2014";
     const measured = row.lastBenchmark?.benchmark.generationTokensPerSecond ? formatTokensPerSec(row.lastBenchmark.benchmark.generationTokensPerSecond) : t("notTested");
     lines.push(
-      `${row.local.name.padEnd(22)} \u2713           ${fit.padEnd(9)} ${est.padEnd(14)} ${measured}`
+      `${green(row.local.name.padEnd(22))} \u2713           ${gradeAnsi(fit).padEnd(9)} ${est.padEnd(14)} ${measured}`
     );
   }
   lines.push("", t("compatible"));
@@ -2045,12 +2130,19 @@ function modelsText(session) {
   return lines.join("\n");
 }
 function recommendText(session) {
-  const lines = [t("recommended"), t("recommendedHint"), "", t("credits"), ""];
+  const lines = [bold(cyan(t("recommended"))), dim(t("recommendedHint")), "", dim(t("credits")), ""];
   for (const rec of session.recommendations) {
     lines.push(
-      `${rec.useCase.padEnd(12)} ${rec.model.name.padEnd(22)} ${rec.grade}  ${GRADE_MEANING[rec.grade]}  ~${na(rec.estimatedTokensPerSecond)} t/s est.`
+      `${magenta(rec.useCase.padEnd(12))} ${rec.model.name.padEnd(22)} ${gradeAnsi(rec.grade)}  ${GRADE_MEANING[rec.grade]}  ~${na(rec.estimatedTokensPerSecond)} t/s est.`
+    );
+  }
+  lines.push("", bold(yellow(t("agentsTitle"))));
+  for (const agent of session.agents) {
+    lines.push(
+      `  ${agent.detected ? green("\u2713") : dim("\u25CB")} ${agent.label.padEnd(12)} ${agent.detected ? green(t("detected")) : dim(t("agentMissing"))}`
     );
   }
+  lines.push("", dim(t("recommendCliHint")));
   return lines.join("\n");
 }
 function historyText(records) {
@@ -2086,6 +2178,7 @@ function doctorText(session) {
     `${session.hardware.gpu.metal ? "\u2713" : "\u25CB"} Metal`,
     ...session.runtimes.map((r) => `${r.detected ? "\u2713" : "\u25CB"} ${r.label.padEnd(14)} ${r.version ?? ""}`.trimEnd()),
     `${session.networkUsed ? "\u2713" : "\u25CB"} CanIRun.ai (midudev)`,
+    ...session.agents.map((a) => `${a.detected ? "\u2713" : "\u25CB"} ${a.label.padEnd(14)} ${a.detected ? t("detected") : t("agentMissing")}`),
     "",
     session.llamaBench ? t("doctorReady", { count: session.models.filter((m) => m.artifactPath).length }) : t("doctorNoBench")
   ];
@@ -2186,10 +2279,264 @@ function HardwareView({ session }) {
 }
 
 // src/tui/views/Recommend.tsx
-import { Box as Box4, Text as Text4 } from "ink";
-import { jsx as jsx4 } from "react/jsx-runtime";
+import { Box as Box4, Text as Text4, useApp, useInput } from "ink";
+import { useState } from "react";
+
+// src/integrations/catalog.ts
+var INTEGRATIONS = {
+  opencode: {
+    id: "opencode",
+    docsUrl: "https://docs.ollama.com/integrations/opencode",
+    ollamaLaunch: "opencode",
+    minGenerationTps: 12,
+    allowedGrades: ["S", "A", "B"],
+    useCases: ["code", "chat", "reasoning"]
+  },
+  openclaw: {
+    id: "openclaw",
+    docsUrl: "https://docs.ollama.com/integrations/openclaw",
+    ollamaLaunch: "openclaw",
+    minGenerationTps: 12,
+    allowedGrades: ["S", "A", "B"],
+    useCases: ["code", "chat", "reasoning"]
+  },
+  hermes: {
+    id: "hermes",
+    docsUrl: "https://docs.ollama.com/integrations/hermes",
+    ollamaLaunch: "hermes",
+    minGenerationTps: 12,
+    allowedGrades: ["S", "A"],
+    useCases: ["code", "chat", "reasoning"]
+  },
+  claude: {
+    id: "claude",
+    docsUrl: "https://docs.ollama.com/integrations/claude-code",
+    ollamaLaunch: "claude",
+    minGenerationTps: 12,
+    allowedGrades: ["S", "A", "B"],
+    useCases: ["code", "chat", "reasoning"]
+  }
+};
+
+// src/integrations/types.ts
+var INTEGRATION_IDS = ["opencode", "openclaw", "hermes", "claude"];
+
+// src/integrations/decide.ts
+var GRADE_RANK = { S: 5, A: 4, B: 3, C: 2, D: 1, F: 0 };
+function toOllamaTag(id) {
+  const compact = id.toLowerCase().replace(/_/g, "-");
+  const match = compact.match(/^([a-z0-9.]+(?:-[a-z0-9.]+)*)-(\d+(?:\.\d+)?b)$/i);
+  if (match) return `${match[1]}:${match[2]}`;
+  if (compact.includes(":")) return compact;
+  return compact;
+}
+function useCaseOk(useCases, needed) {
+  if (!useCases?.length) return needed.includes("chat");
+  return useCases.some((u) => needed.some((n) => u.includes(n)));
+}
+function decideLaunch(session, id) {
+  const def = INTEGRATIONS[id];
+  const reasons = [];
+  const ollama = session.runtimes.find((r) => r.id === "ollama")?.detected;
+  if (!ollama) reasons.push(t("launchNeedOllama"));
+  const candidates = [];
+  for (const row of session.rows) {
+    const useCases = row.catalog?.useCase ?? ["chat", "code"];
+    if (!useCaseOk(useCases, def.useCases)) continue;
+    const tps = row.lastBenchmark?.benchmark.generationTokensPerSecond;
+    candidates.push({
+      modelId: row.local.id,
+      ollamaTag: row.local.id.includes(":") ? row.local.id : toOllamaTag(row.local.id),
+      installed: true,
+      origin: row.lastBenchmark ? "measured" : "estimated",
+      grade: row.compatibility?.grade,
+      tps
+    });
+  }
+  if (!candidates.length) {
+    for (const model of session.catalog) {
+      if (!useCaseOk(model.useCase, def.useCases)) continue;
+      const fit = localCompatibility(session.hardware, model);
+      if (!def.allowedGrades.includes(fit.grade)) continue;
+      candidates.push({
+        modelId: model.id,
+        ollamaTag: toOllamaTag(model.id),
+        installed: false,
+        origin: "estimated",
+        grade: fit.grade
+      });
+    }
+  }
+  candidates.sort((a, b) => {
+    if (a.installed !== b.installed) return a.installed ? -1 : 1;
+    return (GRADE_RANK[b.grade ?? "F"] ?? 0) - (GRADE_RANK[a.grade ?? "F"] ?? 0);
+  });
+  const pick = candidates[0];
+  if (!pick) reasons.push(t("launchNoModel"));
+  if (pick?.grade && !def.allowedGrades.includes(pick.grade)) {
+    reasons.push(t("launchGradeFail", { grade: pick.grade, allowed: def.allowedGrades.join(",") }));
+  }
+  if (pick?.origin === "measured" && pick.tps !== void 0 && pick.tps < def.minGenerationTps) {
+    reasons.push(t("launchSlowFail", { tps: pick.tps.toFixed(1), min: def.minGenerationTps }));
+  }
+  if (pick && pick.origin === "estimated" && (!pick.grade || GRADE_RANK[pick.grade] < GRADE_RANK.B)) {
+    reasons.push(t("launchEstimateWeak"));
+  }
+  const eligible = Boolean(ollama && pick && reasons.length === 0);
+  const command = pick ? `ollama launch ${def.ollamaLaunch} --model ${pick.ollamaTag}` : `ollama launch ${def.ollamaLaunch}`;
+  return {
+    integration: id,
+    docsUrl: def.docsUrl,
+    eligible,
+    reasons: eligible ? [t("launchOk")] : reasons,
+    modelId: pick?.modelId,
+    ollamaTag: pick?.ollamaTag,
+    installed: pick?.installed ?? false,
+    origin: pick?.origin,
+    grade: pick?.grade,
+    command
+  };
+}
+function decideAll(session) {
+  return INTEGRATION_IDS.map((id) => decideLaunch(session, id));
+}
+function launchText(decisions) {
+  const lines = [t("launchTitle"), t("launchHint"), ""];
+  for (const d of decisions) {
+    lines.push(`${d.integration}  ${d.docsUrl}`);
+    lines.push(`  ${d.eligible ? "\u2713" : "\u25CB"} ${d.reasons.join(" ")}`);
+    if (d.modelId) {
+      lines.push(
+        `  ${t("launchModel")}: ${d.modelId}  ${d.grade ?? "\u2014"}  ${d.origin === "measured" ? t("measured") : t("estimated")}  ${d.installed ? t("tasksInstalled") : t("tasksNotInstalled")}`
+      );
+    }
+    lines.push(`  ${d.command}`);
+    if (d.eligible) lines.push(`  ${t("launchRunHint", { tool: d.integration })}`);
+    else lines.push(`  ${t("launchBlocked")}`);
+    lines.push("");
+  }
+  return lines.join("\n");
+}
+function parseIntegration(raw) {
+  if (!raw) return void 0;
+  const id = raw.toLowerCase();
+  if (id === "claude-code") return "claude";
+  return INTEGRATION_IDS.find((item) => item === id);
+}
+
+// src/integrations/execute.ts
+async function executeLaunch(decision) {
+  if (!decision.eligible || !decision.ollamaTag) {
+    return { ok: false, log: t("launchBlocked") };
+  }
+  const def = INTEGRATIONS[decision.integration];
+  if (!def) return { ok: false, log: t("launchUnknown") };
+  const lines = [];
+  if (!decision.installed) {
+    lines.push(t("launchPulling", { model: decision.ollamaTag }));
+    const pull = await runCommand("ollama", ["pull", decision.ollamaTag], { timeout: 30 * 6e4 });
+    if (pull.exitCode !== 0) {
+      return { ok: false, log: `${lines.join("\n")}
+${pull.stderr || t("launchPullFail")}` };
+    }
+  }
+  const args2 = ["launch", def.ollamaLaunch, "--model", decision.ollamaTag];
+  if (def.id === "openclaw" || def.id === "claude") args2.push("--yes");
+  lines.push(`ollama ${args2.join(" ")}`);
+  const launched = await runCommand("ollama", args2, { timeout: 12e4 });
+  if (launched.exitCode !== 0) {
+    return {
+      ok: false,
+      log: `${lines.join("\n")}
+${launched.stderr || launched.stdout || t("launchExecFail")}`
+    };
+  }
+  return { ok: true, log: `${lines.join("\n")}
+${launched.stdout}`.trim() };
+}
+
+// src/integrations/pull.ts
+var INSTALLABLE = ["S", "A", "B"];
+function canInstallGrade(grade) {
+  return Boolean(grade && INSTALLABLE.includes(grade));
+}
+async function pullOllamaModel(modelId) {
+  const tag = toOllamaTag(modelId);
+  const result = await runCommand("ollama", ["pull", tag], { timeout: 30 * 6e4 });
+  if (result.exitCode !== 0) {
+    return { ok: false, log: result.stderr || t("launchPullFail"), tag };
+  }
+  return { ok: true, log: t("modelPulled", { model: tag }), tag };
+}
+
+// src/tui/views/Recommend.tsx
+import { jsx as jsx4, jsxs as jsxs4 } from "react/jsx-runtime";
 function RecommendView({ session }) {
-  return /* @__PURE__ */ jsx4(Box4, { flexDirection: "column", children: /* @__PURE__ */ jsx4(Text4, { children: recommendText(session) }) });
+  const { exit } = useApp();
+  const [cursor, setCursor] = useState(0);
+  const [log, setLog] = useState("");
+  const [busy, setBusy] = useState(false);
+  const recs = session.recommendations;
+  useInput((input, key) => {
+    if (busy) return;
+    if (key.escape) return;
+    if (key.upArrow) setCursor((c) => Math.max(0, c - 1));
+    if (key.downArrow) setCursor((c) => Math.min(Math.max(recs.length - 1, 0), c + 1));
+    const rec = recs[cursor];
+    if (input.toLowerCase() === "i" && rec) {
+      if (!canInstallGrade(rec.grade)) {
+        setLog(t("installGradeBlock", { grade: rec.grade }));
+        return;
+      }
+      setBusy(true);
+      setLog(t("launchPulling", { model: rec.model.id }));
+      void pullOllamaModel(rec.model.id).then((result) => {
+        setLog(result.log);
+        setBusy(false);
+      });
+    }
+    const map = { o: "opencode", e: "hermes", w: "openclaw" };
+    const tool = map[input.toLowerCase()];
+    if (tool && rec) {
+      const decision = decideLaunch(session, tool);
+      if (!decision.eligible) {
+        setLog(decision.reasons.join(" "));
+        return;
+      }
+      setBusy(true);
+      setLog(t("linkingTool", { tool, model: rec.model.id }));
+      void executeLaunch({ ...decision, ollamaTag: decision.ollamaTag, modelId: rec.model.id }).then((result) => {
+        setLog(result.log);
+        setBusy(false);
+        if (result.ok) exit();
+      });
+    }
+  });
+  return /* @__PURE__ */ jsxs4(Box4, { flexDirection: "column", children: [
+    /* @__PURE__ */ jsx4(Text4, { bold: true, color: "cyan", children: t("recommended") }),
+    /* @__PURE__ */ jsx4(Text4, { dimColor: true, children: t("aboutRecommend") }),
+    /* @__PURE__ */ jsx4(Text4, { dimColor: true, children: t("recommendKeys") }),
+    recs.map((rec, i) => /* @__PURE__ */ jsxs4(Text4, { color: i === cursor ? "cyan" : void 0, children: [
+      i === cursor ? "\u276F " : "  ",
+      /* @__PURE__ */ jsx4(Text4, { color: "magenta", children: rec.useCase.padEnd(12) }),
+      rec.model.name.padEnd(22),
+      " ",
+      /* @__PURE__ */ jsx4(Text4, { color: gradeColor(rec.grade), bold: true, children: rec.grade }),
+      " ",
+      GRADE_MEANING[rec.grade]
+    ] }, `${rec.useCase}-${rec.model.id}`)),
+    /* @__PURE__ */ jsxs4(Box4, { marginTop: 1, flexDirection: "column", children: [
+      /* @__PURE__ */ jsx4(Text4, { bold: true, color: "yellow", children: t("agentsTitle") }),
+      session.agents.map((agent) => /* @__PURE__ */ jsxs4(Text4, { color: agent.detected ? "green" : "gray", children: [
+        agent.detected ? "\u2713" : "\u25CB",
+        " ",
+        agent.label.padEnd(12),
+        " ",
+        agent.detected ? t("detected") : t("agentMissing")
+      ] }, agent.id))
+    ] }),
+    log ? /* @__PURE__ */ jsx4(Text4, { color: "green", children: log }) : /* @__PURE__ */ jsx4(Text4, { dimColor: true, children: t("credits") })
+  ] });
 }
 
 // src/tui/views/Compare.tsx
@@ -2200,35 +2547,19 @@ function CompareView({ session }) {
 }
 
 // src/tui/views/Benchmark.tsx
-import { Box as Box6, Text as Text6, useInput } from "ink";
-import { useEffect, useRef, useState } from "react";
-
-// src/tui/theme.ts
-function bar(percent, width = 10) {
-  if (percent === void 0 || Number.isNaN(percent)) return `${"\u2591".repeat(width)} N/A`;
-  const filled = Math.max(0, Math.min(width, Math.round(percent / 100 * width)));
-  return `${"\u2588".repeat(filled)}${"\u2591".repeat(width - filled)}`;
-}
-function sparkline(values, width = 24) {
-  const glyphs = ["\u2581", "\u2582", "\u2583", "\u2584", "\u2585", "\u2586", "\u2587", "\u2588"];
-  if (!values.length) return glyphs[0].repeat(width);
-  const slice = values.slice(-width);
-  const max = Math.max(...slice, 1);
-  return slice.map((v) => glyphs[Math.min(glyphs.length - 1, Math.floor(v / max * (glyphs.length - 1)))]).join("").padStart(width, glyphs[0]);
-}
-
-// src/tui/views/Benchmark.tsx
-import { jsx as jsx6, jsxs as jsxs4 } from "react/jsx-runtime";
+import { Box as Box6, Text as Text6, useInput as useInput2 } from "ink";
+import { useEffect, useRef, useState as useState2 } from "react";
+import { jsx as jsx6, jsxs as jsxs5 } from "react/jsx-runtime";
 function BenchmarkView(props) {
-  const [phase, setPhase] = useState(props.models.length ? "select" : "error");
-  const [sample, setSample] = useState();
-  const [elapsed, setElapsed] = useState(0);
-  const [result, setResult] = useState();
-  const [error, setError] = useState(props.models.length ? "" : t("noGguf"));
+  const [phase, setPhase] = useState2(props.models.length ? "select" : "error");
+  const [sample, setSample] = useState2();
+  const [elapsed, setElapsed] = useState2(0);
+  const [result, setResult] = useState2();
+  const [error, setError] = useState2(props.models.length ? "" : t("noGguf"));
   const cpuHist = useRef([]);
   const memHist = useRef([]);
   const abortRef = useRef(void 0);
-  useInput((input, key) => {
+  useInput2((input, key) => {
     if (phase === "select") {
       if (key.upArrow) props.setSelected(Math.max(0, props.selected - 1));
       if (key.downArrow) props.setSelected(Math.min(props.models.length - 1, props.selected + 1));
@@ -2278,9 +2609,9 @@ function BenchmarkView(props) {
   const h = props.session.hardware;
   const model = props.models[props.selected];
   if (phase === "select") {
-    return /* @__PURE__ */ jsxs4(Box6, { flexDirection: "column", children: [
+    return /* @__PURE__ */ jsxs5(Box6, { flexDirection: "column", children: [
       /* @__PURE__ */ jsx6(Text6, { bold: true, children: t("selectBenchmark") }),
-      props.models.map((m, i) => /* @__PURE__ */ jsxs4(Text6, { color: i === props.selected ? "cyan" : void 0, children: [
+      props.models.map((m, i) => /* @__PURE__ */ jsxs5(Text6, { color: i === props.selected ? "cyan" : void 0, children: [
         i === props.selected ? "\u276F " : "  ",
         m.name
       ] }, m.id)),
@@ -2288,9 +2619,9 @@ function BenchmarkView(props) {
     ] });
   }
   if (phase === "done" && result) {
-    return /* @__PURE__ */ jsxs4(Box6, { flexDirection: "column", children: [
+    return /* @__PURE__ */ jsxs5(Box6, { flexDirection: "column", children: [
       /* @__PURE__ */ jsx6(Text6, { children: resultText(result.record, result.assessment) }),
-      /* @__PURE__ */ jsxs4(Text6, { dimColor: true, children: [
+      /* @__PURE__ */ jsxs5(Text6, { dimColor: true, children: [
         t("saved"),
         " ",
         result.path
@@ -2304,11 +2635,11 @@ function BenchmarkView(props) {
   const gpu = sample?.gpu?.utilizationPercent;
   const memUsed = sample?.memory.usedBytes;
   const memTotal = h.memory.totalBytes;
-  return /* @__PURE__ */ jsxs4(Box6, { flexDirection: "column", children: [
-    /* @__PURE__ */ jsxs4(Box6, { borderStyle: "round", borderColor: "cyan", flexDirection: "column", paddingX: 1, children: [
+  return /* @__PURE__ */ jsxs5(Box6, { flexDirection: "column", children: [
+    /* @__PURE__ */ jsxs5(Box6, { borderStyle: "round", borderColor: "cyan", flexDirection: "column", paddingX: 1, children: [
       /* @__PURE__ */ jsx6(Text6, { bold: true, children: t("benchmarkTitle") }),
       /* @__PURE__ */ jsx6(Text6, { children: model?.name }),
-      /* @__PURE__ */ jsxs4(Text6, { dimColor: true, children: [
+      /* @__PURE__ */ jsxs5(Text6, { dimColor: true, children: [
         h.cpu.name,
         " \xB7 ",
         formatBytes(h.memory.totalBytes, 0),
@@ -2316,9 +2647,9 @@ function BenchmarkView(props) {
         memoryLabel(h)
       ] })
     ] }),
-    /* @__PURE__ */ jsxs4(Box6, { marginTop: 1, flexDirection: "column", children: [
+    /* @__PURE__ */ jsxs5(Box6, { marginTop: 1, flexDirection: "column", children: [
       /* @__PURE__ */ jsx6(Text6, { bold: true, color: "cyan", children: t("performance") }),
-      /* @__PURE__ */ jsxs4(Text6, { children: [
+      /* @__PURE__ */ jsxs5(Text6, { children: [
         t("elapsed"),
         "                    ",
         elapsed.toFixed(1),
@@ -2326,21 +2657,21 @@ function BenchmarkView(props) {
       ] }),
       /* @__PURE__ */ jsx6(Text6, { dimColor: true, children: t("measuredAfter") })
     ] }),
-    /* @__PURE__ */ jsxs4(Box6, { marginTop: 1, flexDirection: "column", children: [
+    /* @__PURE__ */ jsxs5(Box6, { marginTop: 1, flexDirection: "column", children: [
       /* @__PURE__ */ jsx6(Text6, { bold: true, color: "cyan", children: t("system") }),
-      /* @__PURE__ */ jsxs4(Text6, { children: [
+      /* @__PURE__ */ jsxs5(Text6, { children: [
         "CPU       ",
         bar(cpu),
         "       ",
         formatPercent(cpu)
       ] }),
-      /* @__PURE__ */ jsxs4(Text6, { children: [
+      /* @__PURE__ */ jsxs5(Text6, { children: [
         "GPU       ",
         bar(gpu),
         "       ",
         formatPercent(gpu)
       ] }),
-      /* @__PURE__ */ jsxs4(Text6, { children: [
+      /* @__PURE__ */ jsxs5(Text6, { children: [
         "Memory    ",
         bar(memUsed && memTotal ? memUsed / memTotal * 100 : void 0),
         "      ",
@@ -2348,36 +2679,36 @@ function BenchmarkView(props) {
         " / ",
         formatBytes(memTotal, 0)
       ] }),
-      /* @__PURE__ */ jsxs4(Text6, { children: [
+      /* @__PURE__ */ jsxs5(Text6, { children: [
         "Swap      ",
         bar(0),
         "      ",
         sample ? formatBytes(sample.memory.swapUsedBytes) : "N/A"
       ] })
     ] }),
-    /* @__PURE__ */ jsxs4(Box6, { marginTop: 1, flexDirection: "column", children: [
+    /* @__PURE__ */ jsxs5(Box6, { marginTop: 1, flexDirection: "column", children: [
       /* @__PURE__ */ jsx6(Text6, { bold: true, color: "cyan", children: t("powerThermals") }),
-      /* @__PURE__ */ jsxs4(Text6, { children: [
+      /* @__PURE__ */ jsxs5(Text6, { children: [
         "Package                    ",
         sample?.packagePowerWatts ?? "N/A",
         " W"
       ] }),
-      /* @__PURE__ */ jsxs4(Text6, { children: [
+      /* @__PURE__ */ jsxs5(Text6, { children: [
         "Temperature                ",
         sample?.thermal?.temperatureC ?? "N/A",
         " \xB0C"
       ] }),
-      /* @__PURE__ */ jsxs4(Text6, { children: [
+      /* @__PURE__ */ jsxs5(Text6, { children: [
         "Thermal Pressure           ",
         sample?.thermal?.pressure ?? "N/A"
       ] }),
       /* @__PURE__ */ jsx6(Text6, { dimColor: true, children: t("permissionsHint") })
     ] }),
-    /* @__PURE__ */ jsxs4(Text6, { children: [
+    /* @__PURE__ */ jsxs5(Text6, { children: [
       sparkline(cpuHist.current),
       " CPU"
     ] }),
-    /* @__PURE__ */ jsxs4(Text6, { children: [
+    /* @__PURE__ */ jsxs5(Text6, { children: [
       sparkline(memHist.current.map((v) => v / 1024 ** 3)),
       " Memory"
     ] }),
@@ -2387,17 +2718,17 @@ function BenchmarkView(props) {
 
 // src/tui/views/History.tsx
 import { Box as Box7, Text as Text7 } from "ink";
-import { jsx as jsx7, jsxs as jsxs5 } from "react/jsx-runtime";
+import { jsx as jsx7, jsxs as jsxs6 } from "react/jsx-runtime";
 function HistoryView({ session }) {
-  return /* @__PURE__ */ jsxs5(Box7, { flexDirection: "column", children: [
+  return /* @__PURE__ */ jsxs6(Box7, { flexDirection: "column", children: [
     /* @__PURE__ */ jsx7(Text7, { bold: true, color: "cyan", children: t("measured") }),
     /* @__PURE__ */ jsx7(Text7, { children: historyText(session.history) })
   ] });
 }
 
 // src/tui/views/Tasks.tsx
-import { Box as Box8, Text as Text8, useInput as useInput2 } from "ink";
-import { useMemo, useState as useState2 } from "react";
+import { Box as Box8, Text as Text8, useInput as useInput3 } from "ink";
+import { useMemo, useState as useState3 } from "react";
 
 // src/tasks/catalog.ts
 var TASK_CATALOG = [
@@ -2592,7 +2923,7 @@ function tasksText(plans, answers) {
 }
 
 // src/tui/views/Tasks.tsx
-import { Fragment, jsx as jsx8, jsxs as jsxs6 } from "react/jsx-runtime";
+import { Fragment, jsx as jsx8, jsxs as jsxs7 } from "react/jsx-runtime";
 var KIND_LABEL = {
   code: "tasksOptCode",
   video: "tasksOptVideo",
@@ -2601,16 +2932,16 @@ var KIND_LABEL = {
   chat: "tasksOptChat"
 };
 function TasksView({ session }) {
-  const [step, setStep] = useState2(0);
-  const [cursor, setCursor] = useState2(0);
-  const [kinds, setKinds] = useState2(["code", "chat"]);
-  const [scope, setScope] = useState2("installed");
-  const [priority, setPriority] = useState2("balanced");
+  const [step, setStep] = useState3(0);
+  const [cursor, setCursor] = useState3(0);
+  const [kinds, setKinds] = useState3(["code", "chat"]);
+  const [scope, setScope] = useState3("installed");
+  const [priority, setPriority] = useState3("balanced");
   const plans = useMemo(
     () => planTasks(session, { kinds, scope, priority }),
     [session, kinds, scope, priority]
   );
-  useInput2((input, key) => {
+  useInput3((input, key) => {
     if (step === 0) {
       if (key.upArrow) setCursor((c) => Math.max(0, c - 1));
       if (key.downArrow) setCursor((c) => Math.min(WORK_KINDS.length - 1, c + 1));
@@ -2635,11 +2966,11 @@ function TasksView({ session }) {
   if (step === 3) {
     return /* @__PURE__ */ jsx8(Box8, { flexDirection: "column", children: /* @__PURE__ */ jsx8(Text8, { children: tasksText(plans, { kinds, scope, priority }) }) });
   }
-  return /* @__PURE__ */ jsxs6(Box8, { flexDirection: "column", children: [
+  return /* @__PURE__ */ jsxs7(Box8, { flexDirection: "column", children: [
     /* @__PURE__ */ jsx8(Text8, { bold: true, color: "cyan", children: t("tasksTitle") }),
-    step === 0 && /* @__PURE__ */ jsxs6(Fragment, { children: [
+    step === 0 && /* @__PURE__ */ jsxs7(Fragment, { children: [
       /* @__PURE__ */ jsx8(Text8, { children: t("tasksQ1") }),
-      WORK_KINDS.map((kind, i) => /* @__PURE__ */ jsxs6(Text8, { color: i === cursor ? "cyan" : void 0, children: [
+      WORK_KINDS.map((kind, i) => /* @__PURE__ */ jsxs7(Text8, { color: i === cursor ? "cyan" : void 0, children: [
         i === cursor ? "\u276F " : "  ",
         "[",
         kinds.includes(kind) ? "x" : " ",
@@ -2647,20 +2978,20 @@ function TasksView({ session }) {
         t(KIND_LABEL[kind])
       ] }, kind))
     ] }),
-    step === 1 && /* @__PURE__ */ jsxs6(Fragment, { children: [
+    step === 1 && /* @__PURE__ */ jsxs7(Fragment, { children: [
       /* @__PURE__ */ jsx8(Text8, { children: t("tasksQ2") }),
-      /* @__PURE__ */ jsxs6(Text8, { color: scope === "installed" ? "cyan" : void 0, children: [
+      /* @__PURE__ */ jsxs7(Text8, { color: scope === "installed" ? "cyan" : void 0, children: [
         scope === "installed" ? "\u276F " : "  ",
         t("tasksOptInstalled")
       ] }),
-      /* @__PURE__ */ jsxs6(Text8, { color: scope === "all" ? "cyan" : void 0, children: [
+      /* @__PURE__ */ jsxs7(Text8, { color: scope === "all" ? "cyan" : void 0, children: [
         scope === "all" ? "\u276F " : "  ",
         t("tasksOptAll")
       ] })
     ] }),
-    step === 2 && /* @__PURE__ */ jsxs6(Fragment, { children: [
+    step === 2 && /* @__PURE__ */ jsxs7(Fragment, { children: [
       /* @__PURE__ */ jsx8(Text8, { children: t("tasksQ3") }),
-      ["speed", "balanced", "quality"].map((item) => /* @__PURE__ */ jsxs6(Text8, { color: priority === item ? "cyan" : void 0, children: [
+      ["speed", "balanced", "quality"].map((item) => /* @__PURE__ */ jsxs7(Text8, { color: priority === item ? "cyan" : void 0, children: [
         priority === item ? "\u276F " : "  ",
         item === "speed" ? t("tasksOptSpeed") : item === "quality" ? t("tasksOptQuality") : t("tasksOptBalanced")
       ] }, item))
@@ -2668,30 +2999,44 @@ function TasksView({ session }) {
   ] });
 }
 
+// src/tui/keys.ts
+function handleAppKey(screen, input, key) {
+  const letter = input.toLowerCase();
+  if (screen === "benchmark") return { type: "ignore" };
+  if (screen === "recommend" || screen === "tasks") {
+    if (letter === "q") return { type: "quit" };
+    if (key.escape) return { type: "home" };
+    return { type: "ignore" };
+  }
+  if (letter === "q" || key.escape) return { type: "quit" };
+  if (letter === "b") return { type: "screen", screen: "benchmark" };
+  if (letter === "m") return { type: "screen", screen: "models" };
+  if (letter === "r") return { type: "screen", screen: "recommend" };
+  if (letter === "h") return { type: "screen", screen: "hardware" };
+  if (letter === "c") return { type: "screen", screen: "compare" };
+  if (letter === "l") return { type: "screen", screen: "history" };
+  if (letter === "t") return { type: "screen", screen: "tasks" };
+  if (key.return && screen === "home") return { type: "screen", screen: "benchmark" };
+  return { type: "ignore" };
+}
+
 // src/tui/App.tsx
-import { jsx as jsx9, jsxs as jsxs7 } from "react/jsx-runtime";
+import { jsx as jsx9, jsxs as jsxs8 } from "react/jsx-runtime";
 function App(props) {
-  const { exit } = useApp();
-  const [screen, setScreen] = useState3("home");
-  const [selected, setSelected] = useState3(0);
+  const { exit } = useApp2();
+  const [screen, setScreen] = useState4("home");
+  const [selected, setSelected] = useState4(0);
   const benchable = useMemo2(
     () => props.session.models.filter((m) => Boolean(m.artifactPath)),
     [props.session.models]
   );
-  useInput3((input, key) => {
-    if (screen === "benchmark") return;
-    const letter = input.toLowerCase();
-    if (letter === "q" || key.escape) exit();
-    if (letter === "b") setScreen("benchmark");
-    if (letter === "m") setScreen("models");
-    if (letter === "r") setScreen("recommend");
-    if (letter === "h") setScreen("hardware");
-    if (letter === "c") setScreen("compare");
-    if (letter === "l") setScreen("history");
-    if (letter === "t") setScreen("tasks");
-    if (key.return && screen === "home") setScreen("benchmark");
+  useInput4((input, key) => {
+    const result = handleAppKey(screen, input, key);
+    if (result.type === "quit") exit();
+    if (result.type === "home") setScreen("home");
+    if (result.type === "screen") setScreen(result.screen);
   });
-  return /* @__PURE__ */ jsxs7(Box9, { flexDirection: "column", padding: 1, children: [
+  return /* @__PURE__ */ jsxs8(Box9, { flexDirection: "column", padding: 1, children: [
     screen === "home" && /* @__PURE__ */ jsx9(Dashboard, { session: props.session }),
     screen === "models" && /* @__PURE__ */ jsx9(ModelsView, { session: props.session }),
     screen === "hardware" && /* @__PURE__ */ jsx9(HardwareView, { session: props.session }),
@@ -2721,179 +3066,6 @@ async function renderDashboard(session, preset) {
   await instance.waitUntilExit();
 }
 
-// src/integrations/catalog.ts
-var INTEGRATIONS = {
-  opencode: {
-    id: "opencode",
-    docsUrl: "https://docs.ollama.com/integrations/opencode",
-    ollamaLaunch: "opencode",
-    minGenerationTps: 12,
-    allowedGrades: ["S", "A", "B"],
-    useCases: ["code", "chat", "reasoning"]
-  },
-  openclaw: {
-    id: "openclaw",
-    docsUrl: "https://docs.ollama.com/integrations/openclaw",
-    ollamaLaunch: "openclaw",
-    minGenerationTps: 12,
-    allowedGrades: ["S", "A", "B"],
-    useCases: ["code", "chat", "reasoning"]
-  },
-  hermes: {
-    id: "hermes",
-    docsUrl: "https://docs.ollama.com/integrations/hermes",
-    ollamaLaunch: "hermes",
-    minGenerationTps: 12,
-    allowedGrades: ["S", "A"],
-    useCases: ["code", "chat", "reasoning"]
-  },
-  claude: {
-    id: "claude",
-    docsUrl: "https://docs.ollama.com/integrations/claude-code",
-    ollamaLaunch: "claude",
-    minGenerationTps: 12,
-    allowedGrades: ["S", "A", "B"],
-    useCases: ["code", "chat", "reasoning"]
-  }
-};
-
-// src/integrations/types.ts
-var INTEGRATION_IDS = ["opencode", "openclaw", "hermes", "claude"];
-
-// src/integrations/decide.ts
-var GRADE_RANK = { S: 5, A: 4, B: 3, C: 2, D: 1, F: 0 };
-function toOllamaTag(id) {
-  const compact = id.toLowerCase().replace(/_/g, "-");
-  const match = compact.match(/^([a-z0-9.]+(?:-[a-z0-9.]+)*)-(\d+(?:\.\d+)?b)$/i);
-  if (match) return `${match[1]}:${match[2]}`;
-  if (compact.includes(":")) return compact;
-  return compact;
-}
-function useCaseOk(useCases, needed) {
-  if (!useCases?.length) return needed.includes("chat");
-  return useCases.some((u) => needed.some((n) => u.includes(n)));
-}
-function decideLaunch(session, id) {
-  const def = INTEGRATIONS[id];
-  const reasons = [];
-  const ollama = session.runtimes.find((r) => r.id === "ollama")?.detected;
-  if (!ollama) reasons.push(t("launchNeedOllama"));
-  const candidates = [];
-  for (const row of session.rows) {
-    const useCases = row.catalog?.useCase ?? ["chat", "code"];
-    if (!useCaseOk(useCases, def.useCases)) continue;
-    const tps = row.lastBenchmark?.benchmark.generationTokensPerSecond;
-    candidates.push({
-      modelId: row.local.id,
-      ollamaTag: row.local.id.includes(":") ? row.local.id : toOllamaTag(row.local.id),
-      installed: true,
-      origin: row.lastBenchmark ? "measured" : "estimated",
-      grade: row.compatibility?.grade,
-      tps
-    });
-  }
-  if (!candidates.length) {
-    for (const model of session.catalog) {
-      if (!useCaseOk(model.useCase, def.useCases)) continue;
-      const fit = localCompatibility(session.hardware, model);
-      if (!def.allowedGrades.includes(fit.grade)) continue;
-      candidates.push({
-        modelId: model.id,
-        ollamaTag: toOllamaTag(model.id),
-        installed: false,
-        origin: "estimated",
-        grade: fit.grade
-      });
-    }
-  }
-  candidates.sort((a, b) => {
-    if (a.installed !== b.installed) return a.installed ? -1 : 1;
-    return (GRADE_RANK[b.grade ?? "F"] ?? 0) - (GRADE_RANK[a.grade ?? "F"] ?? 0);
-  });
-  const pick = candidates[0];
-  if (!pick) reasons.push(t("launchNoModel"));
-  if (pick?.grade && !def.allowedGrades.includes(pick.grade)) {
-    reasons.push(t("launchGradeFail", { grade: pick.grade, allowed: def.allowedGrades.join(",") }));
-  }
-  if (pick?.origin === "measured" && pick.tps !== void 0 && pick.tps < def.minGenerationTps) {
-    reasons.push(t("launchSlowFail", { tps: pick.tps.toFixed(1), min: def.minGenerationTps }));
-  }
-  if (pick && pick.origin === "estimated" && (!pick.grade || GRADE_RANK[pick.grade] < GRADE_RANK.B)) {
-    reasons.push(t("launchEstimateWeak"));
-  }
-  const eligible = Boolean(ollama && pick && reasons.length === 0);
-  const command = pick ? `ollama launch ${def.ollamaLaunch} --model ${pick.ollamaTag}` : `ollama launch ${def.ollamaLaunch}`;
-  return {
-    integration: id,
-    docsUrl: def.docsUrl,
-    eligible,
-    reasons: eligible ? [t("launchOk")] : reasons,
-    modelId: pick?.modelId,
-    ollamaTag: pick?.ollamaTag,
-    installed: pick?.installed ?? false,
-    origin: pick?.origin,
-    grade: pick?.grade,
-    command
-  };
-}
-function decideAll(session) {
-  return INTEGRATION_IDS.map((id) => decideLaunch(session, id));
-}
-function launchText(decisions) {
-  const lines = [t("launchTitle"), t("launchHint"), ""];
-  for (const d of decisions) {
-    lines.push(`${d.integration}  ${d.docsUrl}`);
-    lines.push(`  ${d.eligible ? "\u2713" : "\u25CB"} ${d.reasons.join(" ")}`);
-    if (d.modelId) {
-      lines.push(
-        `  ${t("launchModel")}: ${d.modelId}  ${d.grade ?? "\u2014"}  ${d.origin === "measured" ? t("measured") : t("estimated")}  ${d.installed ? t("tasksInstalled") : t("tasksNotInstalled")}`
-      );
-    }
-    lines.push(`  ${d.command}`);
-    if (d.eligible) lines.push(`  ${t("launchRunHint", { tool: d.integration })}`);
-    else lines.push(`  ${t("launchBlocked")}`);
-    lines.push("");
-  }
-  return lines.join("\n");
-}
-function parseIntegration(raw) {
-  if (!raw) return void 0;
-  const id = raw.toLowerCase();
-  if (id === "claude-code") return "claude";
-  return INTEGRATION_IDS.find((item) => item === id);
-}
-
-// src/integrations/execute.ts
-async function executeLaunch(decision) {
-  if (!decision.eligible || !decision.ollamaTag) {
-    return { ok: false, log: t("launchBlocked") };
-  }
-  const def = INTEGRATIONS[decision.integration];
-  if (!def) return { ok: false, log: t("launchUnknown") };
-  const lines = [];
-  if (!decision.installed) {
-    lines.push(t("launchPulling", { model: decision.ollamaTag }));
-    const pull = await runCommand("ollama", ["pull", decision.ollamaTag], { timeout: 30 * 6e4 });
-    if (pull.exitCode !== 0) {
-      return { ok: false, log: `${lines.join("\n")}
-${pull.stderr || t("launchPullFail")}` };
-    }
-  }
-  const args2 = ["launch", def.ollamaLaunch, "--model", decision.ollamaTag];
-  if (def.id === "openclaw" || def.id === "claude") args2.push("--yes");
-  lines.push(`ollama ${args2.join(" ")}`);
-  const launched = await runCommand("ollama", args2, { timeout: 12e4 });
-  if (launched.exitCode !== 0) {
-    return {
-      ok: false,
-      log: `${lines.join("\n")}
-${launched.stderr || launched.stdout || t("launchExecFail")}`
-    };
-  }
-  return { ok: true, log: `${lines.join("\n")}
-${launched.stdout}`.trim() };
-}
-
 // src/cli/help.ts
 function helpText() {
   return t("help");
@@ -2952,9 +3124,36 @@ ${runtimesText(session)}`),
     case "models":
       print(args2.json ? session.rows : explained("aboutModels", modelsText(session)), args2.json);
       return 0;
-    case "recommend":
-      print(args2.json ? session.recommendations : explained("aboutRecommend", recommendText(session)), args2.json);
+    case "recommend": {
+      if (args2.install && args2.yes) {
+        const rec = session.recommendations.find((r) => canInstallGrade(r.grade));
+        if (!rec) {
+          print(t("installNone"), args2.json);
+          return 1;
+        }
+        const pulled = await pullOllamaModel(rec.model.id);
+        print(args2.json ? pulled : explained("aboutRecommend", pulled.log), args2.json);
+        return pulled.ok ? 0 : 1;
+      }
+      if (args2.link && args2.yes) {
+        const tool = parseIntegration(args2.link);
+        if (!tool || tool === "claude") {
+          process.stderr.write(`${t("launchNeedTool")}
+`);
+          return 1;
+        }
+        const decision = decideLaunch(session, tool);
+        if (!decision.eligible) {
+          print(explained("aboutLaunch", launchText([decision])), args2.json);
+          return 1;
+        }
+        const result = await executeLaunch(decision);
+        print(args2.json ? result : explained("aboutLaunch", result.log), args2.json);
+        return result.ok ? 0 : 1;
+      }
+      print(args2.json ? { recommendations: session.recommendations, agents: session.agents } : explained("aboutRecommend", recommendText(session)), args2.json);
       return 0;
+    }
     case "launch": {
       const tool = parseIntegration(args2.positional[0]);
       const decisions = tool ? [decideLaunch(session, tool)] : decideAll(session);
@@ -3058,10 +3257,10 @@ ${runtimesText(session)}`),
 // src/cli/index.ts
 var args = parseArgs(process.argv);
 run(args).then((code) => {
-  process.exitCode = code;
+  process.exit(code);
 }).catch((error) => {
   const message = error instanceof Error ? error.message : String(error);
   process.stderr.write(`${message}
 `);
-  process.exitCode = 1;
+  process.exit(1);
 });

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "pudu-ai",
-  "version": "0.2.3",
+  "version": "0.2.5",
   "description": "Pudu-AI — local AI hardware & benchmark lab for the terminal",
   "keywords": [
     "ai",