offgrid-ai 0.16.3 → 0.18.0

package/README.md

@@ -77,14 +77,12 @@ Pick a model from the list and press Enter. offgrid-ai configures the rest and o
 offgrid-ai              # primary entry-point for the CLI
 offgrid-ai status       # see if any model is running
 offgrid-ai stop         # stop the running model
-offgrid-ai benchmark    # run a benchmark paired with my local llm benchmark runner
 offgrid-ai uninstall    # remove offgrid-ai
 ```
 
 ## What can I do with it?
 
 - **Chat with local models** — you download the models yourself, and then offgrid-ai helps configure and run then
-- **Run benchmarks** — compare how different models perform on creative or data-science tasks. Pairs with my other [local llm benchmark runner](https://github.com/eeshansrivastava89/local-llm-visual-benchmark)
 - **Keep data private** — everything runs on your machine without any cloud connections
 
 ## Need help?

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "offgrid-ai",
-  "version": "0.16.3",
-  "description": "Privacy-first CLI for running local LLMs — discover, configure, run, benchmark",
+  "version": "0.18.0",
+  "description": "Privacy-first CLI for running local LLMs — discover, configure, run, and chat",
   "author": "Eeshan Srivastava (https://eeshans.com)",
   "type": "module",
   "bin": {
@@ -11,7 +11,6 @@
     "bin/*.mjs",
     "src/*.mjs",
     "src/commands/*.mjs",
-    "src/benchmark/*.mjs",
     "resources/*.py",
     "resources/recommendations.json",
     "install.sh"
@@ -34,7 +33,7 @@
     "start": "node bin/offgrid-ai.mjs",
     "test": "node --test test/*.mjs",
     "test:integration": "OFFGRID_INTEGRATION=1 node --test test/integration/*.mjs",
-    "lint": "eslint src/*.mjs src/commands/*.mjs src/benchmark/*.mjs scripts/*.mjs bin/*.mjs",
+    "lint": "eslint src/*.mjs src/commands/*.mjs scripts/*.mjs bin/*.mjs",
     "check:privacy": "node scripts/privacy-gate.mjs",
     "release:check": "bash scripts/release-check.sh",
     "release:check:fast": "bash scripts/release-check.sh --skip-install --skip-manual",
@@ -42,9 +41,6 @@
     "pretest": "npm run lint"
   },
   "dependencies": {
-    "@earendil-works/pi-agent-core": "^0.80.3",
-    "@earendil-works/pi-ai": "^0.80.3",
-    "@earendil-works/pi-coding-agent": "^0.80.3",
     "@inquirer/prompts": "^8.5.2",
     "picocolors": "^1.1.0"
   },
@@ -61,9 +57,5 @@
     "@eslint/js": "^10.0.1",
     "eslint": "^10.4.1",
     "globals": "^17.6.0"
-  },
-  "allowScripts": {
-    "@google/genai": true,
-    "protobufjs": true
   }
 }

package/resources/recommendations.json

@@ -2,56 +2,56 @@
   "models": [
     {
       "id": "gemma-4-e2b",
-      "label": "Gemma 4 E2B",
+      "label": "Gemma 4 E2B (Q4_K_S)",
       "minRamGb": 8,
       "gguf": "unsloth/gemma-4-E2B-it-GGUF/gemma-4-E2B-it-Q4_K_S.gguf",
       "mlx": "mlx-community/gemma-4-e2b-it-4bit"
     },
     {
       "id": "qwen-3.5-9b",
-      "label": "Qwen 3.5 9B",
+      "label": "Qwen 3.5 9B (Q4_K_S)",
       "minRamGb": 16,
       "gguf": "unsloth/Qwen3.5-9B-GGUF/Qwen3.5-9B-UD-Q4_K_S.gguf",
       "mlx": "lmstudio-community/Qwen3.5-9B-MLX-4bit"
     },
     {
       "id": "gemma-4-12b-qat",
-      "label": "Gemma 4 12B",
+      "label": "Gemma 4 12B (Q4_K_XL)",
       "minRamGb": 24,
       "gguf": "unsloth/gemma-4-12B-it-qat-GGUF/gemma-4-12B-it-qat-UD-Q4_K_XL.gguf",
       "mlx": "mlx-community/gemma-4-12B-it-qat-4bit"
     },
     {
       "id": "gemma-4-26b",
-      "label": "Gemma 4 26B",
+      "label": "Gemma 4 26B (Q4_K_XL)",
       "minRamGb": 32,
       "gguf": "unsloth/gemma-4-26B-A4B-it-qat-GGUF/gemma-4-26B-A4B-it-qat-UD-Q4_K_XL.gguf",
       "mlx": "mlx-community/gemma-4-26b-a4b-4bit"
     },
     {
       "id": "qwen-3.6-35b-compact",
-      "label": "Qwen 3.6 35B",
+      "label": "Qwen 3.6 35B (Q4_K_S)",
       "minRamGb": 32,
       "gguf": "unsloth/Qwen3.6-35B-A3B-GGUF/Qwen3.6-35B-A3B-UD-Q4_K_S.gguf",
       "mlx": "mlx-community/Qwen3.6-35B-A3B-4bit"
     },
     {
       "id": "qwen-3.6-35b",
-      "label": "Qwen 3.6 35B",
+      "label": "Qwen 3.6 35B (Q4_K_M)",
       "minRamGb": 48,
       "gguf": "unsloth/Qwen3.6-35B-A3B-GGUF/Qwen3.6-35B-A3B-UD-Q4_K_M.gguf",
       "mlx": ""
     },
     {
       "id": "gemma-4-31b",
-      "label": "Gemma 4 31B",
+      "label": "Gemma 4 31B (Q4_K_XL)",
       "minRamGb": 64,
       "gguf": "unsloth/gemma-4-31B-it-qat-GGUF/gemma-4-31B-it-qat-UD-Q4_K_XL.gguf",
       "mlx": "mlx-community/gemma-4-31b-4bit"
     },
     {
       "id": "qwen-3.6-27b",
-      "label": "Qwen 3.6 27B",
+      "label": "Qwen 3.6 27B (Q4_K_M)",
       "minRamGb": 64,
       "gguf": "unsloth/Qwen3.6-27B-MTP-GGUF/Qwen3.6-27B-Q4_K_M.gguf",
       "mlx": "mlx-community/Qwen3.6-27B-4bit"

package/src/cli.mjs

@@ -5,7 +5,6 @@ import { modelsCommand } from "./commands/models.mjs";
 import { runCommand } from "./commands/run.mjs";
 import { statusCommand } from "./commands/status.mjs";
 import { stopCommand } from "./commands/stop.mjs";
-import { benchmarkCommand } from "./commands/benchmark.mjs";
 import { uninstallCommand } from "./commands/uninstall.mjs";
 
 async function offerUpdate(argv) {
@@ -45,7 +44,6 @@ export async function run(argv) {
   if (command === "run") return runCommand(argv.slice(1));
   if (command === "status") return statusCommand();
   if (command === "stop") return stopCommand(argv.slice(1));
-  if (command === "benchmark") return benchmarkCommand();
   if (command === "uninstall" || command === "--uninstall") return uninstallCommand(argv.slice(1));
   if (command === "--verbose") return mainFlow();
 
@@ -69,10 +67,9 @@ function printHelp() {
     ["Start", pc.bold("offgrid-ai")],
     ["Status", "offgrid-ai status"],
     ["Stop", "offgrid-ai stop"],
-    ["Benchmark", "offgrid-ai benchmark"],
     ["Uninstall", "offgrid-ai uninstall"],
     ["Version", "offgrid-ai version"],
   ]), { formatBorder: pc.cyan }));
-  console.log("\n" + renderCard("How it works", "Run offgrid-ai, choose a local model, and start chatting in Pi.\n\nFirst run walks you through missing tools. After that, offgrid-ai remembers your model setup.\n\nFor benchmarks, run offgrid-ai benchmark to prepare a visual or data-science benchmark run.", { formatBorder: pc.magenta }));
+  console.log("\n" + renderCard("How it works", "Run offgrid-ai, choose a local model, and start chatting in Pi.\n\nFirst run walks you through missing tools. After that, offgrid-ai remembers your model setup.", { formatBorder: pc.magenta }));
   console.log("\n" + pc.dim("Tip: use --verbose only when you want detailed install output."));
 }

package/src/commands/main.mjs

@@ -7,7 +7,7 @@ import { offerManagedLlamaRuntimeUpdate } from "../runtime.mjs";
 import { offerManagedOmlxUpdate, hasOmlx } from "../omlx-runtime.mjs";
 import { hasLmStudioInstalled, scanManagedModels } from "../managed.mjs";
 import { recommendedModel } from "../recommendations.mjs";
-import { pc, startInteractive, createPrompt } from "../ui.mjs";
+import { pc, startInteractive, createPrompt, renderCard } from "../ui.mjs";
 import { onboardFlow } from "./onboard.mjs";
 import { modelCommandCenter } from "./models.mjs";
 import { statusCommand } from "./status.mjs";
@@ -58,9 +58,28 @@ export async function mainFlow() {
   if (!process.stdin.isTTY) return await statusCommand();
 
   startInteractive("offgrid-ai");
+  printStatusHeader({ llamaBinary, managedModels, piInstalled, omlxInstalled: await hasOmlx(), profiles });
+  console.log(pc.dim("  No models? Pick \"↓ Download a model\" below — offgrid-ai downloads from HuggingFace"));
+  console.log("");
   return await modelCommandCenter({ profiles, ggufModels, managedModels, drafters });
 }
 
+function printStatusHeader({ llamaBinary, managedModels, piInstalled, omlxInstalled, profiles }) {
+  const omlxServerUp = managedModels.some((m) => m.backendId === "omlx" && m.status === "ok");
+  const parts = [
+    llamaBinary ? pc.green("llama.cpp ✓") : pc.red("llama.cpp ✗"),
+  ];
+  if (omlxInstalled) {
+    parts.push(omlxServerUp ? pc.green("oMLX ✓ server up") : pc.yellow("oMLX ✓ server down"));
+  } else {
+    parts.push(pc.red("oMLX ✗"));
+  }
+  parts.push(piInstalled ? pc.green("Pi ✓") : pc.red("Pi ✗"));
+  if (profiles.length > 0) parts.push(pc.dim(`${profiles.length} model${profiles.length === 1 ? "" : "s"}`));
+  console.log(renderCard("offgrid-ai", parts.join(pc.dim("  ·  ")), { formatBorder: pc.cyan }));
+  console.log("");
+}
+
 async function printNoModelsHelp(llamaBinary) {
   console.log(pc.yellow("No models found."));
   console.log(pc.dim("You need to download a model to use offgrid-ai.\n"));

package/src/commands/models.mjs

@@ -1,15 +1,22 @@
-import { ensureDirs } from "../config.mjs";
+import { ensureDirs, getModelScanDirs, addModelScanDir, removeModelScanDir, DEFAULT_MODEL_DIRS, findLlamaServer, HF_HUB_DIR } from "../config.mjs";
+import { existsSync } from "node:fs";
+import { rm, unlink } from "node:fs/promises";
+import { homedir } from "node:os";
+import { join } from "node:path";
+import { stripVTControlCharacters } from "node:util";
 import { backendFor, BACKENDS } from "../backends.mjs";
 import { createProfileFromModel, readProfile, saveProfile, deleteProfile, profileJsonPath } from "../profiles.mjs";
 import { isProfileRunning, isProfileServerUp, modelAvailableOnServer, stopProfile } from "../process.mjs";
-import { syncPiConfig, removeFromPiConfig } from "../harness-pi.mjs";
+import { syncPiConfig, removeFromPiConfig, hasPi } from "../harness-pi.mjs";
+import { hasOmlx, offerOmlxRestart } from "../omlx-runtime.mjs";
 import { configureLocalProfile, configureManagedProfile } from "../profile-setup.mjs";
-import { pc, startInteractive, createPrompt, modelSelect } from "../ui.mjs";
+import { findOmlxModelDir } from "../mlx-discovery.mjs";
+import { pc, startInteractive, createPrompt, modelSelect, renderCard, renderRows } from "../ui.mjs";
 import { buildCatalogItems, createManagedProfile, itemKey, loadModelCatalog, normalizeCatalog } from "../model-catalog.mjs";
-import { modelSelectOption, modelNameWidth, inferBackendId, formatSourceLabel, discoverySourceForItem, printGgufModelDetails, printManagedModelDetails, printWorkspaceHeader, printBenchmarkLine, printProfileDetails } from "../model-presenters.mjs";
+import { modelSelectOption, modelNameWidth, inferBackendId, formatSourceLabel, discoverySourceForItem, printGgufModelDetails, printManagedModelDetails, printProfileDetails } from "../model-presenters.mjs";
 import { runProfile } from "./run.mjs";
-
-const { stripVTControlCharacters } = await import("node:util");
+import { downloadFlow } from "../download.mjs";
+import { execFileAsync } from "../exec.mjs";
 
 export async function modelsCommand(argv) {
   await ensureDirs();
@@ -31,7 +38,19 @@ export async function modelCommandCenter(initialCatalog) {
     return;
   }
 
-  const catalog = initialCatalog.newModels ? initialCatalog : await loadModelCatalog();
+  let catalog = initialCatalog.newModels ? initialCatalog : await loadModelCatalog();
+
+  while (true) {
+    const result = await showModelPicker(catalog);
+    if (result === "rescan") {
+      catalog = await loadModelCatalog();
+      continue;
+    }
+    return;
+  }
+}
+
+async function showModelPicker(catalog) {
   const normalized = normalizeCatalog(catalog);
   const allItems = buildCatalogItems(normalized);
   if (allItems.length === 0) {
@@ -50,8 +69,14 @@ export async function modelCommandCenter(initialCatalog) {
       if (!(await modelAvailableOnServer(profile))) modelMissingIds.add(profile.id);
     }
   }
-  printWorkspaceHeader(normalized, runningProfilesNow, modelMissingIds);
-  await printBenchmarkLine();
+  // Flag all missing profiles (file missing for llama.cpp, model missing
+  // for oMLX managed-server) so actionsForItem/performAction can handle both
+  // cases uniformly.
+  for (const item of allItems) {
+    if (item.type === "profile") {
+      item.missing = item.fileMissing || modelMissingIds.has(item.profile.id);
+    }
+  }
 
   const nameWidth = modelNameWidth(allItems);
 
@@ -82,15 +107,10 @@ export async function modelCommandCenter(initialCatalog) {
   }
 
   const groups = [];
-  const backendColors = {
-    "llama-cpp": pc.cyan,
-    omlx: pc.magenta,
-  };
   for (const { backendId, sourceId, items } of byBackend.values()) {
     const backendLabel = backendFor(backendId)?.label ?? backendId;
     const sourceLabel = formatSourceLabel(sourceId);
-    const color = backendColors[backendId] ?? pc.dim;
-    const sep = `Inference: ${pc.bold(color(backendLabel))} ${pc.dim("|")} Source: ${sourceLabel} (${items.length})`;
+    const sep = `  ${pc.dim(backendLabel + " · " + sourceLabel + " (" + items.length + ")")}`;
     const groupItems = items.map((item) => {
       const opt = modelSelectOption(item, { runningProfilesNow, modelMissingIds, nameWidth, compact: true });
       return { value: opt.value, label: opt.label, description: opt.description };
@@ -103,13 +123,31 @@ export async function modelCommandCenter(initialCatalog) {
       const opt = modelSelectOption(item, { runningProfilesNow, modelMissingIds, nameWidth, compact: true });
       return { value: opt.value, label: opt.label, description: opt.description };
     });
-    groups.push({ separator: `  ${pc.bold(pc.yellow(`Needs setup (${setupItems.length})`))}`, items: groupItems });
+    groups.push({ separator: `  ${pc.yellow("Needs setup (" + setupItems.length + ")")}`, items: groupItems });
   }
 
+  groups.push({ separator: " ", items: [
+    { value: "__download__", label: `${pc.dim("○")}  ${pc.green("↓ Download a model")}` },
+    { value: "__settings__", label: `${pc.dim("○")}  ${pc.cyan("⚙ Status & settings")}` },
+  ] });
+
   const prompt = createPrompt();
   try {
     const selected = await modelSelect("Select a model", groups, { pageSize: 20 });
     if (!selected) return;
+
+    if (selected === "__settings__") {
+      await settingsFlow(prompt);
+      console.log("");
+      return;
+    }
+
+    if (selected === "__download__") {
+      await downloadFlow(prompt);
+      console.log("");
+      return;
+    }
+
     const item = allItems.find((candidate) => itemKey(candidate) === selected);
     if (!item) return;
 
@@ -117,6 +155,7 @@ export async function modelCommandCenter(initialCatalog) {
     const action = await prompt.choice(item.label, actions, actions[0].value);
     if (!action) return;
     await performAction(prompt, action, item);
+    console.log("");
   } finally {
     prompt.close();
   }
@@ -128,13 +167,13 @@ function formatActions(rawActions) {
   const width = Math.max(17, maxName + 2);
   return rawActions.map((a) => {
     const name = a.dimmed ? pc.dim(pc.strikethrough(a.name.padEnd(width).slice(0, width))) : pc.bold(a.name.padEnd(width).slice(0, width));
-    const desc = a.dimmed ? pc.red("file not found") : pc.dim(a.desc);
+    const desc = a.dimmed ? pc.red("not available") : pc.dim(a.desc);
     return { value: a.value, label: name + sep + desc };
   });
 }
 
 function actionsForItem(item) {
-  const missing = item.type === "profile" && item.fileMissing;
+  const missing = item.type === "profile" && item.missing;
   if (item.type === "profile") {
     const available = [
       { value: "inspect", name: "Details", desc: "Paths, ports, flags" },
@@ -144,21 +183,14 @@ function actionsForItem(item) {
         { value: "run", name: "Start chatting", desc: "Launch and open Pi" },
         { value: "reconfigure", name: "Reconfigure", desc: "Change context, MTP, settings" },
       );
-      const backend = backendFor(item.profile.backend);
-      if (backend.type === "local-server" || backend.type === "managed-server") {
-        available.push({ value: "benchmark", name: "Benchmark", desc: "Prepare a benchmark run" });
-      }
     }
-    available.push({ value: "remove", name: "Remove", desc: missing ? "Delete this broken setup" : "Delete this setup" });
+    available.push({ value: "remove_config", name: "Remove configuration", desc: "Delete this setup, keep model files" });
+    available.push({ value: "delete_model", name: "Delete model", desc: "Permanently remove from disk" });
     if (missing) {
       available.unshift(
         { value: "run", name: "Start chatting", desc: "Launch and open Pi", dimmed: true },
         { value: "reconfigure", name: "Reconfigure", desc: "Change context, MTP, settings", dimmed: true },
       );
-      const backend = backendFor(item.profile.backend);
-      if (backend.type === "local-server" || backend.type === "managed-server") {
-        available.push({ value: "benchmark", name: "Benchmark", desc: "Prepare a benchmark run", dimmed: true });
-      }
     }
     return formatActions(available);
   }
@@ -166,18 +198,22 @@ function actionsForItem(item) {
     return formatActions([
       { value: "setup", name: "Set up", desc: "Configure and save" },
       { value: "inspect", name: "Details", desc: "Model info" },
+      { value: "delete_model", name: "Delete model", desc: "Permanently remove from disk" },
     ]);
   }
   return formatActions([
     { value: "setup", name: "Set up", desc: `Connect via ${BACKENDS[item.backendId].label}` },
     { value: "inspect", name: "Details", desc: "Model info" },
+    { value: "delete_model", name: "Delete model", desc: "Permanently remove from disk" },
   ]);
 }
 
 async function performAction(prompt, action, item) {
-  const missing = item.type === "profile" && item.fileMissing;
-  if (missing && ["run", "reconfigure", "benchmark"].includes(action)) {
-    console.log(pc.red("This model's file is no longer on disk. Remove the setup or move the file back."));
+  const missing = item.type === "profile" && item.missing;
+  if (missing && ["run", "reconfigure"].includes(action)) {
+    const backend = item.type === "profile" ? backendFor(item.profile.backend) : null;
+    const reason = backend?.type === "managed-server" ? "model is no longer available on the server" : "model file is no longer on disk";
+    console.log(pc.red(`This model's ${reason}. Remove the setup or restore the model.`));
     return;
   }
   if (action === "inspect") {
@@ -185,17 +221,10 @@ async function performAction(prompt, action, item) {
     if (item.type === "managed") return printManagedModelDetails(item.model, BACKENDS[item.backendId]);
     return printGgufModelDetails(item.model, item.drafter);
   }
-  if (action === "benchmark") {
-    if (item.type === "profile") {
-      const { benchmarkForProfile } = await import("../benchmark.mjs");
-      return await benchmarkForProfile(await readProfile(item.profile.id));
-    }
-    const { benchmarkFlow } = await import("../benchmark.mjs");
-    return await benchmarkFlow();
-  }
   if (action === "run") return await runItem(item);
   if (action === "reconfigure" || action === "setup") return await setupItem(prompt, item);
-  if (action === "remove" && item.type === "profile") return await removeProfileInteractive(item.profile.id);
+  if (action === "remove_config" && item.type === "profile") return await removeProfileInteractive(item.profile.id);
+  if (action === "delete_model") return await deleteModelFromSource(prompt, item);
 }
 
 async function runItem(item) {
@@ -255,4 +284,232 @@ async function removeProfileInteractive(id) {
   await removeFromPiConfig(profile);
   await deleteProfile(id);
   console.log(pc.green(`Removed ${profile.label} (${profile.id})`));
+}
+
+// ── Delete model from source ───────────────────────────────────────────────
+
+/** Extract HuggingFace repo ID from a cache path. */
+function hfRepoFromPath(path) {
+  const hubPart = path.slice(HF_HUB_DIR.length);
+  const match = hubPart.match(/models--(.+?)(?=\/|$)/);
+  if (!match) return null;
+  return match[1].replace(/--/g, "/");
+}
+
+/** Determine where a model's files live on disk. */
+async function modelLocationForItem(item) {
+  if (item.type === "profile") {
+    const backend = backendFor(item.profile.backend);
+    if (backend.type === "managed-server") {
+      const modelId = item.profile.omlxModel || item.profile.modelAlias || item.profile.id;
+      // oMLX model IDs may not include the org prefix, so search recursively
+      const dir = await findOmlxModelDir(modelId);
+      return { kind: "mlx", dir: dir ?? join(homedir(), ".omlx", "models", ...modelId.replace(/--/g, "/").split("/").filter(Boolean)), modelId };
+    }
+    const modelPath = item.profile.modelPath;
+    if (!modelPath) return { kind: "unknown" };
+    if (modelPath.startsWith(HF_HUB_DIR)) {
+      return { kind: "hf-cache", path: modelPath, repoId: hfRepoFromPath(modelPath) };
+    }
+    return { kind: "file", path: modelPath };
+  }
+  if (item.type === "new") {
+    const modelPath = item.model?.path;
+    if (!modelPath) return { kind: "unknown" };
+    if (modelPath.startsWith(HF_HUB_DIR)) {
+      return { kind: "hf-cache", path: modelPath, repoId: hfRepoFromPath(modelPath) };
+    }
+    return { kind: "file", path: modelPath };
+  }
+  if (item.type === "managed") {
+    const modelId = item.model?.id;
+    if (!modelId) return { kind: "unknown" };
+    // oMLX model IDs may not include the org prefix, so search recursively
+    const dir = await findOmlxModelDir(modelId);
+    return { kind: "mlx", dir: dir ?? join(homedir(), ".omlx", "models", ...modelId.replace(/--/g, "/").split("/").filter(Boolean)), modelId };
+  }
+  return { kind: "unknown" };
+}
+
+async function deleteModelFromSource(prompt, item) {
+  const loc = await modelLocationForItem(item);
+
+  if (loc.kind === "unknown") {
+    console.log(pc.yellow("Could not determine where this model's files are located."));
+    return;
+  }
+
+  // Show what will be deleted
+  let locationLabel;
+  if (loc.kind === "hf-cache") {
+    locationLabel = loc.path ?? loc.repoId;
+  } else if (loc.kind === "mlx") {
+    locationLabel = loc.dir;
+  } else if (loc.kind === "file") {
+    locationLabel = loc.path;
+  }
+
+  console.log(pc.yellow("\nThis will permanently delete " + (item.type === "profile" ? "the configuration and the model from:" : "the model from:")));
+  console.log(pc.dim(`  ${locationLabel}`));
+
+  const confirmed = await prompt.yesNo("Delete this model?", false);
+  if (!confirmed) {
+    console.log(pc.dim("Cancelled."));
+    return;
+  }
+
+  // Stop running server if needed
+  if (item.type === "profile" && await isProfileRunning(item.profile)) {
+    console.log(pc.dim("Stopping running server..."));
+    await stopProfile(item.profile);
+  }
+
+  // Delete files
+  if (loc.kind === "hf-cache" && loc.repoId) {
+    const cacheDir = join(HF_HUB_DIR, `models--${loc.repoId.replace(/\//g, "--")}`);
+    try {
+      const { stdout } = await execFileAsync("hf", ["cache", "rm", `model/${loc.repoId}`, "--yes"], { timeout: 30000 });
+      if (stdout.trim()) console.log(pc.dim(stdout.trim()));
+      // Verify the directory is actually gone
+      if (existsSync(cacheDir)) {
+        console.log(pc.red(`✗ Model still exists at ${cacheDir}`));
+        console.log(pc.dim(`Delete manually: hf cache rm model/${loc.repoId}`));
+      } else {
+        console.log(pc.green(`✓ Deleted ${loc.repoId} from HuggingFace cache`));
+      }
+    } catch (err) {
+      const detail = err.stderr?.trim() || err.message;
+      console.log(pc.red(`✗ Failed: ${detail}`));
+      console.log(pc.dim(`Delete manually: hf cache rm model/${loc.repoId}`));
+    }
+  } else if (loc.kind === "mlx") {
+    const omlxModelsRoot = join(homedir(), ".omlx", "models");
+    // Safety guard: never delete outside ~/.omlx/models/
+    if (!loc.dir.startsWith(omlxModelsRoot + "/") && loc.dir !== omlxModelsRoot) {
+      console.log(pc.red(`✗ Refusing to delete: path is outside ~/.omlx/models/`));
+      console.log(pc.dim(`  Target: ${loc.dir}`));
+      console.log(pc.dim(`Delete manually if needed: rm -rf ${loc.dir}`));
+      return;
+    }
+    if (!existsSync(loc.dir)) {
+      console.log(pc.yellow(`Directory not found: ${loc.dir}`));
+      console.log(pc.dim("Model files may have already been removed, or oMLX loaded them from a different location."));
+    } else {
+      try {
+        await rm(loc.dir, { recursive: true, force: true });
+      } catch (err) {
+        console.log(pc.red(`✗ Failed: ${err.message}`));
+        console.log(pc.dim(`Delete manually: rm -rf ${loc.dir}`));
+        return;
+      }
+      // Verify deletion
+      if (existsSync(loc.dir)) {
+        console.log(pc.red(`✗ Directory still exists: ${loc.dir}`));
+        console.log(pc.dim(`Delete manually: rm -rf ${loc.dir}`));
+      } else {
+        console.log(pc.green(`✓ Deleted ${loc.dir}`));
+        await offerOmlxRestart(prompt, "to update its model list");
+      }
+    }
+  } else if (loc.kind === "file") {
+    if (!existsSync(loc.path)) {
+      console.log(pc.yellow(`File not found: ${loc.path}`));
+      console.log(pc.dim("Model file may have already been removed."));
+    } else {
+      try {
+        await unlink(loc.path);
+      } catch (err) {
+        console.log(pc.red(`✗ Failed: ${err.message}`));
+        console.log(pc.dim(`Delete manually: rm ${loc.path}`));
+        return;
+      }
+      // Verify deletion
+      if (existsSync(loc.path)) {
+        console.log(pc.red(`✗ File still exists: ${loc.path}`));
+        console.log(pc.dim(`Delete manually: rm ${loc.path}`));
+      } else {
+        console.log(pc.green(`✓ Deleted ${loc.path}`));
+      }
+    }
+  }
+
+  // Remove profile configuration if one exists
+  if (item.type === "profile") {
+    await removeFromPiConfig(item.profile);
+    await deleteProfile(item.profile.id);
+    console.log(pc.dim(`Removed configuration: ${item.profile.id}`));
+  }
+}
+
+// ── Settings & discovery path management ───────────────────────────────────
+
+async function settingsFlow(prompt) {
+  while (true) {
+    const llamaBinary = await findLlamaServer();
+    const omlxInstalled = await hasOmlx();
+    const piInstalled = await hasPi();
+
+    let omlxServerUp = false;
+    if (omlxInstalled) {
+      try {
+        const res = await fetch(`${BACKENDS.omlx.defaultBaseUrl}/models`, { signal: AbortSignal.timeout(2000) });
+        omlxServerUp = res.ok;
+      } catch { /* server down */ }
+    }
+
+    console.log("");
+    console.log(renderCard("Runtime status", renderRows([
+      ["llama.cpp", llamaBinary ? pc.green("✓ ") + pc.dim(llamaBinary) : pc.red("✗ not found")],
+      ["oMLX", omlxInstalled ? (omlxServerUp ? pc.green("✓ server up") : pc.yellow("✓ installed · server down")) : pc.red("✗ not found")],
+      ["Pi", piInstalled ? pc.green("✓ installed") : pc.red("✗ not found")],
+    ]), { formatBorder: pc.cyan }));
+
+    const scanDirs = await getModelScanDirs();
+    const defaultSet = new Set(DEFAULT_MODEL_DIRS);
+    const pathLabels = new Map([
+      [join(homedir(), ".lmstudio", "models"), "LM Studio downloads"],
+      [join(homedir(), ".omlx", "models"), "oMLX downloads"],
+      [HF_HUB_DIR, "HuggingFace CLI downloads"],
+    ]);
+    const pathRows = scanDirs.map((dir) => {
+      const exists = existsSync(dir);
+      const isBuiltin = defaultSet.has(dir);
+      const desc = pathLabels.get(dir);
+      const label = `${exists ? pc.green("✓") : pc.red("✗")}  ${dir}`;
+      const tags = [desc, isBuiltin ? "built-in" : "custom"].filter(Boolean).join(pc.dim(" · "));
+      return [label, pc.dim(tags)];
+    });
+    console.log("");
+    console.log(renderCard("Discovery paths", renderRows(pathRows), { formatBorder: pc.magenta }));
+
+    const customDirs = scanDirs.filter((d) => !defaultSet.has(d));
+    const choices = [
+      { value: "add", label: "Add discovery path" },
+      ...(customDirs.length > 0 ? [{ value: "remove", label: "Remove discovery path" }] : []),
+      { value: "done", label: "Done" },
+    ];
+    const action = await prompt.choice("Settings", choices, "done");
+
+    if (!action || action === "done") return;
+
+    if (action === "add") {
+      const dir = await prompt.text("Path to model directory", "");
+      if (!dir || !dir.trim()) continue;
+      const cleanDir = dir.trim();
+      if (!existsSync(cleanDir)) {
+        console.log(pc.red(`Directory not found: ${cleanDir}`));
+        continue;
+      }
+      await addModelScanDir(cleanDir);
+      console.log(pc.green(`Added: ${cleanDir}`));
+    }
+
+    if (action === "remove") {
+      const removeChoices = customDirs.map((d) => ({ value: d, label: d }));
+      const toRemove = await prompt.choice("Remove path", removeChoices);
+      if (!toRemove) continue;
+      await removeModelScanDir(toRemove);
+      console.log(pc.green(`Removed: ${toRemove}`));
+    }
+  }
 }