@holt-os/holt 0.7.0 → 0.8.2

package/dist/cli.js

@@ -22,6 +22,11 @@ var c = {
   red: wrap("31"),
   cyan: wrap("36")
 };
+function bar(fraction, width = 12) {
+  const f = Math.max(0, Math.min(1, fraction));
+  const filled = Math.round(f * width);
+  return c.green("\u2588".repeat(filled)) + c.dim("\u2591".repeat(width - filled));
+}
 function createReader() {
   const rl = readline.createInterface({ input: process.stdin, output: process.stdout });
   const buffer = [];
@@ -36,11 +41,11 @@ function createReader() {
     closed = true;
     while (waiters.length) waiters.shift()(null);
   });
-  const ask = (q) => new Promise((resolve3) => {
+  const ask = (q) => new Promise((resolve4) => {
     if (q) process.stdout.write(q);
-    if (buffer.length) resolve3(buffer.shift());
-    else if (closed) resolve3(null);
-    else waiters.push(resolve3);
+    if (buffer.length) resolve4(buffer.shift());
+    else if (closed) resolve4(null);
+    else waiters.push(resolve4);
   });
   return { ask, close: () => rl.close() };
 }
@@ -222,12 +227,12 @@ function renderPrompt(history, message, memory = []) {
   return parts.join("\n");
 }
 function runBrain(brain, prompt, onChunk) {
-  return new Promise((resolve3) => {
+  return new Promise((resolve4) => {
     let child;
     try {
       child = spawn(brain.command, [...brain.args, prompt], { stdio: ["ignore", "pipe", "pipe"] });
     } catch (e) {
-      resolve3({ ok: false, text: `Could not launch "${brain.command}": ${e.message}` });
+      resolve4({ ok: false, text: `Could not launch "${brain.command}": ${e.message}` });
       return;
     }
     let out = "";
@@ -240,11 +245,11 @@ function runBrain(brain, prompt, onChunk) {
     child.stderr.on("data", (d) => {
       err2 += d.toString();
     });
-    child.on("error", (e) => resolve3({ ok: false, text: `Could not run "${brain.command}": ${e.message}` }));
+    child.on("error", (e) => resolve4({ ok: false, text: `Could not run "${brain.command}": ${e.message}` }));
     child.on("close", (code) => {
       const text = out.trim();
-      if (code === 0 && text) resolve3({ ok: true, text });
-      else resolve3({ ok: false, text: err2.trim() || text || `"${brain.command}" exited with code ${code}` });
+      if (code === 0 && text) resolve4({ ok: true, text });
+      else resolve4({ ok: false, text: err2.trim() || text || `"${brain.command}" exited with code ${code}` });
     });
   });
 }
@@ -393,16 +398,16 @@ function currentAlias() {
 // src/install.ts
 import { spawn as spawn2 } from "child_process";
 function runInteractive(cmd, args) {
-  return new Promise((resolve3) => {
+  return new Promise((resolve4) => {
     let child;
     try {
       child = spawn2(cmd, args, { stdio: "inherit" });
     } catch {
-      resolve3(-1);
+      resolve4(-1);
       return;
     }
-    child.on("error", () => resolve3(-1));
-    child.on("close", (code) => resolve3(code ?? -1));
+    child.on("error", () => resolve4(-1));
+    child.on("close", (code) => resolve4(code ?? -1));
   });
 }
 
@@ -594,341 +599,161 @@ async function backfillEmbeddings(onProgress) {
   return { embedded, total: missing.length };
 }
 
-// src/commands/setting.ts
-function printStatus(cfg) {
-  console.log("\n" + c.accent("Holt settings") + c.dim("  (this folder)"));
-  for (const id of BRAIN_IDS) {
-    const b = cfg.brains[id];
-    const tags = [
-      b.enabled ? c.green("enabled") : isInstalled(b.command) ? c.dim("installed, off") : c.dim("not installed"),
-      cfg.defaultBrain === id ? c.accent("default") : ""
-    ].filter(Boolean).join("  ");
-    console.log(`  ${id.padEnd(10)} ${b.label.padEnd(16)} ${tags}`);
-  }
-  if (cfg.apiBrains.length) {
-    console.log(c.dim("  api brains:"));
-    for (const a of cfg.apiBrains) {
-      const key = resolveApiKey(a) ? c.green("key ok") : c.red("no key");
-      const def = cfg.defaultBrain === a.id ? c.accent("default") : "";
-      console.log(`  ${a.id.padEnd(10)} ${`${a.provider}/${a.model}`.padEnd(30)} ${key}  ${def}`);
-    }
-  }
-  console.log(c.dim(`  output format: ${cfg.outputFormat}`));
-  console.log(c.dim(`  launch command: ${currentAlias() || "holt (default)"}`));
-  console.log("\n  " + c.dim("[d] default brain   [t] toggle brain   [c] connect API brain   [x] remove API brain   [a] launch command   [enter] done"));
-}
-async function connectApiBrain(ask, cfg) {
-  let provider = null;
-  for (let tries = 0; tries < 3 && !provider; tries++) {
-    const provRaw = (await ask(`  provider [${PROVIDERS.join("/")}] (enter for ${PROVIDERS[0]}, or "skip"): `) ?? "skip").trim().toLowerCase();
-    if (provRaw === "skip" || provRaw === "q" || provRaw === "n" || provRaw === "no") {
-      console.log(c.dim('  skipped. Add one later with "holt setting" then "c".'));
-      return null;
-    }
-    if (provRaw === "") provider = PROVIDERS[0];
-    else if (PROVIDERS.includes(provRaw)) provider = provRaw;
-    else console.log(c.dim(`  "${provRaw}" is not a provider. Type one of: ${PROVIDERS.join(", ")}`));
-  }
-  if (!provider) {
-    console.log(c.dim('  skipped after three tries. Add one later with "holt setting" then "c".'));
-    return null;
-  }
-  const suggestion = PROVIDER_MODEL_SUGGESTION[provider];
-  const modelRaw = (await ask(`  model (enter for ${suggestion}): `) ?? "").trim();
-  const model = modelRaw || suggestion;
-  const idRaw = (await ask("  short name for this brain (e.g. sonnet): ") ?? "").trim();
-  if (!idRaw) {
-    console.log(c.dim("  cancelled (no name)."));
-    return null;
-  }
-  if (isReservedBrainId(idRaw)) {
-    console.log(c.red(`  "${idRaw}" is reserved for a CLI brain. Pick another name.`));
-    return null;
-  }
-  if (findApiBrain(cfg, idRaw)) {
-    console.log(c.red(`  an API brain named "${idRaw}" already exists.`));
+// src/telegram.ts
+import { readFileSync as readFileSync5, writeFileSync as writeFileSync5, existsSync as existsSync5, mkdirSync as mkdirSync5 } from "fs";
+import { join as join5 } from "path";
+var API_BASE = "https://api.telegram.org";
+var CHUNK_SIZE = 4e3;
+function telegramConfigPath() {
+  return join5(GLOBAL_DIR, "telegram.json");
+}
+function loadTelegramConfig() {
+  const path = telegramConfigPath();
+  if (!existsSync5(path)) return null;
+  try {
+    const raw = JSON.parse(readFileSync5(path, "utf8"));
+    if (typeof raw.token !== "string" || typeof raw.allowedChatId !== "number") return null;
+    return { token: raw.token, allowedChatId: raw.allowedChatId };
+  } catch {
     return null;
   }
-  console.log(c.dim("  key: paste a raw key (stored locally, mode 600), or type the name of an env var that holds it."));
-  const keyRaw = (await ask("  key or env var name: ") ?? "").trim();
-  let keyEnv;
-  if (!keyRaw) {
-    console.log(c.dim("  no key given now. You can set the standard env var later."));
-  } else if (/^[A-Z][A-Z0-9_]*$/.test(keyRaw)) {
-    keyEnv = keyRaw;
-    console.log(c.dim(`  will read the key from env var ${keyEnv}.`));
-  } else {
-    saveCredential(provider, keyRaw);
-    console.log(c.green(`  key stored in ~/.holt/credentials.json (mode 600).`));
-  }
-  const brain = { id: idRaw, provider, model, ...keyEnv ? { keyEnv } : {} };
-  cfg.apiBrains.push(brain);
-  const resolvable = resolveApiKey(brain);
-  console.log(c.green(`  connected "${idRaw}" -> ${provider}/${model}.`) + (resolvable ? "" : c.dim(" (no key resolves yet)")));
-  return brain;
 }
-function selectableIds(cfg) {
-  return [...BRAIN_IDS.filter((id) => cfg.brains[id].enabled), ...cfg.apiBrains.map((a) => a.id)];
+function saveTelegramConfig(cfg) {
+  mkdirSync5(GLOBAL_DIR, { recursive: true });
+  writeFileSync5(telegramConfigPath(), JSON.stringify(cfg, null, 2) + "\n", {
+    encoding: "utf8",
+    mode: 384
+  });
 }
-async function runSettings(ask) {
-  let cfg = loadConfig() ?? defaultConfig();
-  while (true) {
-    printStatus(cfg);
-    const raw = await ask("  > ");
-    const choice = (raw ?? "").trim().toLowerCase();
-    if (raw === null || choice === "" || choice === "q") break;
-    if (choice === "d") {
-      const options = selectableIds(cfg);
-      if (options.length === 0) {
-        console.log(c.dim('  No brains ready. Toggle a CLI brain on ("t") or connect an API brain ("c").'));
-        continue;
-      }
-      const pick = (await ask(`  default brain [${options.join("/")}]: `) ?? "").trim();
-      if (options.includes(pick)) {
-        cfg.defaultBrain = pick;
-        const label = BRAIN_IDS.includes(pick) ? cfg.brains[pick].label : pick;
-        console.log(c.green(`  default set to ${label}`));
-      } else console.log(c.dim("  unchanged."));
-    } else if (choice === "t") {
-      const pick = (await ask(`  toggle which brain [${BRAIN_IDS.join("/")}]: `) ?? "").trim();
-      if (BRAIN_IDS.includes(pick)) {
-        if (!cfg.brains[pick].enabled && !isInstalled(cfg.brains[pick].command)) {
-          console.log(c.dim(`  ${cfg.brains[pick].label} is not installed. Run "holt init" to install it.`));
-        } else {
-          cfg.brains[pick].enabled = !cfg.brains[pick].enabled;
-          if (!cfg.brains[pick].enabled && cfg.defaultBrain === pick) cfg.defaultBrain = selectableIds(cfg)[0] ?? null;
-          if (cfg.brains[pick].enabled && !cfg.defaultBrain) cfg.defaultBrain = pick;
-          console.log(c.dim(`  ${cfg.brains[pick].label} is now ${cfg.brains[pick].enabled ? "on" : "off"}.`));
-        }
-      } else console.log(c.dim("  unchanged."));
-    } else if (choice === "c") {
-      await connectApiBrain(ask, cfg);
-      if (!cfg.defaultBrain && cfg.apiBrains.length) cfg.defaultBrain = cfg.apiBrains[cfg.apiBrains.length - 1]?.id ?? null;
-    } else if (choice === "x") {
-      if (cfg.apiBrains.length === 0) {
-        console.log(c.dim("  no API brains to remove."));
-        continue;
-      }
-      const pick = (await ask(`  remove which API brain [${cfg.apiBrains.map((a) => a.id).join("/")}]: `) ?? "").trim();
-      const idx = cfg.apiBrains.findIndex((a) => a.id === pick);
-      if (idx >= 0) {
-        cfg.apiBrains.splice(idx, 1);
-        if (cfg.defaultBrain === pick) cfg.defaultBrain = selectableIds(cfg)[0] ?? null;
-        console.log(c.dim(`  removed "${pick}". (its stored key, if any, stays in ~/.holt/credentials.json)`));
-      } else console.log(c.dim("  unchanged."));
-    } else if (choice === "a") {
-      const name = (await ask("  launch command (blank to reset to holt): ") ?? "").trim();
-      if (name && name !== "holt") {
-        const r = installAlias(name);
-        if (r.ok && r.immediate) console.log(c.green(`  "${name}" is ready to use right now.`));
-        else if (r.ok) console.log(c.green(`  alias "${name}" added to ${r.file}. Run: source ${r.file} (new terminals will not need it).`));
-        else console.log(c.red("  " + r.message));
-      } else {
-        removeAlias();
-        console.log(c.dim("  reset to holt."));
+function buildSendRequest(token, chatId, text) {
+  return {
+    url: `${API_BASE}/bot${token}/sendMessage`,
+    body: JSON.stringify({ chat_id: chatId, text })
+  };
+}
+function buildGetUpdatesUrl(token, offset, timeoutSec) {
+  const params = new URLSearchParams({
+    offset: String(offset),
+    timeout: String(timeoutSec)
+  });
+  return `${API_BASE}/bot${token}/getUpdates?${params.toString()}`;
+}
+function chunk(text, size = CHUNK_SIZE) {
+  if (text.length === 0) return [""];
+  const out = [];
+  for (let i = 0; i < text.length; i += size) out.push(text.slice(i, i + size));
+  return out;
+}
+async function sendMessage(text, chatId) {
+  const cfg = loadTelegramConfig();
+  if (!cfg) {
+    process.stderr.write('[telegram] not configured; run "holt telegram setup"\n');
+    return false;
+  }
+  const target = chatId ?? cfg.allowedChatId;
+  const pieces = chunk(text || "No output.");
+  let allOk = true;
+  for (const piece of pieces) {
+    const { url, body } = buildSendRequest(cfg.token, target, piece);
+    try {
+      const res = await fetch(url, {
+        method: "POST",
+        headers: { "content-type": "application/json" },
+        body
+      });
+      if (!res.ok) {
+        allOk = false;
+        process.stderr.write(`[telegram] sendMessage HTTP ${res.status}
+`);
       }
-    } else {
-      console.log(c.dim("  pick d, t, c, x, a, or press enter to finish."));
+    } catch (err2) {
+      allOk = false;
+      process.stderr.write(`[telegram] sendMessage failed: ${err2.message}
+`);
     }
-    saveConfig(cfg);
   }
-  saveConfig(cfg);
-  return cfg;
+  return allOk;
 }
-async function setting() {
-  const { ask, close } = createReader();
-  if (!await ensureTrusted(ask)) {
-    close();
-    return;
+async function getUpdates(offset) {
+  const cfg = loadTelegramConfig();
+  if (!cfg) return [];
+  const timeoutSec = 30;
+  const url = buildGetUpdatesUrl(cfg.token, offset, timeoutSec);
+  const ac = new AbortController();
+  const timer = setTimeout(() => ac.abort(), (timeoutSec + 10) * 1e3);
+  try {
+    const res = await fetch(url, { signal: ac.signal });
+    if (!res.ok) {
+      process.stderr.write(`[telegram] getUpdates HTTP ${res.status}
+`);
+      return [];
+    }
+    const data = await res.json();
+    if (!data || data.ok !== true || !Array.isArray(data.result)) return [];
+    return data.result;
+  } catch (err2) {
+    process.stderr.write(`[telegram] getUpdates failed: ${err2.message}
+`);
+    return [];
+  } finally {
+    clearTimeout(timer);
   }
-  await runSettings(ask);
-  close();
-  console.log("");
 }
 
-// src/commands/init.ts
-function parseBrains(raw, found) {
-  const s = raw.trim().toLowerCase();
-  if (s === "") return found.length ? found : [...BRAIN_IDS];
-  if (s === "all") return [...BRAIN_IDS];
-  const picked = s.split(/[\s,]+/).filter((x) => BRAIN_IDS.includes(x));
-  if (picked.length) return [...new Set(picked)];
-  return found.length ? found : ["claude"];
+// src/runner.ts
+import { randomUUID as randomUUID2 } from "crypto";
+
+// src/apibrain.ts
+function parseSSELines(buffer) {
+  const normalized = buffer.replace(/\r\n/g, "\n");
+  const parts = normalized.split("\n\n");
+  const rest = parts.pop() ?? "";
+  const events = parts.filter((p) => p.trim() !== "");
+  return { events, rest };
 }
-async function init() {
-  const { ask, close } = createReader();
-  if (!await ensureTrusted(ask)) {
-    close();
-    return;
+function dataLines(event) {
+  const out = [];
+  for (const line of event.split("\n")) {
+    const t = line.replace(/\r$/, "");
+    if (t.startsWith("data:")) out.push(t.slice(5).replace(/^ /, ""));
   }
-  console.log(c.accent("Holt setup") + c.dim(`  (${workspace()})`) + "\n");
-  console.log("Looking for agent CLIs on your machine...\n");
-  const found = [];
-  for (const id of BRAIN_IDS) {
-    const ok2 = isInstalled(BRAIN_DEFS[id].command);
-    console.log(`  ${ok2 ? c.green("found  ") : c.dim("missing")}  ${BRAIN_DEFS[id].label} (${BRAIN_DEFS[id].command})`);
-    if (ok2) found.push(id);
+  return out;
+}
+function extractDelta(provider, json) {
+  const j = json;
+  if (provider === "anthropic") {
+    if (j["type"] === "content_block_delta") {
+      const delta = j["delta"];
+      if (delta && delta.type === "text_delta" && typeof delta.text === "string") return delta.text;
+    }
+    return "";
   }
-  console.log("");
-  const chosen = parseBrains(
-    await ask('Which brains do you want? claude, codex, gemini (comma-separated, or "all"): ') ?? "",
-    found
-  );
-  console.log(c.dim(`  using: ${chosen.join(", ")}`));
-  const toInstall = chosen.filter((id) => !isInstalled(BRAIN_DEFS[id].command));
-  const loginWanted = /* @__PURE__ */ new Set();
-  for (const id of toInstall) {
-    const a = (await ask(`  ${BRAIN_DEFS[id].label} is not installed. Sign in after install? [Y/n] `) ?? "").trim().toLowerCase();
-    if (a !== "n" && a !== "no") loginWanted.add(id);
+  if (provider === "openai") {
+    const choices = j["choices"];
+    const content = choices?.[0]?.delta?.content;
+    return typeof content === "string" ? content : "";
   }
-  const connectedApiBrains = [];
-  const apiAns = (await ask("\nAlso connect a direct API brain (raw key, no CLI needed)? [y/N] ") ?? "").trim().toLowerCase();
-  if (apiAns === "y" || apiAns === "yes") {
-    const holder = defaultConfig();
-    const brain = await connectApiBrain(ask, holder);
-    if (brain) connectedApiBrains.push(brain);
-  }
-  const defPick = chosen.includes("claude") ? "claude" : chosen[0];
-  const dans = (await ask(`
-Default brain? [${chosen.join("/")}] (${defPick}): `) ?? "").trim();
-  const defaultBrain = chosen.includes(dans) ? dans : defPick;
-  const aliasAns = (await ask('Launch command? Type a custom word like "ai", or press enter to keep "holt": ') ?? "").trim();
-  let aliasNote = "";
-  let aliasNeedsSource = "";
-  let aliasWorked = false;
-  if (aliasAns && aliasAns !== "holt") {
-    const r = installAlias(aliasAns);
-    aliasWorked = r.ok;
-    if (r.ok && r.immediate) aliasNote = c.green(`  "${aliasAns}" is ready to use right now (launcher at ${r.file}).`);
-    else if (r.ok) {
-      aliasNote = c.green(`  alias "${aliasAns}" -> holt chat added to ${r.file}`);
-      aliasNeedsSource = r.file;
-    } else aliasNote = c.red("  " + r.message);
-  }
-  let wantMemorySetup = false;
-  const embedReady = await embeddingsAvailable();
-  if (embedReady) {
-    console.log(c.dim("\nSemantic memory: ready (local Ollama with " + EMBED_MODEL + " detected)."));
-  } else {
-    const ollamaHere = isInstalled("ollama");
-    const q = ollamaHere ? `Semantic memory needs a local embed model. Pull ${EMBED_MODEL} with Ollama now? [Y/n] ` : "Enable private semantic memory? Installs Ollama plus a small local embed model. Everything stays on your machine. [Y/n] ";
-    const a = (await ask("\n" + q) ?? "").trim().toLowerCase();
-    wantMemorySetup = a !== "n" && a !== "no";
-    if (!wantMemorySetup) console.log(c.dim('  Okay. Memory still works with keyword recall; run "holt init" again anytime.'));
-  }
-  close();
-  for (const id of toInstall) {
-    const s = BRAIN_SETUP[id];
-    console.log("\n" + c.accent(`Installing ${BRAIN_DEFS[id].label}`) + c.dim(`  (${s.install.join(" ")})`));
-    const code = await runInteractive(s.install[0], s.install.slice(1));
-    console.log(code === 0 ? c.green(`  ${BRAIN_DEFS[id].label} installed.`) : c.red(`  Install failed (exit ${code}). Run manually: ${s.install.join(" ")}`));
-  }
-  for (const id of toInstall) {
-    if (!loginWanted.has(id) || !isInstalled(BRAIN_DEFS[id].command)) continue;
-    const s = BRAIN_SETUP[id];
-    console.log("\n" + c.accent(`Sign in to ${BRAIN_DEFS[id].label}`));
-    console.log(c.dim(`  Starting "${s.login.join(" ")}". Complete sign-in, then exit that tool to return here.`));
-    await runInteractive(s.login[0], s.login.slice(1));
-  }
-  if (wantMemorySetup) {
-    if (!isInstalled("ollama")) {
-      if (process.platform === "darwin" && isInstalled("brew")) {
-        console.log("\n" + c.accent("Installing Ollama") + c.dim("  (brew install ollama)"));
-        const code = await runInteractive("brew", ["install", "ollama"]);
-        if (code === 0) await runInteractive("brew", ["services", "start", "ollama"]);
-        else console.log(c.red('  Install failed. Get Ollama from https://ollama.com/download and run "holt init" again.'));
-      } else {
-        console.log(c.dim('\n  Get Ollama from https://ollama.com/download, then run "holt init" again to finish memory setup.'));
-      }
-    }
-    if (isInstalled("ollama")) {
-      console.log("\n" + c.accent("Pulling embed model") + c.dim(`  (ollama pull ${EMBED_MODEL})`));
-      const code = await runInteractive("ollama", ["pull", EMBED_MODEL]);
-      if (code !== 0) {
-        console.log(c.dim('  Could not pull. Start Ollama (open the app or run "ollama serve"), then run:'));
-        console.log(c.dim(`    ollama pull ${EMBED_MODEL}`));
-      }
-      resetEmbedProbe();
-      if (await embeddingsAvailable()) console.log(c.green("  Semantic memory is ready. Chats in trusted folders are stored and recalled locally."));
-    }
-  }
-  const cfg = loadConfig() ?? defaultConfig();
-  for (const id of BRAIN_IDS) cfg.brains[id].enabled = chosen.includes(id) && isInstalled(BRAIN_DEFS[id].command);
-  for (const b of connectedApiBrains) if (!cfg.apiBrains.some((a) => a.id === b.id)) cfg.apiBrains.push(b);
-  cfg.defaultBrain = cfg.brains[defaultBrain].enabled ? defaultBrain : BRAIN_IDS.find((id) => cfg.brains[id].enabled) ?? cfg.apiBrains[0]?.id ?? null;
-  saveConfig(cfg);
-  console.log("\n" + c.green("Saved to ./.holt/config.json"));
-  if (aliasNote) console.log(aliasNote);
-  if (cfg.defaultBrain) {
-    if (aliasWorked && !aliasNeedsSource) {
-      console.log("Start chatting:  " + c.accent(aliasAns) + "\n");
-    } else if (aliasNeedsSource) {
-      console.log("\nStart chatting:");
-      console.log("  " + c.accent(`source ${aliasNeedsSource}`) + c.dim("   (once; new terminals will not need it)"));
-      console.log("  " + c.accent(aliasAns) + "\n");
-      console.log(c.dim("  Or right now, without sourcing: holt chat\n"));
-    } else {
-      console.log("Start chatting:  " + c.accent("holt chat") + "\n");
-    }
-  } else {
-    console.log(c.dim('No brain is ready yet. Install one, then run "holt init" again.\n'));
-  }
-}
-
-// src/commands/chat.ts
-import { randomUUID as randomUUID2 } from "crypto";
-
-// src/apibrain.ts
-function parseSSELines(buffer) {
-  const normalized = buffer.replace(/\r\n/g, "\n");
-  const parts = normalized.split("\n\n");
-  const rest = parts.pop() ?? "";
-  const events = parts.filter((p) => p.trim() !== "");
-  return { events, rest };
-}
-function dataLines(event) {
-  const out = [];
-  for (const line of event.split("\n")) {
-    const t = line.replace(/\r$/, "");
-    if (t.startsWith("data:")) out.push(t.slice(5).replace(/^ /, ""));
-  }
-  return out;
-}
-function extractDelta(provider, json) {
-  const j = json;
-  if (provider === "anthropic") {
-    if (j["type"] === "content_block_delta") {
-      const delta = j["delta"];
-      if (delta && delta.type === "text_delta" && typeof delta.text === "string") return delta.text;
-    }
-    return "";
-  }
-  if (provider === "openai") {
-    const choices = j["choices"];
-    const content = choices?.[0]?.delta?.content;
-    return typeof content === "string" ? content : "";
-  }
-  const candidates = j["candidates"];
-  const parts = candidates?.[0]?.content?.parts;
-  if (!Array.isArray(parts)) return "";
-  return parts.map((p) => typeof p.text === "string" ? p.text : "").join("");
-}
-function buildRequest(brain, key, prompt) {
-  if (brain.provider === "anthropic") {
-    return {
-      url: "https://api.anthropic.com/v1/messages",
-      headers: {
-        "content-type": "application/json",
-        "x-api-key": key,
-        "anthropic-version": "2023-06-01"
-      },
-      body: JSON.stringify({
-        model: brain.model,
-        max_tokens: 4096,
-        stream: true,
-        messages: [{ role: "user", content: prompt }]
-      })
-    };
+  const candidates = j["candidates"];
+  const parts = candidates?.[0]?.content?.parts;
+  if (!Array.isArray(parts)) return "";
+  return parts.map((p) => typeof p.text === "string" ? p.text : "").join("");
+}
+function buildRequest(brain, key, prompt) {
+  if (brain.provider === "anthropic") {
+    return {
+      url: "https://api.anthropic.com/v1/messages",
+      headers: {
+        "content-type": "application/json",
+        "x-api-key": key,
+        "anthropic-version": "2023-06-01"
+      },
+      body: JSON.stringify({
+        model: brain.model,
+        max_tokens: 4096,
+        stream: true,
+        messages: [{ role: "user", content: prompt }]
+      })
+    };
   }
   if (brain.provider === "openai") {
     return {
@@ -988,8 +813,8 @@ async function runApiBrain(brain, prompt, onChunk) {
   let carry = "";
   let text = "";
   try {
-    for await (const chunk of res.body) {
-      carry += decoder.decode(chunk, { stream: true });
+    for await (const chunk2 of res.body) {
+      carry += decoder.decode(chunk2, { stream: true });
       const { events, rest } = parseSSELines(carry);
       carry = rest;
       for (const ev of events) {
@@ -1031,6 +856,625 @@ async function runApiBrain(brain, prompt, onChunk) {
   return { ok: false, text: `${brain.provider} returned an empty reply.` };
 }
 
+// src/skills.ts
+import { readFileSync as readFileSync6, readdirSync, existsSync as existsSync6, statSync as statSync2 } from "fs";
+import { join as join6 } from "path";
+function skillsRoot(scope) {
+  return scope === "workspace" ? join6(wsHoltDir(), "skills") : join6(GLOBAL_DIR, "skills");
+}
+function sanitizeName(name) {
+  return (name || "").trim().toLowerCase().replace(/[^a-z0-9-]+/g, "-").replace(/^-+|-+$/g, "").replace(/-{2,}/g, "-");
+}
+function parseFrontmatter(md) {
+  const text = md.replace(/^/, "");
+  const lines = text.split("\n");
+  let start = 0;
+  while (start < lines.length && lines[start].trim() === "") start++;
+  if (start >= lines.length || lines[start].trim() !== "---") {
+    return { data: {}, body: text.trim() };
+  }
+  const data = {};
+  let i = start + 1;
+  let closed = false;
+  for (; i < lines.length; i++) {
+    const line = lines[i];
+    if (line.trim() === "---") {
+      closed = true;
+      i++;
+      break;
+    }
+    const idx = line.indexOf(":");
+    if (idx === -1) continue;
+    const key = line.slice(0, idx).trim();
+    if (!key) continue;
+    let value = line.slice(idx + 1).trim();
+    if (value.length >= 2 && (value.startsWith('"') && value.endsWith('"') || value.startsWith("'") && value.endsWith("'"))) {
+      value = value.slice(1, -1);
+    }
+    data[key.toLowerCase()] = value;
+  }
+  if (!closed) {
+    return { data: {}, body: text.trim() };
+  }
+  return { data, body: lines.slice(i).join("\n").trim() };
+}
+function readSkill(dir, folder, scope) {
+  const file = join6(dir, "SKILL.md");
+  if (!existsSync6(file)) return null;
+  let raw = "";
+  try {
+    raw = readFileSync6(file, "utf8");
+  } catch {
+    return null;
+  }
+  const { data, body } = parseFrontmatter(raw);
+  const name = sanitizeName(data.name || folder) || folder;
+  let description = data.description || "";
+  if (!description) {
+    const firstLine2 = body.split("\n").map((l) => l.trim()).find((l) => l.length > 0) || "";
+    description = firstLine2.replace(/^#+\s*/, "");
+  }
+  return { name, description, dir, scope };
+}
+function listScope(scope) {
+  const root = skillsRoot(scope);
+  if (!existsSync6(root)) return [];
+  let entries;
+  try {
+    entries = readdirSync(root);
+  } catch {
+    return [];
+  }
+  const out = [];
+  for (const folder of entries) {
+    const dir = join6(root, folder);
+    try {
+      if (!statSync2(dir).isDirectory()) continue;
+    } catch {
+      continue;
+    }
+    const skill = readSkill(dir, folder, scope);
+    if (skill) out.push(skill);
+  }
+  return out;
+}
+function listSkills() {
+  const byName = /* @__PURE__ */ new Map();
+  for (const s of listScope("global")) byName.set(s.name, s);
+  for (const s of listScope("workspace")) byName.set(s.name, s);
+  return [...byName.values()].sort((a, b) => a.name.localeCompare(b.name));
+}
+function loadSkill(name) {
+  const want = sanitizeName(name);
+  const skill = listSkills().find((s) => s.name === want);
+  if (!skill) return null;
+  let raw = "";
+  try {
+    raw = readFileSync6(join6(skill.dir, "SKILL.md"), "utf8");
+  } catch {
+    return null;
+  }
+  const { body } = parseFrontmatter(raw);
+  return { skill, body };
+}
+function skillsPromptBlock() {
+  const skills = listSkills();
+  if (skills.length === 0) return "";
+  const lines = [
+    `Skills available to this user (invoked with "/skill <name>"). When the user invokes a skill, follow that skill's instructions:`,
+    ...skills.map((s) => `- ${s.name}: ${s.description || "(no description)"}`)
+  ];
+  return lines.join("\n");
+}
+function resolveSkillInvocation(line) {
+  const trimmed = line.trim();
+  const m = trimmed.match(/^\/skill\s+(\S+)\s*([\s\S]*)$/i);
+  if (!m) return null;
+  const name = m[1];
+  const input = (m[2] || "").trim();
+  const loaded = loadSkill(name);
+  if (!loaded) return null;
+  const prompt = [
+    loaded.body,
+    "",
+    "Apply the skill above to this request:",
+    input || "Introduce what you can do with this skill."
+  ].join("\n");
+  return { prompt, skillName: loaded.skill.name };
+}
+
+// src/runner.ts
+function resolveActive(cfg, id) {
+  if (BRAIN_IDS.includes(id)) {
+    const b = cfg.brains[id];
+    return { kind: "cli", id, label: b.label };
+  }
+  const api = findApiBrain(cfg, id);
+  if (api) return { kind: "api", id, label: `${id} (api: ${api.provider}/${api.model})`, brain: api };
+  return null;
+}
+async function runTask(task, opts = {}) {
+  try {
+    const cfg = loadConfig();
+    if (!cfg || !cfg.defaultBrain) {
+      return { ok: false, text: "No Holt setup in this folder. Run holt init.", brainLabel: "" };
+    }
+    const wantId = opts.brainId ?? cfg.defaultBrain;
+    const active = resolveActive(cfg, wantId);
+    if (!active) {
+      return { ok: false, text: `Brain "${wantId}" is not configured. Run holt setting.`, brainLabel: "" };
+    }
+    if (active.kind === "cli" && !isInstalled(cfg.brains[active.id].command)) {
+      return {
+        ok: false,
+        text: `${active.label} (${cfg.brains[active.id].command}) is not on your PATH. Install it or run holt setting.`,
+        brainLabel: active.label
+      };
+    }
+    if (active.kind === "api" && !resolveApiKey(active.brain)) {
+      return {
+        ok: false,
+        text: `${active.label} has no API key. Run holt setting to add one.`,
+        brainLabel: active.label
+      };
+    }
+    const runSession = "run-" + newSessionId();
+    const recalled = opts.recall !== false ? await recall(task, runSession, 4) : [];
+    const block = skillsPromptBlock();
+    const base = renderPrompt([], task, recalled);
+    const prompt = block ? block + "\n\n" + base : base;
+    const res = active.kind === "cli" ? await runBrain(cfg.brains[active.id], prompt, opts.onChunk) : await runApiBrain(active.brain, prompt, opts.onChunk);
+    if (res.ok && opts.store !== false) {
+      const now = Date.now();
+      appendTurn({ id: randomUUID2().slice(0, 8), ts: now, session: runSession, role: "user", content: task, emb: await embed(task) ?? void 0 });
+      appendTurn({ id: randomUUID2().slice(0, 8), ts: now, session: runSession, role: "assistant", content: res.text, emb: await embed(res.text) ?? void 0 });
+    }
+    return { ok: res.ok, text: res.text, brainLabel: active.label };
+  } catch (e) {
+    return { ok: false, text: e.message, brainLabel: "" };
+  }
+}
+
+// src/commands/telegram.ts
+var HELP_TEXT = "Holt bot. Send me anything and I will run it through your selected brain and reply.\nCommands: /help this message.";
+async function telegram(sub, _rest = []) {
+  const action = (sub || "").toLowerCase();
+  if (action === "setup") {
+    await setup();
+    return;
+  }
+  await runBot();
+}
+async function setupTelegram(ask) {
+  console.log("\n" + c.accent("Connect Holt to Telegram") + c.dim("  (chat with Holt from your phone)"));
+  console.log(c.dim("  1. Open Telegram and message @BotFather."));
+  console.log(c.dim("  2. Send /newbot, follow the prompts, and copy the bot token it gives you."));
+  console.log(c.dim("     A token looks like 123456789:AAF...  (keep it secret)."));
+  const token = (await ask("\n  Paste your bot token (enter to skip): ") ?? "").trim();
+  if (!token) {
+    console.log(c.dim('  Skipped. Set it up later with "holt telegram setup" or in "holt setting".'));
+    return false;
+  }
+  console.log("\n" + c.dim("  Now I need your chat id (so the bot only answers you)."));
+  console.log(c.dim("  Option A: open your new bot in Telegram and send it any message,"));
+  console.log(c.dim("            then I will auto-detect the chat id."));
+  console.log(c.dim("  Option B: paste a numeric chat id yourself."));
+  const mode = (await ask("\n  Auto-detect from a message you just sent? [Y/n] ") ?? "").trim().toLowerCase();
+  let allowedChatId = null;
+  if (mode === "" || mode === "y" || mode === "yes") {
+    saveTelegramConfig({ token, allowedChatId: 0 });
+    console.log(c.dim("\n  Checking for a recent message..."));
+    const updates = await getUpdates(0);
+    allowedChatId = latestChatId(updates);
+    if (allowedChatId === null) {
+      console.log(c.red("  Did not find a recent message."));
+      const manual = (await ask("  Paste your numeric chat id instead: ") ?? "").trim();
+      allowedChatId = parseChatId(manual);
+    }
+  } else {
+    const manual = (await ask("  Paste your numeric chat id: ") ?? "").trim();
+    allowedChatId = parseChatId(manual);
+  }
+  if (allowedChatId === null) {
+    console.log(c.red("\n  No valid chat id. Nothing saved. Try again anytime."));
+    return false;
+  }
+  const cfg = { token, allowedChatId };
+  saveTelegramConfig(cfg);
+  console.log(
+    "\n" + c.green("  Telegram connected.") + c.dim(` token ...${token.slice(-4)}  chat id ${allowedChatId}  (~/.holt/telegram.json, mode 600)`)
+  );
+  console.log(c.dim("  Start the bot anytime with: holt telegram"));
+  return true;
+}
+async function setup() {
+  const { ask, close } = createReader();
+  try {
+    await setupTelegram(ask);
+    console.log("");
+  } finally {
+    close();
+  }
+}
+function parseChatId(s) {
+  if (!/^-?\d+$/.test(s)) return null;
+  const n = Number(s);
+  return Number.isFinite(n) ? n : null;
+}
+function latestChatId(updates) {
+  for (let i = updates.length - 1; i >= 0; i--) {
+    const u = updates[i];
+    if (u && u.message) return u.message.chat.id;
+  }
+  return null;
+}
+async function runBot() {
+  const cfg = loadTelegramConfig();
+  if (!cfg) {
+    console.log(c.dim('\n  Telegram is not set up. Run "holt telegram setup" first.\n'));
+    return;
+  }
+  if (!isTrusted()) {
+    trustDir();
+    process.stderr.write(`[telegram] auto-trusted ${workspace()}
+`);
+  }
+  process.stderr.write("[telegram] bot started; long-polling for messages. Ctrl-C to stop.\n");
+  let offset = 0;
+  let busy = false;
+  while (true) {
+    let updates = [];
+    try {
+      updates = await getUpdates(offset);
+    } catch (err2) {
+      process.stderr.write(`[telegram] poll error: ${err2.message}
+`);
+      await sleep(1e3);
+      continue;
+    }
+    for (const u of updates) {
+      if (u && typeof u.update_id === "number") offset = Math.max(offset, u.update_id + 1);
+      try {
+        await handleUpdate(u, cfg, () => busy, (v) => {
+          busy = v;
+        });
+      } catch (err2) {
+        process.stderr.write(`[telegram] update ${u?.update_id} failed: ${err2.message}
+`);
+      }
+    }
+  }
+}
+async function handleUpdate(u, cfg, getBusy, setBusy) {
+  const msg = u?.message;
+  if (!msg || typeof msg.text !== "string") return;
+  if (msg.chat.id !== cfg.allowedChatId) {
+    process.stderr.write(`[telegram] ignoring message from chat ${msg.chat.id}
+`);
+    return;
+  }
+  const text = msg.text.trim();
+  if (text === "/start" || text === "/help") {
+    await sendMessage(HELP_TEXT, cfg.allowedChatId);
+    return;
+  }
+  if (getBusy()) {
+    await sendMessage("Still working on the previous message. Try again in a moment.", cfg.allowedChatId);
+    return;
+  }
+  setBusy(true);
+  try {
+    process.stderr.write(`[telegram] running task (${text.length} chars)
+`);
+    const result = await runTask(text);
+    await sendMessage(result.text || "No output.", cfg.allowedChatId);
+    process.stderr.write(`[telegram] replied (brain: ${result.brainLabel})
+`);
+  } catch (err2) {
+    process.stderr.write(`[telegram] runTask failed: ${err2.message}
+`);
+    await sendMessage("Sorry, that run failed. Check the Holt logs.", cfg.allowedChatId);
+  } finally {
+    setBusy(false);
+  }
+}
+function sleep(ms) {
+  return new Promise((r) => setTimeout(r, ms));
+}
+
+// src/commands/setting.ts
+function printStatus(cfg) {
+  console.log("\n" + c.accent("Holt settings") + c.dim("  (this folder)"));
+  for (const id of BRAIN_IDS) {
+    const b = cfg.brains[id];
+    const tags = [
+      b.enabled ? c.green("enabled") : isInstalled(b.command) ? c.dim("installed, off") : c.dim("not installed"),
+      cfg.defaultBrain === id ? c.accent("default") : ""
+    ].filter(Boolean).join("  ");
+    console.log(`  ${id.padEnd(10)} ${b.label.padEnd(16)} ${tags}`);
+  }
+  if (cfg.apiBrains.length) {
+    console.log(c.dim("  api brains:"));
+    for (const a of cfg.apiBrains) {
+      const key = resolveApiKey(a) ? c.green("key ok") : c.red("no key");
+      const def = cfg.defaultBrain === a.id ? c.accent("default") : "";
+      console.log(`  ${a.id.padEnd(10)} ${`${a.provider}/${a.model}`.padEnd(30)} ${key}  ${def}`);
+    }
+  }
+  console.log(c.dim(`  output format: ${cfg.outputFormat}`));
+  console.log(c.dim(`  launch command: ${currentAlias() || "holt (default)"}`));
+  const tg = loadTelegramConfig();
+  console.log(c.dim(`  telegram: ${tg ? `connected (chat ${tg.allowedChatId})` : "not set up"}`));
+  console.log("\n  " + c.dim("[d] default brain   [t] toggle brain   [c] connect API brain   [x] remove API brain"));
+  console.log("  " + c.dim("[a] launch command   [m] connect Telegram   [enter] done"));
+}
+async function connectApiBrain(ask, cfg) {
+  let provider = null;
+  for (let tries = 0; tries < 3 && !provider; tries++) {
+    const provRaw = (await ask(`  provider [${PROVIDERS.join("/")}] (enter for ${PROVIDERS[0]}, or "skip"): `) ?? "skip").trim().toLowerCase();
+    if (provRaw === "skip" || provRaw === "q" || provRaw === "n" || provRaw === "no") {
+      console.log(c.dim('  skipped. Add one later with "holt setting" then "c".'));
+      return null;
+    }
+    if (provRaw === "") provider = PROVIDERS[0];
+    else if (PROVIDERS.includes(provRaw)) provider = provRaw;
+    else console.log(c.dim(`  "${provRaw}" is not a provider. Type one of: ${PROVIDERS.join(", ")}`));
+  }
+  if (!provider) {
+    console.log(c.dim('  skipped after three tries. Add one later with "holt setting" then "c".'));
+    return null;
+  }
+  const suggestion = PROVIDER_MODEL_SUGGESTION[provider];
+  const modelRaw = (await ask(`  model (enter for ${suggestion}): `) ?? "").trim();
+  const model = modelRaw || suggestion;
+  const idRaw = (await ask("  short name for this brain (e.g. sonnet): ") ?? "").trim();
+  if (!idRaw) {
+    console.log(c.dim("  cancelled (no name)."));
+    return null;
+  }
+  if (isReservedBrainId(idRaw)) {
+    console.log(c.red(`  "${idRaw}" is reserved for a CLI brain. Pick another name.`));
+    return null;
+  }
+  if (findApiBrain(cfg, idRaw)) {
+    console.log(c.red(`  an API brain named "${idRaw}" already exists.`));
+    return null;
+  }
+  console.log(c.dim("  key: paste a raw key (stored locally, mode 600), or type the name of an env var that holds it."));
+  const keyRaw = (await ask("  key or env var name: ") ?? "").trim();
+  let keyEnv;
+  if (!keyRaw) {
+    console.log(c.dim("  no key given now. You can set the standard env var later."));
+  } else if (/^[A-Z][A-Z0-9_]*$/.test(keyRaw)) {
+    keyEnv = keyRaw;
+    console.log(c.dim(`  will read the key from env var ${keyEnv}.`));
+  } else {
+    saveCredential(provider, keyRaw);
+    console.log(c.green(`  key stored in ~/.holt/credentials.json (mode 600).`));
+  }
+  const brain = { id: idRaw, provider, model, ...keyEnv ? { keyEnv } : {} };
+  cfg.apiBrains.push(brain);
+  const resolvable = resolveApiKey(brain);
+  console.log(c.green(`  connected "${idRaw}" -> ${provider}/${model}.`) + (resolvable ? "" : c.dim(" (no key resolves yet)")));
+  return brain;
+}
+function selectableIds(cfg) {
+  return [...BRAIN_IDS.filter((id) => cfg.brains[id].enabled), ...cfg.apiBrains.map((a) => a.id)];
+}
+async function runSettings(ask) {
+  let cfg = loadConfig() ?? defaultConfig();
+  while (true) {
+    printStatus(cfg);
+    const raw = await ask("  > ");
+    const choice = (raw ?? "").trim().toLowerCase();
+    if (raw === null || choice === "" || choice === "q") break;
+    if (choice === "d") {
+      const options = selectableIds(cfg);
+      if (options.length === 0) {
+        console.log(c.dim('  No brains ready. Toggle a CLI brain on ("t") or connect an API brain ("c").'));
+        continue;
+      }
+      const pick = (await ask(`  default brain [${options.join("/")}]: `) ?? "").trim();
+      if (options.includes(pick)) {
+        cfg.defaultBrain = pick;
+        const label = BRAIN_IDS.includes(pick) ? cfg.brains[pick].label : pick;
+        console.log(c.green(`  default set to ${label}`));
+      } else console.log(c.dim("  unchanged."));
+    } else if (choice === "t") {
+      const pick = (await ask(`  toggle which brain [${BRAIN_IDS.join("/")}]: `) ?? "").trim();
+      if (BRAIN_IDS.includes(pick)) {
+        if (!cfg.brains[pick].enabled && !isInstalled(cfg.brains[pick].command)) {
+          console.log(c.dim(`  ${cfg.brains[pick].label} is not installed. Run "holt init" to install it.`));
+        } else {
+          cfg.brains[pick].enabled = !cfg.brains[pick].enabled;
+          if (!cfg.brains[pick].enabled && cfg.defaultBrain === pick) cfg.defaultBrain = selectableIds(cfg)[0] ?? null;
+          if (cfg.brains[pick].enabled && !cfg.defaultBrain) cfg.defaultBrain = pick;
+          console.log(c.dim(`  ${cfg.brains[pick].label} is now ${cfg.brains[pick].enabled ? "on" : "off"}.`));
+        }
+      } else console.log(c.dim("  unchanged."));
+    } else if (choice === "c") {
+      await connectApiBrain(ask, cfg);
+      if (!cfg.defaultBrain && cfg.apiBrains.length) cfg.defaultBrain = cfg.apiBrains[cfg.apiBrains.length - 1]?.id ?? null;
+    } else if (choice === "x") {
+      if (cfg.apiBrains.length === 0) {
+        console.log(c.dim("  no API brains to remove."));
+        continue;
+      }
+      const pick = (await ask(`  remove which API brain [${cfg.apiBrains.map((a) => a.id).join("/")}]: `) ?? "").trim();
+      const idx = cfg.apiBrains.findIndex((a) => a.id === pick);
+      if (idx >= 0) {
+        cfg.apiBrains.splice(idx, 1);
+        if (cfg.defaultBrain === pick) cfg.defaultBrain = selectableIds(cfg)[0] ?? null;
+        console.log(c.dim(`  removed "${pick}". (its stored key, if any, stays in ~/.holt/credentials.json)`));
+      } else console.log(c.dim("  unchanged."));
+    } else if (choice === "a") {
+      const name = (await ask("  launch command (blank to reset to holt): ") ?? "").trim();
+      if (name && name !== "holt") {
+        const r = installAlias(name);
+        if (r.ok && r.immediate) console.log(c.green(`  "${name}" is ready to use right now.`));
+        else if (r.ok) console.log(c.green(`  alias "${name}" added to ${r.file}. Run: source ${r.file} (new terminals will not need it).`));
+        else console.log(c.red("  " + r.message));
+      } else {
+        removeAlias();
+        console.log(c.dim("  reset to holt."));
+      }
+    } else if (choice === "m") {
+      await setupTelegram(ask);
+    } else {
+      console.log(c.dim("  pick d, t, c, x, a, m, or press enter to finish."));
+    }
+    saveConfig(cfg);
+  }
+  saveConfig(cfg);
+  return cfg;
+}
+async function setting() {
+  const { ask, close } = createReader();
+  if (!await ensureTrusted(ask)) {
+    close();
+    return;
+  }
+  await runSettings(ask);
+  close();
+  console.log("");
+}
+
+// src/commands/init.ts
+function parseBrains(raw, found) {
+  const s = raw.trim().toLowerCase();
+  if (s === "") return found.length ? found : [...BRAIN_IDS];
+  if (s === "all") return [...BRAIN_IDS];
+  const picked = s.split(/[\s,]+/).filter((x) => BRAIN_IDS.includes(x));
+  if (picked.length) return [...new Set(picked)];
+  return found.length ? found : ["claude"];
+}
+async function init() {
+  const { ask, close } = createReader();
+  if (!await ensureTrusted(ask)) {
+    close();
+    return;
+  }
+  console.log(c.accent("Holt setup") + c.dim(`  (${workspace()})`) + "\n");
+  console.log("Looking for agent CLIs on your machine...\n");
+  const found = [];
+  for (const id of BRAIN_IDS) {
+    const ok2 = isInstalled(BRAIN_DEFS[id].command);
+    console.log(`  ${ok2 ? c.green("found  ") : c.dim("missing")}  ${BRAIN_DEFS[id].label} (${BRAIN_DEFS[id].command})`);
+    if (ok2) found.push(id);
+  }
+  console.log("");
+  const chosen = parseBrains(
+    await ask('Which brains do you want? claude, codex, gemini (comma-separated, or "all"): ') ?? "",
+    found
+  );
+  console.log(c.dim(`  using: ${chosen.join(", ")}`));
+  const toInstall = chosen.filter((id) => !isInstalled(BRAIN_DEFS[id].command));
+  const loginWanted = /* @__PURE__ */ new Set();
+  for (const id of toInstall) {
+    const a = (await ask(`  ${BRAIN_DEFS[id].label} is not installed. Sign in after install? [Y/n] `) ?? "").trim().toLowerCase();
+    if (a !== "n" && a !== "no") loginWanted.add(id);
+  }
+  const connectedApiBrains = [];
+  const apiAns = (await ask("\nAlso connect a direct API brain (raw key, no CLI needed)? [y/N] ") ?? "").trim().toLowerCase();
+  if (apiAns === "y" || apiAns === "yes") {
+    const holder = defaultConfig();
+    const brain = await connectApiBrain(ask, holder);
+    if (brain) connectedApiBrains.push(brain);
+  }
+  const defPick = chosen.includes("claude") ? "claude" : chosen[0];
+  const dans = (await ask(`
+Default brain? [${chosen.join("/")}] (${defPick}): `) ?? "").trim();
+  const defaultBrain = chosen.includes(dans) ? dans : defPick;
+  const aliasAns = (await ask('Launch command? Type a custom word like "ai", or press enter to keep "holt": ') ?? "").trim();
+  let aliasNote = "";
+  let aliasNeedsSource = "";
+  let aliasWorked = false;
+  if (aliasAns && aliasAns !== "holt") {
+    const r = installAlias(aliasAns);
+    aliasWorked = r.ok;
+    if (r.ok && r.immediate) aliasNote = c.green(`  "${aliasAns}" is ready to use right now (launcher at ${r.file}).`);
+    else if (r.ok) {
+      aliasNote = c.green(`  alias "${aliasAns}" -> holt chat added to ${r.file}`);
+      aliasNeedsSource = r.file;
+    } else aliasNote = c.red("  " + r.message);
+  }
+  let wantMemorySetup = false;
+  const embedReady = await embeddingsAvailable();
+  if (embedReady) {
+    console.log(c.dim("\nSemantic memory: ready (local Ollama with " + EMBED_MODEL + " detected)."));
+  } else {
+    const ollamaHere = isInstalled("ollama");
+    const q = ollamaHere ? `Semantic memory needs a local embed model. Pull ${EMBED_MODEL} with Ollama now? [Y/n] ` : "Enable private semantic memory? Installs Ollama plus a small local embed model. Everything stays on your machine. [Y/n] ";
+    const a = (await ask("\n" + q) ?? "").trim().toLowerCase();
+    wantMemorySetup = a !== "n" && a !== "no";
+    if (!wantMemorySetup) console.log(c.dim('  Okay. Memory still works with keyword recall; run "holt init" again anytime.'));
+  }
+  if (!loadTelegramConfig()) {
+    const tgAns = (await ask("\nChat with Holt from your phone over Telegram? [y/N] ") ?? "").trim().toLowerCase();
+    if (tgAns === "y" || tgAns === "yes") await setupTelegram(ask);
+  }
+  close();
+  for (const id of toInstall) {
+    const s = BRAIN_SETUP[id];
+    console.log("\n" + c.accent(`Installing ${BRAIN_DEFS[id].label}`) + c.dim(`  (${s.install.join(" ")})`));
+    const code = await runInteractive(s.install[0], s.install.slice(1));
+    console.log(code === 0 ? c.green(`  ${BRAIN_DEFS[id].label} installed.`) : c.red(`  Install failed (exit ${code}). Run manually: ${s.install.join(" ")}`));
+  }
+  for (const id of toInstall) {
+    if (!loginWanted.has(id) || !isInstalled(BRAIN_DEFS[id].command)) continue;
+    const s = BRAIN_SETUP[id];
+    console.log("\n" + c.accent(`Sign in to ${BRAIN_DEFS[id].label}`));
+    console.log(c.dim(`  Starting "${s.login.join(" ")}". Complete sign-in, then exit that tool to return here.`));
+    await runInteractive(s.login[0], s.login.slice(1));
+  }
+  if (wantMemorySetup) {
+    if (!isInstalled("ollama")) {
+      if (process.platform === "darwin" && isInstalled("brew")) {
+        console.log("\n" + c.accent("Installing Ollama") + c.dim("  (brew install ollama)"));
+        const code = await runInteractive("brew", ["install", "ollama"]);
+        if (code === 0) await runInteractive("brew", ["services", "start", "ollama"]);
+        else console.log(c.red('  Install failed. Get Ollama from https://ollama.com/download and run "holt init" again.'));
+      } else {
+        console.log(c.dim('\n  Get Ollama from https://ollama.com/download, then run "holt init" again to finish memory setup.'));
+      }
+    }
+    if (isInstalled("ollama")) {
+      console.log("\n" + c.accent("Pulling embed model") + c.dim(`  (ollama pull ${EMBED_MODEL})`));
+      const code = await runInteractive("ollama", ["pull", EMBED_MODEL]);
+      if (code !== 0) {
+        console.log(c.dim('  Could not pull. Start Ollama (open the app or run "ollama serve"), then run:'));
+        console.log(c.dim(`    ollama pull ${EMBED_MODEL}`));
+      }
+      resetEmbedProbe();
+      if (await embeddingsAvailable()) console.log(c.green("  Semantic memory is ready. Chats in trusted folders are stored and recalled locally."));
+    }
+  }
+  const cfg = loadConfig() ?? defaultConfig();
+  for (const id of BRAIN_IDS) cfg.brains[id].enabled = chosen.includes(id) && isInstalled(BRAIN_DEFS[id].command);
+  for (const b of connectedApiBrains) if (!cfg.apiBrains.some((a) => a.id === b.id)) cfg.apiBrains.push(b);
+  cfg.defaultBrain = cfg.brains[defaultBrain].enabled ? defaultBrain : BRAIN_IDS.find((id) => cfg.brains[id].enabled) ?? cfg.apiBrains[0]?.id ?? null;
+  saveConfig(cfg);
+  console.log("\n" + c.green("Saved to ./.holt/config.json"));
+  if (aliasNote) console.log(aliasNote);
+  if (cfg.defaultBrain) {
+    if (aliasWorked && !aliasNeedsSource) {
+      console.log("Start chatting:  " + c.accent(aliasAns) + "\n");
+    } else if (aliasNeedsSource) {
+      console.log("\nStart chatting:");
+      console.log("  " + c.accent(`source ${aliasNeedsSource}`) + c.dim("   (once; new terminals will not need it)"));
+      console.log("  " + c.accent(aliasAns) + "\n");
+      console.log(c.dim("  Or right now, without sourcing: holt chat\n"));
+    } else {
+      console.log("Start chatting:  " + c.accent("holt chat") + "\n");
+    }
+  } else {
+    console.log(c.dim('No brain is ready yet. Install one, then run "holt init" again.\n'));
+  }
+}
+
+// src/commands/chat.ts
+import { randomUUID as randomUUID3 } from "crypto";
+
 // src/facts.ts
 var MIN_EXCHANGES_FOR_EXTRACTION = 3;
 var MAX_TRANSCRIPT_TURNS = 20;
@@ -1141,8 +1585,8 @@ async function extractAndSaveFacts(active, cfg, history, session) {
 }
 
 // src/output.ts
-import { writeFileSync as writeFileSync5 } from "fs";
-import { join as join5 } from "path";
+import { writeFileSync as writeFileSync6 } from "fs";
+import { join as join7 } from "path";
 function escapeHtml(s) {
   return s.replace(/&/g, "&amp;").replace(/</g, "&lt;").replace(/>/g, "&gt;");
 }
@@ -1275,139 +1719,19 @@ function saveReply(reply, format, name) {
   let base = (name ?? "").trim();
   if (!base) base = `holt-reply-${timestamp()}`;
   if (!/\.[a-z0-9]+$/i.test(base)) base += ext;
-  const path = join5(process.cwd(), base);
-  writeFileSync5(path, renderReply(reply, format), "utf8");
+  const path = join7(process.cwd(), base);
+  writeFileSync6(path, renderReply(reply, format), "utf8");
   return path;
 }
 
-// src/skills.ts
-import { readFileSync as readFileSync5, readdirSync, existsSync as existsSync5, statSync as statSync2 } from "fs";
-import { join as join6 } from "path";
-function skillsRoot(scope) {
-  return scope === "workspace" ? join6(wsHoltDir(), "skills") : join6(GLOBAL_DIR, "skills");
-}
-function sanitizeName(name) {
-  return (name || "").trim().toLowerCase().replace(/[^a-z0-9-]+/g, "-").replace(/^-+|-+$/g, "").replace(/-{2,}/g, "-");
-}
-function parseFrontmatter(md) {
-  const text = md.replace(/^/, "");
-  const lines = text.split("\n");
-  let start = 0;
-  while (start < lines.length && lines[start].trim() === "") start++;
-  if (start >= lines.length || lines[start].trim() !== "---") {
-    return { data: {}, body: text.trim() };
-  }
-  const data = {};
-  let i = start + 1;
-  let closed = false;
-  for (; i < lines.length; i++) {
-    const line = lines[i];
-    if (line.trim() === "---") {
-      closed = true;
-      i++;
-      break;
-    }
-    const idx = line.indexOf(":");
-    if (idx === -1) continue;
-    const key = line.slice(0, idx).trim();
-    if (!key) continue;
-    let value = line.slice(idx + 1).trim();
-    if (value.length >= 2 && (value.startsWith('"') && value.endsWith('"') || value.startsWith("'") && value.endsWith("'"))) {
-      value = value.slice(1, -1);
-    }
-    data[key.toLowerCase()] = value;
-  }
-  if (!closed) {
-    return { data: {}, body: text.trim() };
-  }
-  return { data, body: lines.slice(i).join("\n").trim() };
-}
-function readSkill(dir, folder, scope) {
-  const file = join6(dir, "SKILL.md");
-  if (!existsSync5(file)) return null;
-  let raw = "";
-  try {
-    raw = readFileSync5(file, "utf8");
-  } catch {
-    return null;
-  }
-  const { data, body } = parseFrontmatter(raw);
-  const name = sanitizeName(data.name || folder) || folder;
-  let description = data.description || "";
-  if (!description) {
-    const firstLine2 = body.split("\n").map((l) => l.trim()).find((l) => l.length > 0) || "";
-    description = firstLine2.replace(/^#+\s*/, "");
-  }
-  return { name, description, dir, scope };
-}
-function listScope(scope) {
-  const root = skillsRoot(scope);
-  if (!existsSync5(root)) return [];
-  let entries;
-  try {
-    entries = readdirSync(root);
-  } catch {
-    return [];
-  }
-  const out = [];
-  for (const folder of entries) {
-    const dir = join6(root, folder);
-    try {
-      if (!statSync2(dir).isDirectory()) continue;
-    } catch {
-      continue;
-    }
-    const skill = readSkill(dir, folder, scope);
-    if (skill) out.push(skill);
-  }
-  return out;
-}
-function listSkills() {
-  const byName = /* @__PURE__ */ new Map();
-  for (const s of listScope("global")) byName.set(s.name, s);
-  for (const s of listScope("workspace")) byName.set(s.name, s);
-  return [...byName.values()].sort((a, b) => a.name.localeCompare(b.name));
-}
-function loadSkill(name) {
-  const want = sanitizeName(name);
-  const skill = listSkills().find((s) => s.name === want);
-  if (!skill) return null;
-  let raw = "";
-  try {
-    raw = readFileSync5(join6(skill.dir, "SKILL.md"), "utf8");
-  } catch {
-    return null;
-  }
-  const { body } = parseFrontmatter(raw);
-  return { skill, body };
-}
-function skillsPromptBlock() {
-  const skills = listSkills();
-  if (skills.length === 0) return "";
-  const lines = [
-    `Skills available to this user (invoked with "/skill <name>"). When the user invokes a skill, follow that skill's instructions:`,
-    ...skills.map((s) => `- ${s.name}: ${s.description || "(no description)"}`)
-  ];
-  return lines.join("\n");
-}
-function resolveSkillInvocation(line) {
-  const trimmed = line.trim();
-  const m = trimmed.match(/^\/skill\s+(\S+)\s*([\s\S]*)$/i);
-  if (!m) return null;
-  const name = m[1];
-  const input = (m[2] || "").trim();
-  const loaded = loadSkill(name);
-  if (!loaded) return null;
-  const prompt = [
-    loaded.body,
-    "",
-    "Apply the skill above to this request:",
-    input || "Introduce what you can do with this skill."
-  ].join("\n");
-  return { prompt, skillName: loaded.skill.name };
-}
-
 // src/commands/chat.ts
+function statusLine(brainLabel, history) {
+  const live = Math.min(history.length, MAX_REPLAY_TURNS);
+  const frac = MAX_REPLAY_TURNS ? live / MAX_REPLAY_TURNS : 0;
+  const pct = Math.round(frac * 100);
+  const mem = memStats().turns;
+  return c.dim("  " + brainLabel + "  ") + c.dim("[") + bar(frac) + c.dim("]") + c.dim(`  ${pct}% context  \xB7  ${mem} in memory`);
+}
 function help() {
   console.log(c.dim([
     "  commands:",
@@ -1422,7 +1746,7 @@ function help() {
     "    /exit             leave"
   ].join("\n")));
 }
-function resolveActive(cfg, id) {
+function resolveActive2(cfg, id) {
   if (BRAIN_IDS.includes(id)) {
     const b = cfg.brains[id];
     return { kind: "cli", id, label: b.label };
@@ -1449,10 +1773,10 @@ async function chat() {
     console.log(c.dim('\nSetup done. Run "holt chat" to start talking.\n'));
     return;
   }
-  let active = resolveActive(cfg, cfg.defaultBrain);
+  let active = resolveActive2(cfg, cfg.defaultBrain);
   if (!active) {
     const fallback = BRAIN_IDS.find((id) => cfg.brains[id].enabled) ?? cfg.apiBrains[0]?.id ?? null;
-    active = fallback ? resolveActive(cfg, fallback) : null;
+    active = fallback ? resolveActive2(cfg, fallback) : null;
     if (!active) {
       close();
       console.log(c.dim('\nNo brain is ready. Run "holt setting".\n'));
@@ -1471,7 +1795,8 @@ async function chat() {
   if (embedOk && stats.withEmbeddings < stats.turns) {
     console.log(c.dim(`  ${stats.turns - stats.withEmbeddings} older moments lack embeddings. Run "holt memory embed" to upgrade them.`));
   }
-  console.log(c.dim("Type a message. Commands: /brain  /memory  /output  /save  /setting  /clear  /help  /exit\n"));
+  console.log(c.dim("Type a message. Commands: /brain  /memory  /output  /save  /setting  /clear  /help  /exit"));
+  console.log(statusLine(active.label, history) + "\n");
   while (true) {
     const raw = await ask(c.accent("\u203A "));
     if (raw === null) break;
@@ -1542,8 +1867,8 @@ async function chat() {
       }
       if (cmd === "setting" || cmd === "settings") {
         cfg = await runSettings(ask);
-        const next = cfg.defaultBrain ? resolveActive(cfg, cfg.defaultBrain) : null;
-        const stillValid = resolveActive(cfg, active.id);
+        const next = cfg.defaultBrain ? resolveActive2(cfg, cfg.defaultBrain) : null;
+        const stillValid = resolveActive2(cfg, active.id);
         active = stillValid ?? next ?? active;
         console.log(c.dim(`  brain: ${active.label}`));
         continue;
@@ -1553,7 +1878,7 @@ async function chat() {
         const apiIds = cfg.apiBrains.map((a) => a.id);
         const all = [...cliEnabled, ...apiIds];
         if (arg && all.includes(arg)) {
-          const next = resolveActive(cfg, arg);
+          const next = resolveActive2(cfg, arg);
           if (next) {
             active = next;
             const turns = Math.floor(history.length / 2);
@@ -1597,9 +1922,9 @@ async function chat() {
     const base = renderPrompt(history, line, remembered);
     const prompt = promptOverride ?? (skillsBlock ? skillsBlock + "\n\n" + base : base);
     let streamed = false;
-    const onChunk = (chunk) => {
+    const onChunk = (chunk2) => {
       streamed = true;
-      process.stdout.write(chunk);
+      process.stdout.write(chunk2);
     };
     const res = active.kind === "cli" ? await runBrain(cfg.brains[active.id], prompt, onChunk) : await runApiBrain(active.brain, prompt, onChunk);
     if (res.ok) {
@@ -1610,8 +1935,9 @@ async function chat() {
       history.push({ role: "user", content: line });
       history.push({ role: "assistant", content: res.text });
       const now = Date.now();
-      appendTurn({ id: randomUUID2().slice(0, 8), ts: now, session, role: "user", content: line, emb: await embed(line) ?? void 0 });
-      appendTurn({ id: randomUUID2().slice(0, 8), ts: now, session, role: "assistant", content: res.text, emb: await embed(res.text) ?? void 0 });
+      appendTurn({ id: randomUUID3().slice(0, 8), ts: now, session, role: "user", content: line, emb: await embed(line) ?? void 0 });
+      appendTurn({ id: randomUUID3().slice(0, 8), ts: now, session, role: "assistant", content: res.text, emb: await embed(res.text) ?? void 0 });
+      console.log(statusLine(active.label, history) + "\n");
     } else {
       console.log(c.red("\n  " + res.text + "\n"));
     }
@@ -1645,7 +1971,7 @@ async function login(which) {
 }
 
 // src/commands/memory.ts
-import { existsSync as existsSync6, readFileSync as readFileSync6 } from "fs";
+import { existsSync as existsSync7, readFileSync as readFileSync7 } from "fs";
 async function memoryCmd(sub, rest = []) {
   const { ask, close } = createReader();
   if (!await ensureTrusted(ask)) {
@@ -1692,12 +2018,12 @@ async function memoryCmd(sub, rest = []) {
     return;
   }
   if (action === "facts") {
-    if (!existsSync6(factsMdPath())) {
+    if (!existsSync7(factsMdPath())) {
       console.log(c.dim("\n  No facts distilled yet. They form when you end a chat session.\n"));
       close();
       return;
     }
-    const body = readFileSync6(factsMdPath(), "utf8").trim();
+    const body = readFileSync7(factsMdPath(), "utf8").trim();
     console.log("\n" + body + "\n");
     close();
     return;
@@ -1743,17 +2069,17 @@ async function memoryCmd(sub, rest = []) {
 
 // src/commands/skill.ts
 import {
-  mkdirSync as mkdirSync5,
-  writeFileSync as writeFileSync6,
-  readFileSync as readFileSync7,
-  existsSync as existsSync7,
+  mkdirSync as mkdirSync6,
+  writeFileSync as writeFileSync7,
+  readFileSync as readFileSync8,
+  existsSync as existsSync8,
   readdirSync as readdirSync2,
   statSync as statSync3,
   rmSync as rmSync3,
   cpSync,
   mkdtempSync
 } from "fs";
-import { join as join7, resolve } from "path";
+import { join as join8, resolve } from "path";
 import { tmpdir } from "os";
 import { spawnSync as spawnSync2 } from "child_process";
 function usage() {
@@ -1799,12 +2125,12 @@ function isGitUrl(s) {
   return s.includes("://") || s.endsWith(".git") || s.startsWith("git@");
 }
 function findSkillDir(root) {
-  if (existsSync7(join7(root, "SKILL.md"))) return root;
+  if (existsSync8(join8(root, "SKILL.md"))) return root;
   let subs = [];
   try {
     subs = readdirSync2(root).filter((f) => {
       try {
-        return statSync3(join7(root, f)).isDirectory();
+        return statSync3(join8(root, f)).isDirectory();
       } catch {
         return false;
       }
@@ -1812,8 +2138,8 @@ function findSkillDir(root) {
   } catch {
     return null;
   }
-  const withSkill = subs.filter((f) => existsSync7(join7(root, f, "SKILL.md")));
-  if (withSkill.length === 1) return join7(root, withSkill[0]);
+  const withSkill = subs.filter((f) => existsSync8(join8(root, f, "SKILL.md")));
+  if (withSkill.length === 1) return join8(root, withSkill[0]);
   return null;
 }
 function cmdList() {
@@ -1852,7 +2178,7 @@ function cmdShow(name) {
   const { skill, body } = loaded;
   console.log("\n" + c.accent(skill.name) + c.dim(`  (${skill.scope})`));
   if (skill.description) console.log("  " + skill.description);
-  console.log(c.dim("  " + join7(skill.dir, "SKILL.md")));
+  console.log(c.dim("  " + join8(skill.dir, "SKILL.md")));
   console.log("");
   console.log(c.dim(body));
   console.log("");
@@ -1864,18 +2190,18 @@ function cmdCreate(name, global) {
     return;
   }
   const scope = global ? "global" : "workspace";
-  const dir = join7(skillsRoot(scope), clean);
-  if (existsSync7(dir)) {
+  const dir = join8(skillsRoot(scope), clean);
+  if (existsSync8(dir)) {
     console.log(c.red(`
   A ${scope} skill named "${clean}" already exists.`));
     console.log(c.dim("  " + dir + "\n"));
     return;
   }
-  mkdirSync5(dir, { recursive: true });
-  writeFileSync6(join7(dir, "SKILL.md"), SKILL_TEMPLATE(clean), "utf8");
+  mkdirSync6(dir, { recursive: true });
+  writeFileSync7(join8(dir, "SKILL.md"), SKILL_TEMPLATE(clean), "utf8");
   console.log(c.green(`
   Created ${scope} skill "${clean}".`));
-  console.log(c.dim("  " + join7(dir, "SKILL.md")));
+  console.log(c.dim("  " + join8(dir, "SKILL.md")));
   console.log(c.dim('  Edit it, then run it in chat with "/skill ' + clean + '".\n'));
 }
 function cmdAdd(source, global) {
@@ -1888,7 +2214,7 @@ function cmdAdd(source, global) {
   let tempDir = "";
   try {
     if (isGitUrl(source)) {
-      tempDir = mkdtempSync(join7(tmpdir(), "holt-skill-"));
+      tempDir = mkdtempSync(join8(tmpdir(), "holt-skill-"));
       console.log(c.dim(`
   Cloning ${source} ...`));
       const res = spawnSync2("git", ["clone", "--depth", "1", source, tempDir], { stdio: "ignore" });
@@ -1899,7 +2225,7 @@ function cmdAdd(source, global) {
       fetched = tempDir;
     } else {
       fetched = resolve(source);
-      if (!existsSync7(fetched)) {
+      if (!existsSync8(fetched)) {
         console.log(c.red(`
   No such path: ${fetched}
 `));
@@ -1913,7 +2239,7 @@ function cmdAdd(source, global) {
     }
     let skillName = "";
     try {
-      const { data } = parseFrontmatter(readFileSync7(join7(skillDir, "SKILL.md"), "utf8"));
+      const { data } = parseFrontmatter(readFileSync8(join8(skillDir, "SKILL.md"), "utf8"));
       skillName = sanitizeName(data.name || "");
     } catch {
       skillName = "";
@@ -1923,22 +2249,22 @@ function cmdAdd(source, global) {
       console.log(c.red("\n  Could not determine a valid skill name.\n"));
       return;
     }
-    const dest = join7(skillsRoot(scope), skillName);
-    if (existsSync7(dest)) {
+    const dest = join8(skillsRoot(scope), skillName);
+    if (existsSync8(dest)) {
       console.log(c.red(`
   A ${scope} skill named "${skillName}" already exists.`));
       console.log(c.dim("  " + dest + "\n"));
       return;
     }
-    mkdirSync5(skillsRoot(scope), { recursive: true });
+    mkdirSync6(skillsRoot(scope), { recursive: true });
     cpSync(skillDir, dest, { recursive: true });
-    const nestedGit = join7(dest, ".git");
-    if (existsSync7(nestedGit)) rmSync3(nestedGit, { recursive: true, force: true });
+    const nestedGit = join8(dest, ".git");
+    if (existsSync8(nestedGit)) rmSync3(nestedGit, { recursive: true, force: true });
     console.log(c.green(`
   Installed ${scope} skill "${skillName}".`));
-    console.log(c.dim("  " + join7(dest, "SKILL.md") + "\n"));
+    console.log(c.dim("  " + join8(dest, "SKILL.md") + "\n"));
   } finally {
-    if (tempDir && existsSync7(tempDir)) {
+    if (tempDir && existsSync8(tempDir)) {
       try {
         rmSync3(tempDir, { recursive: true, force: true });
       } catch {
@@ -1952,9 +2278,9 @@ async function cmdRemove(name, ask) {
     console.log(c.dim("\n  Usage: holt skill remove <name>\n"));
     return;
   }
-  const wsDir = join7(skillsRoot("workspace"), clean);
-  const globalDir = join7(skillsRoot("global"), clean);
-  const target = existsSync7(wsDir) ? wsDir : existsSync7(globalDir) ? globalDir : "";
+  const wsDir = join8(skillsRoot("workspace"), clean);
+  const globalDir = join8(skillsRoot("global"), clean);
+  const target = existsSync8(wsDir) ? wsDir : existsSync8(globalDir) ? globalDir : "";
   if (!target) {
     console.log(c.dim(`
   No skill named "${clean}" found.
@@ -2012,8 +2338,8 @@ async function skillCmd(sub, rest = []) {
 }
 
 // src/commands/graph.ts
-import { writeFileSync as writeFileSync7, mkdirSync as mkdirSync6 } from "fs";
-import { join as join8, dirname as dirname2, resolve as resolve2 } from "path";
+import { writeFileSync as writeFileSync8, mkdirSync as mkdirSync7 } from "fs";
+import { join as join9, dirname as dirname2, resolve as resolve2 } from "path";
 import { spawn as spawn3 } from "child_process";
 
 // src/graphview.ts
@@ -2677,9 +3003,9 @@ async function graph(args = []) {
     concepts: conceptCount,
     edges: g.edges.length
   });
-  const outPath = opts.out ? resolve2(opts.out) : join8(wsHoltDir(), "graph.html");
-  mkdirSync6(dirname2(outPath), { recursive: true });
-  writeFileSync7(outPath, html, "utf8");
+  const outPath = opts.out ? resolve2(opts.out) : join9(wsHoltDir(), "graph.html");
+  mkdirSync7(dirname2(outPath), { recursive: true });
+  writeFileSync8(outPath, html, "utf8");
   console.log("\n" + c.accent("Memory graph built") + c.dim("  (this folder)"));
   console.log(`  nodes    ${g.nodes.length}  (${turns.length} turns, ${conceptCount} concepts)`);
   console.log(`  edges    ${g.edges.length}`);
@@ -2787,7 +3113,7 @@ function recoverId(line) {
   return null;
 }
 function runMcpServer(opts) {
-  return new Promise((resolve3) => {
+  return new Promise((resolve4) => {
     const stdin = process.stdin;
     let buffer = "";
     let chain = Promise.resolve();
@@ -2824,8 +3150,8 @@ function runMcpServer(opts) {
       });
     };
     stdin.setEncoding("utf8");
-    stdin.on("data", (chunk) => {
-      buffer += chunk;
+    stdin.on("data", (chunk2) => {
+      buffer += chunk2;
       let nl = buffer.indexOf("\n");
       while (nl !== -1) {
         const line = buffer.slice(0, nl);
@@ -2839,11 +3165,11 @@ function runMcpServer(opts) {
         processLine(buffer);
         buffer = "";
       }
-      chain.then(() => resolve3()).catch(() => resolve3());
+      chain.then(() => resolve4()).catch(() => resolve4());
     });
     stdin.on("error", (e) => {
       console.error(`[mcp] stdin error: ${e.message}`);
-      chain.then(() => resolve3()).catch(() => resolve3());
+      chain.then(() => resolve4()).catch(() => resolve4());
     });
     stdin.resume();
   });
@@ -2999,8 +3325,450 @@ async function mcp(sub, rest = []) {
   }
 }
 
+// src/commands/run.ts
+import { writeFileSync as writeFileSync9 } from "fs";
+import { resolve as resolve3 } from "path";
+var USAGE = [
+  "  holt run <task> [options]",
+  "",
+  "  Run a single task against your default brain and stream the reply.",
+  "",
+  "  options:",
+  "    --brain <id>   use a specific brain (CLI or API brain id)",
+  "    --out <file>   also write the reply to a file (relative to this folder)",
+  "    --no-store     do not save this exchange to memory",
+  "    --no-recall    do not pull memory into the prompt",
+  "    --quiet        suppress streaming; still writes --out and sets exit code",
+  "",
+  '  example: holt run "summarize the open items in this folder"'
+].join("\n");
+function parseArgs2(args) {
+  const words2 = [];
+  let brainId;
+  let out;
+  let noStore = false;
+  let noRecall = false;
+  let quiet = false;
+  for (let i = 0; i < args.length; i++) {
+    const a = args[i];
+    if (a === "--brain") {
+      brainId = args[++i];
+      continue;
+    }
+    if (a === "--out") {
+      out = args[++i];
+      continue;
+    }
+    if (a === "--no-store") {
+      noStore = true;
+      continue;
+    }
+    if (a === "--no-recall") {
+      noRecall = true;
+      continue;
+    }
+    if (a === "--quiet") {
+      quiet = true;
+      continue;
+    }
+    words2.push(a);
+  }
+  return { task: words2.join(" ").trim(), brainId, out, noStore, noRecall, quiet };
+}
+async function run(args) {
+  const p = parseArgs2(args);
+  if (!p.task) {
+    console.log(USAGE);
+    return;
+  }
+  if (!isTrusted()) {
+    if (process.stdin.isTTY) {
+      const { ask, close } = createReader();
+      const ok2 = await ensureTrusted(ask);
+      close();
+      if (!ok2) return;
+    } else {
+      process.stderr.write("This folder is not trusted. Run holt init or holt chat here once, then schedule/run.\n");
+      process.exitCode = 1;
+      return;
+    }
+  }
+  let streamed = false;
+  const result = await runTask(p.task, {
+    brainId: p.brainId,
+    recall: !p.noRecall,
+    store: !p.noStore,
+    onChunk: p.quiet ? void 0 : (ch) => {
+      streamed = true;
+      process.stdout.write(ch);
+    }
+  });
+  if (!p.quiet && !streamed) {
+    process.stdout.write(result.text);
+  }
+  if (!p.quiet && (streamed || result.text) && !result.text.endsWith("\n")) {
+    process.stdout.write("\n");
+  }
+  if (!result.ok) {
+    process.stderr.write(c.red(result.text) + "\n");
+    process.exitCode = 1;
+    return;
+  }
+  if (p.out) {
+    const target = resolve3(process.cwd(), p.out);
+    writeFileSync9(target, result.text, "utf8");
+    process.stderr.write(c.dim(`saved to ${target}`) + "\n");
+  }
+}
+
+// src/commands/schedule.ts
+import { spawnSync as spawnSync4 } from "child_process";
+import { writeFileSync as writeFileSync11, mkdirSync as mkdirSync9, rmSync as rmSync4, existsSync as existsSync9 } from "fs";
+import { dirname as dirname3 } from "path";
+
+// src/scheduler.ts
+import { homedir as homedir3 } from "os";
+import { join as join10 } from "path";
+import { readFileSync as readFileSync9, writeFileSync as writeFileSync10, mkdirSync as mkdirSync8 } from "fs";
+import { randomUUID as randomUUID4 } from "crypto";
+import { spawnSync as spawnSync3 } from "child_process";
+function schedulesPath() {
+  return join10(GLOBAL_DIR, "schedules.json");
+}
+function logsDir() {
+  return join10(GLOBAL_DIR, "logs");
+}
+function logPath(id) {
+  return join10(logsDir(), `${id}.log`);
+}
+function plistPath(id) {
+  return join10(homedir3(), "Library", "LaunchAgents", `com.holt.${id}.plist`);
+}
+function loadJobs() {
+  try {
+    const raw = JSON.parse(readFileSync9(schedulesPath(), "utf8"));
+    return Array.isArray(raw) ? raw : [];
+  } catch {
+    return [];
+  }
+}
+function saveJobs(jobs) {
+  mkdirSync8(GLOBAL_DIR, { recursive: true });
+  writeFileSync10(schedulesPath(), JSON.stringify(jobs, null, 2) + "\n", "utf8");
+}
+function addJob(job) {
+  const jobs = loadJobs();
+  jobs.push(job);
+  saveJobs(jobs);
+  return jobs;
+}
+function removeJob(id) {
+  const jobs = loadJobs().filter((j) => j.id !== id);
+  saveJobs(jobs);
+  return jobs;
+}
+function newJobId() {
+  return randomUUID4().slice(0, 8);
+}
+function parseWhen(when) {
+  const m = /^([01]?\d|2[0-3]):([0-5]\d)$/.exec(when.trim());
+  if (!m) {
+    throw new Error(
+      `Could not read time "${when}". Use 24h HH:MM for a daily run, e.g. 07:00 or 23:30.`
+    );
+  }
+  const hour = Number(m[1]);
+  const minute = Number(m[2]);
+  return { hour, minute };
+}
+function shQuote(s) {
+  return `'` + s.replace(/'/g, `'\\''`) + `'`;
+}
+function resolveHoltPath() {
+  try {
+    const finder = process.platform === "win32" ? "where" : "which";
+    const res = spawnSync3(finder, ["holt"], { encoding: "utf8" });
+    if (res.status === 0 && typeof res.stdout === "string") {
+      const first = res.stdout.split("\n").map((l) => l.trim()).find((l) => l.length > 0);
+      if (first) return first;
+    }
+  } catch {
+  }
+  return "holt";
+}
+function buildCommand(job, holtPath) {
+  const holt = shQuote(holtPath);
+  const ws = shQuote(job.workspace);
+  const log = shQuote(logPath(job.id));
+  let cmd = `cd ${ws} && ${holt} run ${shQuote(job.task)}`;
+  if (job.brain) cmd += ` --brain ${shQuote(job.brain)}`;
+  cmd += ` --quiet --out ${log}`;
+  if (job.notify) cmd += ` && ${holt} notify "$(cat ${log})"`;
+  return cmd;
+}
+function xmlEscape(s) {
+  return s.replace(/&/g, "&amp;").replace(/</g, "&lt;").replace(/>/g, "&gt;").replace(/"/g, "&quot;").replace(/'/g, "&apos;");
+}
+function buildLaunchdPlist(job, holtPath) {
+  const { hour, minute } = parseWhen(job.when);
+  const command = buildCommand(job, holtPath);
+  const log = logPath(job.id);
+  const args = ["/bin/sh", "-lc", command];
+  const argXml = args.map((a) => `    <string>${xmlEscape(a)}</string>`).join("\n");
+  return `<?xml version="1.0" encoding="UTF-8"?>
+<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
+<plist version="1.0">
+<dict>
+  <key>Label</key>
+  <string>com.holt.${xmlEscape(job.id)}</string>
+  <key>ProgramArguments</key>
+  <array>
+${argXml}
+  </array>
+  <key>StartCalendarInterval</key>
+  <dict>
+    <key>Hour</key>
+    <integer>${hour}</integer>
+    <key>Minute</key>
+    <integer>${minute}</integer>
+  </dict>
+  <key>RunAtLoad</key>
+  <false/>
+  <key>StandardOutPath</key>
+  <string>${xmlEscape(log)}</string>
+  <key>StandardErrorPath</key>
+  <string>${xmlEscape(log)}</string>
+</dict>
+</plist>
+`;
+}
+var CRON_MARKER = "holt:";
+function buildCronLine(job, holtPath) {
+  const { hour, minute } = parseWhen(job.when);
+  const command = buildCommand(job, holtPath);
+  return `${minute} ${hour} * * * ${command} # ${CRON_MARKER}${job.id}`;
+}
+function stripCronLines(crontab, id) {
+  const marker = `# ${CRON_MARKER}${id}`;
+  const kept = crontab.split("\n").filter((line) => !line.includes(marker));
+  return kept.join("\n").replace(/\n+$/, "\n");
+}
+function appendCronLine(crontab, line) {
+  const base = crontab.replace(/\s*$/, "");
+  return (base ? base + "\n" : "") + line + "\n";
+}
+function ensureLogsDir() {
+  mkdirSync8(logsDir(), { recursive: true });
+}
+
+// src/commands/schedule.ts
+function parseAdd(rest) {
+  const positional = [];
+  const opts = { notify: false };
+  for (let i = 0; i < rest.length; i++) {
+    const a = rest[i];
+    if (a === "--notify") opts.notify = true;
+    else if (a === "--name") opts.name = rest[++i];
+    else if (a === "--brain") opts.brain = rest[++i];
+    else if (a && a.startsWith("--")) {
+      const eq = a.indexOf("=");
+      if (eq > 2) {
+        const k = a.slice(2, eq);
+        const v = a.slice(eq + 1);
+        if (k === "name") opts.name = v;
+        else if (k === "brain") opts.brain = v;
+      }
+    } else if (a !== void 0) positional.push(a);
+  }
+  return { task: positional[0], when: positional[1], opts };
+}
+function installDarwin(job, holtPath) {
+  const path = plistPath(job.id);
+  mkdirSync9(dirname3(path), { recursive: true });
+  writeFileSync11(path, buildLaunchdPlist(job, holtPath), "utf8");
+  const res = spawnSync4("launchctl", ["load", "-w", path], { encoding: "utf8" });
+  if (res.status === 0) {
+    console.log(c.green("  Loaded into launchd."));
+  } else {
+    console.log(c.dim("  Wrote the plist, but launchctl load did not confirm."));
+    console.log(c.dim(`  Load it yourself with:  launchctl load -w ${path}`));
+    if (res.stderr && res.stderr.trim()) console.log(c.dim(`  (${res.stderr.trim()})`));
+  }
+  console.log(c.dim(`  plist: ${path}`));
+}
+function currentCrontab() {
+  const res = spawnSync4("crontab", ["-l"], { encoding: "utf8" });
+  return res.status === 0 && typeof res.stdout === "string" ? res.stdout : "";
+}
+function writeCrontab(body) {
+  const res = spawnSync4("crontab", ["-"], { input: body, encoding: "utf8" });
+  return res.status === 0;
+}
+function installLinux(job, holtPath) {
+  const line = buildCronLine(job, holtPath);
+  const next = appendCronLine(currentCrontab(), line);
+  if (writeCrontab(next)) {
+    console.log(c.green("  Added to your crontab."));
+    console.log(c.dim(`  line: ${line}`));
+  } else {
+    console.log(c.dim("  Could not update the crontab automatically. Add this line yourself:"));
+    console.log("  " + line);
+  }
+}
+async function addCmd(rest) {
+  const { task, when, opts } = parseAdd(rest);
+  if (!task || !when) {
+    console.log(c.dim('\n  Usage: holt schedule add "<task>" <HH:MM> [--name <n>] [--notify] [--brain <id>]\n'));
+    return;
+  }
+  try {
+    parseWhen(when);
+  } catch (e) {
+    console.log("\n  " + c.red(e.message) + "\n");
+    return;
+  }
+  const ws = workspace();
+  const holtPath = resolveHoltPath();
+  const job = {
+    id: newJobId(),
+    name: opts.name || task.slice(0, 40),
+    task,
+    when,
+    workspace: ws,
+    notify: opts.notify,
+    ...opts.brain ? { brain: opts.brain } : {}
+  };
+  ensureLogsDir();
+  addJob(job);
+  console.log("\n" + c.accent("Scheduled."));
+  console.log(`  id         ${job.id}`);
+  console.log(`  when       daily at ${job.when}`);
+  console.log(`  workspace  ${job.workspace}`);
+  if (job.notify) console.log(`  notify     on (pushes output to Telegram)`);
+  console.log(`  log        ${logPath(job.id)}`);
+  if (process.platform === "darwin") installDarwin(job, holtPath);
+  else if (process.platform === "linux") installLinux(job, holtPath);
+  else {
+    console.log(c.dim("\n  Your OS has no built-in installer. Install this entry yourself:"));
+    console.log("  " + buildCronLine(job, holtPath));
+  }
+  console.log("");
+}
+function listCmd() {
+  const jobs = loadJobs();
+  if (jobs.length === 0) {
+    console.log(c.dim("\n  No scheduled tasks yet. Add one with:"));
+    console.log(c.dim('  holt schedule add "<task>" <HH:MM> [--notify]\n'));
+    return;
+  }
+  console.log("\n" + c.accent("Scheduled tasks"));
+  for (const j of jobs) {
+    console.log(`  ${c.bold(j.id)}  daily ${j.when}  ${c.dim(j.notify ? "(notify)" : "")}`);
+    console.log(`      ${j.name}`);
+    console.log(c.dim(`      ${j.workspace}`));
+  }
+  console.log("");
+}
+function removeDarwin(id) {
+  const path = plistPath(id);
+  if (existsSync9(path)) {
+    spawnSync4("launchctl", ["unload", path], { encoding: "utf8" });
+    try {
+      rmSync4(path);
+    } catch {
+    }
+  }
+}
+function removeLinux(id) {
+  const res = spawnSync4("crontab", ["-l"], { encoding: "utf8" });
+  const body = res.status === 0 && typeof res.stdout === "string" ? res.stdout : "";
+  const next = stripCronLines(body, id);
+  spawnSync4("crontab", ["-"], { input: next, encoding: "utf8" });
+}
+function removeCmd(rest) {
+  const id = rest[0];
+  if (!id) {
+    console.log(c.dim("\n  Usage: holt schedule remove <id>   (see ids with: holt schedule list)\n"));
+    return;
+  }
+  const before = loadJobs();
+  const existed = before.some((j) => j.id === id);
+  removeJob(id);
+  if (process.platform === "darwin") removeDarwin(id);
+  else if (process.platform === "linux") removeLinux(id);
+  if (existed) console.log("\n" + c.green(`  Removed schedule ${id}.`) + "\n");
+  else console.log(c.dim(`
+  No schedule with id ${id}. Nothing to remove.
+`));
+}
+function usage2() {
+  console.log("\n" + c.accent("holt schedule") + c.dim("  run a task automatically on a timer"));
+  console.log(c.dim('\n  holt schedule add "<task>" <HH:MM> [--name <n>] [--notify] [--brain <id>]'));
+  console.log(c.dim("  holt schedule list"));
+  console.log(c.dim("  holt schedule remove <id>\n"));
+}
+async function schedule(sub, rest = []) {
+  const action = (sub || "").toLowerCase();
+  if (action === "list") {
+    listCmd();
+    return;
+  }
+  if (action !== "add" && action !== "remove" && action !== "rm") {
+    usage2();
+    return;
+  }
+  const { ask, close } = createReader();
+  if (!await ensureTrusted(ask)) {
+    close();
+    return;
+  }
+  close();
+  if (action === "add") await addCmd(rest);
+  else removeCmd(rest);
+}
+
+// src/commands/notify.ts
+import { readFileSync as readFileSync10 } from "fs";
+async function notify(args) {
+  const nonFlag = args.filter((a) => a !== "-" && !a.startsWith("--"));
+  const wantsStdin = args.includes("-") || !process.stdin.isTTY;
+  let message = "";
+  if (nonFlag.length > 0 && !args.includes("-")) {
+    message = nonFlag.join(" ").trim();
+  } else if (wantsStdin) {
+    message = readStdin().trim();
+  } else if (nonFlag.length > 0) {
+    message = nonFlag.join(" ").trim();
+  }
+  if (!message) {
+    process.stderr.write('Nothing to send. Pass a message or pipe text into "holt notify".\n');
+    process.exitCode = 1;
+    return;
+  }
+  const cfg = loadTelegramConfig();
+  if (!cfg) {
+    process.stderr.write('Telegram is not set up. Run "holt telegram setup".\n');
+    process.exitCode = 1;
+    return;
+  }
+  const ok2 = await sendMessage(message, cfg.allowedChatId);
+  if (ok2) {
+    process.stderr.write("Sent to Telegram.\n");
+  } else {
+    process.stderr.write("Failed to send to Telegram. Check the network and your bot token.\n");
+    process.exitCode = 1;
+  }
+}
+function readStdin() {
+  try {
+    return readFileSync10(0, "utf8");
+  } catch {
+    return "";
+  }
+}
+
 // src/cli.ts
-var VERSION = "0.7.0";
+var VERSION = "0.8.2";
 var BANNER = `
   \u2588\u2588\u2557  \u2588\u2588\u2557 \u2588\u2588\u2588\u2588\u2588\u2588\u2557 \u2588\u2588\u2557  \u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2557
   \u2588\u2588\u2551  \u2588\u2588\u2551\u2588\u2588\u2554\u2550\u2550\u2550\u2588\u2588\u2557\u2588\u2588\u2551  \u255A\u2550\u2550\u2588\u2588\u2554\u2550\u2550\u255D
@@ -3016,6 +3784,10 @@ Usage: holt <command>
 Commands:
   init            Trust this folder, choose and install brains, sign in, set defaults
   chat            Start a session. It remembers past sessions in this folder
+  run <task>      Run one task non-interactively: recall, brain executes, remember
+  schedule        Fire "holt run" on a timer: holt schedule [add | list | remove]
+  telegram        Chat with Holt from your phone: holt telegram [setup]
+  notify [msg]    Push a message to your phone over Telegram (stdin-friendly)
   memory          Inspect memory: holt memory [search <query> | embed | clear]
   graph           See your memory as an interactive knowledge graph in the browser
   skill           Manage skills: holt skill [list | show | create | add | remove]
@@ -3072,6 +3844,18 @@ async function main() {
     case "mcp":
       await mcp(process.argv[3], process.argv.slice(4));
       break;
+    case "run":
+      await run(process.argv.slice(3));
+      break;
+    case "schedule":
+      await schedule(process.argv[3], process.argv.slice(4));
+      break;
+    case "telegram":
+      await telegram(process.argv[3], process.argv.slice(4));
+      break;
+    case "notify":
+      await notify(process.argv.slice(3));
+      break;
     default:
       console.log(`
   Unknown command: "${cmd}"`);