@holt-os/holt 0.5.0 → 0.5.2

package/README.md

@@ -37,7 +37,7 @@ During `holt init` you:
 1. **Trust the folder.**
 2. **Choose brains** (claude, codex, gemini). Holt installs any you pick that are missing.
 3. **Sign in.** For a newly installed brain, Holt starts that tool's own login (browser or its own prompt). Holt never stores your credentials.
-4. **Pick a default** brain and, optionally, a **launch command** (a short word like `ai` that runs `holt chat`).
+4. **Pick a default** brain and, optionally, a **launch command**: a short word like `ai` that starts `holt chat`. Holt installs it as a tiny launcher next to its own binary, so it works immediately in the same terminal, no sourcing or restart needed.
 5. **Enable semantic memory.** If you say yes, Holt sets up a local [Ollama](https://ollama.com) with a small embed model so recall works by meaning, fully offline.
 
 ## Using it

package/dist/cli.js

@@ -248,17 +248,58 @@ function runBrain(brain, prompt, onChunk) {
 
 // src/alias.ts
 import { homedir as homedir2 } from "os";
-import { join as join3 } from "path";
-import { readFileSync as readFileSync3, writeFileSync as writeFileSync3, existsSync as existsSync3 } from "fs";
+import { join as join3, dirname, delimiter } from "path";
+import {
+  readFileSync as readFileSync3,
+  writeFileSync as writeFileSync3,
+  existsSync as existsSync3,
+  mkdirSync as mkdirSync3,
+  rmSync,
+  chmodSync,
+  realpathSync
+} from "fs";
 var START = "# >>> holt launch alias >>>";
 var END = "# <<< holt launch alias <<<";
+var SHIM_MARKER = "# holt launcher";
+var GLOBAL_DIR2 = join3(homedir2(), ".holt");
+var LAUNCHER_STATE = join3(GLOBAL_DIR2, "launcher.json");
 function rcFile() {
   const shell = process.env.SHELL || "";
   if (shell.includes("zsh")) return join3(homedir2(), ".zshrc");
   if (shell.includes("bash")) return join3(homedir2(), ".bashrc");
   return join3(homedir2(), ".profile");
 }
-function installAlias(name) {
+function readState() {
+  try {
+    return JSON.parse(readFileSync3(LAUNCHER_STATE, "utf8"));
+  } catch {
+    return null;
+  }
+}
+function writeState(state) {
+  mkdirSync3(GLOBAL_DIR2, { recursive: true });
+  if (state) writeFileSync3(LAUNCHER_STATE, JSON.stringify(state, null, 2) + "\n", "utf8");
+  else if (existsSync3(LAUNCHER_STATE)) rmSync(LAUNCHER_STATE);
+}
+function pathDirs() {
+  return (process.env.PATH || "").split(delimiter).filter(Boolean);
+}
+function launcherBinDir() {
+  const dirs = pathDirs();
+  const candidates = [];
+  const invoked = process.argv[1];
+  if (invoked) candidates.push(dirname(invoked));
+  candidates.push(dirname(process.execPath));
+  for (const dir of candidates) {
+    if (!dirs.includes(dir)) continue;
+    try {
+      if (dirs.includes(dir) || dirs.includes(realpathSync(dir))) return dir;
+    } catch {
+    }
+  }
+  return null;
+}
+function installRcAlias(name) {
   const file = rcFile();
   const block = `${START}
 alias ${name}="holt chat"
@@ -269,30 +310,80 @@ ${END}`;
     if (re.test(content)) content = content.replace(re, block);
     else content = content.replace(/\n*$/, "\n") + block + "\n";
     writeFileSync3(file, content, "utf8");
-    return { ok: true, file };
+    writeState({ name, kind: "rc", file });
+    return { ok: true, kind: "rc", file, immediate: false };
   } catch (e) {
-    return { ok: false, file, message: `Could not write ${file}: ${e.message}` };
+    return { ok: false, kind: "none", file, immediate: false, message: `Could not write ${file}: ${e.message}` };
   }
 }
-function currentAlias() {
-  const file = rcFile();
-  try {
-    const m = readFileSync3(file, "utf8").match(/alias\s+([^\s=]+)="holt chat"/);
-    return m ? m[1] : null;
-  } catch {
-    return null;
+function installAlias(name) {
+  removeAlias();
+  if (process.platform !== "win32") {
+    const binDir = launcherBinDir();
+    if (binDir) {
+      const file = join3(binDir, name);
+      if (existsSync3(file)) {
+        try {
+          if (!readFileSync3(file, "utf8").includes(SHIM_MARKER)) {
+            return { ok: false, kind: "none", file, immediate: false, message: `"${name}" already exists at ${file}. Pick another word.` };
+          }
+        } catch {
+          return { ok: false, kind: "none", file, immediate: false, message: `"${name}" already exists at ${file}. Pick another word.` };
+        }
+      }
+      try {
+        writeFileSync3(file, `#!/bin/sh
+${SHIM_MARKER}
+exec holt chat "$@"
+`, "utf8");
+        chmodSync(file, 493);
+        writeState({ name, kind: "bin", file });
+        return { ok: true, kind: "bin", file, immediate: true };
+      } catch {
+      }
+    }
   }
+  return installRcAlias(name);
 }
 function removeAlias() {
+  const state = readState();
+  if (state?.kind === "bin" && existsSync3(state.file)) {
+    try {
+      if (readFileSync3(state.file, "utf8").includes(SHIM_MARKER)) rmSync(state.file);
+    } catch {
+    }
+  }
   const file = rcFile();
   try {
     if (existsSync3(file)) {
       const content = readFileSync3(file, "utf8").replace(new RegExp(`\\n*${START}[\\s\\S]*?${END}\\n*`), "\n");
       writeFileSync3(file, content, "utf8");
     }
-    return { ok: true, file };
+    writeState(null);
+    return { ok: true, kind: "none", file, immediate: true };
   } catch (e) {
-    return { ok: false, file, message: e.message };
+    writeState(null);
+    return { ok: false, kind: "none", file, immediate: true, message: e.message };
+  }
+}
+function currentAlias() {
+  const state = readState();
+  if (state) {
+    if (state.kind === "bin") {
+      try {
+        if (existsSync3(state.file) && readFileSync3(state.file, "utf8").includes(SHIM_MARKER)) return state.name;
+      } catch {
+        return null;
+      }
+      return null;
+    }
+    return state.name;
+  }
+  try {
+    const m = readFileSync3(rcFile(), "utf8").match(/alias\s+([^\s=]+)="holt chat"/);
+    return m ? m[1] : null;
+  } catch {
+    return null;
   }
 }
 
@@ -313,7 +404,7 @@ function runInteractive(cmd, args) {
 }
 
 // src/memory.ts
-import { appendFileSync, readFileSync as readFileSync4, writeFileSync as writeFileSync4, existsSync as existsSync4, mkdirSync as mkdirSync3, rmSync, statSync } from "fs";
+import { appendFileSync, readFileSync as readFileSync4, writeFileSync as writeFileSync4, existsSync as existsSync4, mkdirSync as mkdirSync4, rmSync as rmSync2, statSync } from "fs";
 import { join as join4 } from "path";
 import { randomUUID } from "crypto";
 var OLLAMA_URL = process.env.HOLT_OLLAMA_URL || "http://127.0.0.1:11434";
@@ -373,11 +464,11 @@ function loadTurns() {
   return out;
 }
 function appendTurn(t) {
-  mkdirSync3(memDir(), { recursive: true });
+  mkdirSync4(memDir(), { recursive: true });
   appendFileSync(memPath(), JSON.stringify(t) + "\n", "utf8");
 }
 function clearMemory() {
-  if (existsSync4(memPath())) rmSync(memPath());
+  if (existsSync4(memPath())) rmSync2(memPath());
 }
 function memStats() {
   const turns = loadTurns();
@@ -442,7 +533,7 @@ async function backfillEmbeddings(onProgress) {
     done++;
     if (onProgress) onProgress(done, missing.length);
   }
-  mkdirSync3(memDir(), { recursive: true });
+  mkdirSync4(memDir(), { recursive: true });
   writeFileSync4(memPath(), turns.map((t) => JSON.stringify(t)).join("\n") + "\n", "utf8");
   return { embedded, total: missing.length };
 }
@@ -471,12 +562,21 @@ function printStatus(cfg) {
   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) {
-  const provRaw = (await ask(`  provider [${PROVIDERS.join("/")}]: `) ?? "").trim().toLowerCase();
-  if (!PROVIDERS.includes(provRaw)) {
-    console.log(c.dim("  cancelled (unknown provider)."));
+  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 provider = provRaw;
   const suggestion = PROVIDER_MODEL_SUGGESTION[provider];
   const modelRaw = (await ask(`  model (enter for ${suggestion}): `) ?? "").trim();
   const model = modelRaw || suggestion;
@@ -563,9 +663,10 @@ async function runSettings(ask) {
     } else if (choice === "a") {
       const name = (await ask("  launch command (blank to reset to holt): ") ?? "").trim();
       if (name && name !== "holt") {
-        if (isInstalled(name)) console.log(c.dim(`  note: "${name}" already exists; the alias will shadow it in new shells.`));
         const r = installAlias(name);
-        console.log(r.ok ? c.green(`  alias "${name}" -> holt chat added to ${r.file} (run: source ${r.file})`) : c.red("  " + r.message));
+        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."));
@@ -637,10 +738,16 @@ 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") {
-    if (isInstalled(aliasAns)) console.log(c.dim(`  note: "${aliasAns}" already exists; the alias will shadow it in new shells.`));
     const r = installAlias(aliasAns);
-    aliasNote = r.ok ? c.green(`  alias "${aliasAns}" -> holt chat added to ${r.file} (run: source ${r.file})`) : c.red("  " + r.message);
+    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();
@@ -696,8 +803,20 @@ Default brain? [${chosen.join("/")}] (${defPick}): `) ?? "").trim();
   saveConfig(cfg);
   console.log("\n" + c.green("Saved to ./.holt/config.json"));
   if (aliasNote) console.log(aliasNote);
-  if (cfg.defaultBrain) console.log("Start chatting:  " + c.accent(aliasAns && aliasAns !== "holt" ? aliasAns : "holt chat") + "\n");
-  else console.log(c.dim('No brain is ready yet. Install one, then run "holt init" again.\n'));
+  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
@@ -1437,13 +1556,13 @@ async function memoryCmd(sub, rest = []) {
 
 // src/commands/skill.ts
 import {
-  mkdirSync as mkdirSync4,
+  mkdirSync as mkdirSync5,
   writeFileSync as writeFileSync6,
   readFileSync as readFileSync6,
   existsSync as existsSync6,
   readdirSync as readdirSync2,
   statSync as statSync3,
-  rmSync as rmSync2,
+  rmSync as rmSync3,
   cpSync,
   mkdtempSync
 } from "fs";
@@ -1565,7 +1684,7 @@ function cmdCreate(name, global) {
     console.log(c.dim("  " + dir + "\n"));
     return;
   }
-  mkdirSync4(dir, { recursive: true });
+  mkdirSync5(dir, { recursive: true });
   writeFileSync6(join7(dir, "SKILL.md"), SKILL_TEMPLATE(clean), "utf8");
   console.log(c.green(`
   Created ${scope} skill "${clean}".`));
@@ -1624,17 +1743,17 @@ function cmdAdd(source, global) {
       console.log(c.dim("  " + dest + "\n"));
       return;
     }
-    mkdirSync4(skillsRoot(scope), { recursive: true });
+    mkdirSync5(skillsRoot(scope), { recursive: true });
     cpSync(skillDir, dest, { recursive: true });
     const nestedGit = join7(dest, ".git");
-    if (existsSync6(nestedGit)) rmSync2(nestedGit, { recursive: true, force: true });
+    if (existsSync6(nestedGit)) rmSync3(nestedGit, { recursive: true, force: true });
     console.log(c.green(`
   Installed ${scope} skill "${skillName}".`));
     console.log(c.dim("  " + join7(dest, "SKILL.md") + "\n"));
   } finally {
     if (tempDir && existsSync6(tempDir)) {
       try {
-        rmSync2(tempDir, { recursive: true, force: true });
+        rmSync3(tempDir, { recursive: true, force: true });
       } catch {
       }
     }
@@ -1659,7 +1778,7 @@ async function cmdRemove(name, ask) {
   const a = (await ask(`
   Delete ${scope} skill "${clean}"? [y/N] `) ?? "").trim().toLowerCase();
   if (a === "y" || a === "yes") {
-    rmSync2(target, { recursive: true, force: true });
+    rmSync3(target, { recursive: true, force: true });
     console.log(c.green("  Removed.\n"));
   } else {
     console.log(c.dim("  Kept.\n"));
@@ -1706,8 +1825,8 @@ async function skillCmd(sub, rest = []) {
 }
 
 // src/commands/graph.ts
-import { writeFileSync as writeFileSync7, mkdirSync as mkdirSync5 } from "fs";
-import { join as join8, dirname, resolve as resolve2 } from "path";
+import { writeFileSync as writeFileSync7, mkdirSync as mkdirSync6 } from "fs";
+import { join as join8, dirname as dirname2, resolve as resolve2 } from "path";
 import { spawn as spawn3 } from "child_process";
 
 // src/graphview.ts
@@ -2372,7 +2491,7 @@ async function graph(args = []) {
     edges: g.edges.length
   });
   const outPath = opts.out ? resolve2(opts.out) : join8(wsHoltDir(), "graph.html");
-  mkdirSync5(dirname(outPath), { recursive: true });
+  mkdirSync6(dirname2(outPath), { recursive: true });
   writeFileSync7(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)`);
@@ -2387,7 +2506,7 @@ async function graph(args = []) {
 }
 
 // src/cli.ts
-var VERSION = "0.5.0";
+var VERSION = "0.5.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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@holt-os/holt",
-  "version": "0.5.0",
+  "version": "0.5.2",
   "description": "An open-source personal agent OS: any LLM, private memory you can see and walk.",
   "type": "module",
   "license": "MIT",