@onebrain-ai/cli 2.3.1 → 2.3.3

package/README.md

@@ -84,7 +84,7 @@ A great harness already knows how to talk to an LLM, edit files, and run shell c
 | | What OneBrain adds | Why it matters |
 |---|---|---|
 | 🧠 | **Memory** — Identity, preferences, decisions, project state — promoted across four tiers as it earns trust | The harness alone starts every session from zero. OneBrain doesn't. |
-| ⚡ | **Skills** — 29+ vault-aware verbs (`/braindump`, `/research`, `/distill`, `/learn`, `/wrapup`, …) | Pre-built workflows the harness would otherwise need you to script every time. |
+| ⚡ | **Skills** — 31+ vault-aware verbs (`/braindump`, `/research`, `/distill`, `/learn`, `/wrapup`, …) | Pre-built workflows the harness would otherwise need you to script every time. |
 | 🎯 | **Calibration** — Every correction, every preference, every learned habit tunes the agent to *you* | The longer you use it, the sharper it gets — your vault is the training data. |
 | 🔀 | **Continuity** — Context lives in the vault, not the harness | Switch from Claude Code to Gemini CLI to Codex. Same memory. Same skills. Same agent. |
 
@@ -196,6 +196,8 @@ OneBrain has automatic behaviors that run without you doing anything:
 
 **`/wrapup` is manual only.** Run it yourself when you want a visible, full session summary with output shown.
 
+**Pausing long work across sessions.** For multi-day tasks that don't fit one session, run `/pause` to save a snapshot, then `/resume` in a future session to pick up seamlessly. Pause snapshots accumulate per-thread in `07-logs/pause/`; the next `/wrapup` consolidates them into one session log. This fills the gap between auto-checkpoint (involuntary) and `/wrapup` (terminal).
+
 **The practical result:** Just say "bye" and everything is saved. If the session ends unexpectedly, you lose at most 15 messages — the last checkpoint recovers the rest.
 
 > Auto Checkpoint runs on Claude Code (`Stop` hook) and Gemini CLI (`AfterAgent` hook), and uses the `onebrain` CLI binary. Install with `npm install -g @onebrain-ai/cli`. Auto Session Summary works with any agent that follows INSTRUCTIONS.md.
@@ -210,7 +212,7 @@ OneBrain doesn't just store markdown. Every feature exists to make you and the a
 |---|---|---|
 | 🧠 | **Persistent Memory** | Remembers your name, goals, preferences, and decisions across every session |
 | 🖥️ | **Personal AI OS** | Full local stack: Claude Code + Obsidian + tmux + Telegram — no cloud infra needed |
-| ⚡ | **29+ Skills** | Braindump, research, consolidate, bookmark, import files, daily briefing, and more |
+| ⚡ | **31+ Skills** | Braindump, research, consolidate, bookmark, import files, daily briefing, and more |
 | 📂 | **Vault-native Markdown** | Plain Markdown, no lock-in. Your data stays yours forever |
 | 🔀 | **Multi-Harness OS** | Switch between Claude Code, Gemini CLI, Codex, Qwen, or BYO LLM — context never breaks. [See architecture ↑](#the-harness-os-architecture) |
 | 🔌 | **Zero Config** | Clone, open in Obsidian, run `/onboarding`. Ready in under 2 minutes |
@@ -340,7 +342,9 @@ Same vault. Same skills. Same memory. The LLM swaps; OneBrain doesn't notice.
 
 <a id="commands"></a>
 
-## 📋 29+ Commands
+<!-- NEW-BADGE-CLEANUP: remove the green NEW shields.io badges from /search, /pause, /resume, /schedule-* on or after 2026-05-19 -->
+
+## 📋 31+ Commands
 
 Skills are organized by workflow phase. **Gemini CLI users:** prepend the `onebrain:` namespace, e.g. `/onebrain:braindump` instead of `/braindump` (avoids collisions with Gemini built-in commands like `/help` and `/tasks`).
 
@@ -373,7 +377,7 @@ Skills are organized by workflow phase. **Gemini CLI users:** prepend the `onebr
 
 | Command | What it does |
 |---------|-------------|
-| `/search` | General vault retrieval — answers what + why questions across MEMORY, sessions, plans, decisions logs, notes |
+| `/search` ![NEW](https://img.shields.io/badge/NEW-success?style=flat-square) | General vault retrieval — answers what + why questions across MEMORY, sessions, plans, decisions logs, notes |
 | `/tasks` | Live task dashboard in Obsidian — creates/updates `TASKS.md` with always-current query sections |
 | `/moc` | Vault portal in Obsidian — creates/updates `MOC.md` with projects, areas, knowledge, tasks, and pinned links |
 | `/memory-review` | Interactive review of memory files — keep, update, deprecate, or delete entries |
@@ -389,10 +393,12 @@ Skills are organized by workflow phase. **Gemini CLI users:** prepend the `onebr
 | `/qmd` | Set up fast vault search index — enables semantic search across all notes |
 | `/help` | List all available commands with descriptions |
 | `/wrapup` | Wrap up session — merges any auto-checkpoints and saves full summary to session log |
-| `/schedule-add` | Interactive wizard for adding a recurring scheduled skill |
-| `/schedule-once` | One-shot wizard: schedule a skill to run once at a specific datetime |
-| `/schedule-list` | Show all scheduled entries |
-| `/schedule-remove` | Remove a scheduled entry |
+| `/pause` ![NEW](https://img.shields.io/badge/NEW-success?style=flat-square) | Save a snapshot of long-running work mid-flight so a future session can `/resume` (does NOT end the session or clear context) |
+| `/resume` ![NEW](https://img.shields.io/badge/NEW-success?style=flat-square) | Load the latest snapshot of an active pause thread and pick up seamlessly in a fresh session |
+| `/schedule-add` ![NEW](https://img.shields.io/badge/NEW-success?style=flat-square) | Interactive wizard for adding a recurring scheduled skill |
+| `/schedule-once` ![NEW](https://img.shields.io/badge/NEW-success?style=flat-square) | One-shot wizard: schedule a skill to run once at a specific datetime |
+| `/schedule-list` ![NEW](https://img.shields.io/badge/NEW-success?style=flat-square) | Show all scheduled entries |
+| `/schedule-remove` ![NEW](https://img.shields.io/badge/NEW-success?style=flat-square) | Remove a scheduled entry |
 
 <details>
 <summary><strong>📁 Vault Structure</strong></summary>
@@ -544,6 +550,16 @@ schedule:
 
 This matches the same shape Claude Code uses for `hooks` in `settings.json` — direct binary invocation with positional argv. No wrapper skill needed.
 
+### Quick start — preset bundles
+
+Don't want to hand-craft cron entries? OneBrain ships three preset tiers. New vaults are prompted during `/onboarding`; existing vaults can trigger the selector by running `/schedule-add` when the `schedule:` block is empty.
+
+- **Minimal** — `/daily` briefing only
+- **Essentials (default)** — `/daily` + `/weekly` Friday + `/recap` Sunday
+- **Maintenance Plus** — Essentials + `/doctor` monthly + `/tasks` daily + `onebrain qmd-reindex` Sunday (mixes skill + command modes)
+
+Canonical tier definitions live at `.claude/plugins/onebrain/skills/_shared/schedule-presets.md`.
+
 CLI flags:
 
 | Flag | Purpose |

package/dist/onebrain

@@ -9366,9 +9366,33 @@ async function checkClaudeSettings(vaultRoot) {
   }
   return { check: "claude-settings", status: "ok", message: "ok" };
 }
-function hookPresent(settings, event, cmdSubstring) {
+function effectiveCommand(h) {
+  const parts = [];
+  if (typeof h.command === "string" && h.command.length > 0)
+    parts.push(h.command);
+  if (Array.isArray(h.args)) {
+    for (const a of h.args)
+      if (typeof a === "string" && a.length > 0)
+        parts.push(a);
+  }
+  return parts.join(" ");
+}
+function detectHookForm(settings, event, cmdSubstring) {
+  let sawLegacy = false;
   const groups = settings.hooks?.[event] ?? [];
-  return groups.some((g) => g.hooks?.some((h) => (h.command ?? "").includes(cmdSubstring)));
+  for (const g of groups) {
+    for (const h of g.hooks ?? []) {
+      if (!effectiveCommand(h).includes(cmdSubstring))
+        continue;
+      const isCanonical = h.command === CANONICAL_HOOK_COMMAND && (h.args?.length ?? 0) > 0;
+      if (isCanonical)
+        return "exec";
+      sawLegacy = true;
+    }
+  }
+  if (sawLegacy)
+    return "legacy";
+  return "absent";
 }
 async function checkSettingsHooks(vaultRoot, config) {
   const settingsPath = join2(vaultRoot, ".claude", "settings.json");
@@ -9396,15 +9420,21 @@ async function checkSettingsHooks(vaultRoot, config) {
   const confirmedHooks = [];
   let permissionOk = false;
   for (const { event, cmdSubstring } of REQUIRED_HOOKS) {
-    if (!hookPresent(settings, event, cmdSubstring)) {
+    const form = detectHookForm(settings, event, cmdSubstring);
+    if (form === "absent") {
       warnings.push(`${event} hook missing`);
+    } else if (form === "legacy") {
+      warnings.push(`${event} hook in legacy shell form \u2014 --fix will migrate to exec form`);
     } else {
       confirmedHooks.push(`${event} \u2713`);
     }
   }
   if (config.qmd_collection) {
-    if (!hookPresent(settings, "PostToolUse", QMD_HOOK_SUBSTRING)) {
+    const form = detectHookForm(settings, "PostToolUse", QMD_HOOK_SUBSTRING);
+    if (form === "absent") {
       warnings.push("PostToolUse (qmd) hook missing");
+    } else if (form === "legacy") {
+      warnings.push("PostToolUse (qmd) hook in legacy shell form \u2014 --fix will migrate to exec form");
     } else {
       confirmedHooks.push("PostToolUse \u2713");
     }
@@ -9413,7 +9443,7 @@ async function checkSettingsHooks(vaultRoot, config) {
     const groups = settings.hooks?.[event] ?? [];
     for (const g of groups) {
       for (const h of g.hooks ?? []) {
-        const cmd = h.command ?? "";
+        const cmd = effectiveCommand(h);
         if (!ALLOWED_HOOK_EVENTS.has(event) && cmd.includes(ONEBRAIN_COMMAND_SUBSTRING)) {
           warnings.push(`stale ${event} hook found (onebrain CLI only registers Stop + PostToolUse)`);
         }
@@ -9452,7 +9482,7 @@ async function checkSettingsHooks(vaultRoot, config) {
     ...okDetails.length > 0 ? { details: okDetails } : {}
   };
 }
-var import_yaml2, STANDARD_FOLDER_KEYS, REQUIRED_PLUGIN_FILES, REQUIRED_PLUGIN_DIRS, STALE_BASH_FILES, REQUIRED_VAULT_YML_KEYS, SOFT_REQUIRED_VAULT_YML_KEYS, REQUIRED_FOLDER_KEYS, STALE_MARKETPLACE_REPO = "kengio/onebrain", CANONICAL_MARKETPLACE_REPO = "onebrain-ai/onebrain", REQUIRED_HOOKS, ALLOWED_HOOK_EVENTS, QMD_HOOK_SUBSTRING = "onebrain qmd-reindex", ONEBRAIN_COMMAND_SUBSTRING = "onebrain", REQUIRED_PERMISSION = "Bash(onebrain *)", STALE_HOOK_SUBSTRINGS;
+var import_yaml2, STANDARD_FOLDER_KEYS, REQUIRED_PLUGIN_FILES, REQUIRED_PLUGIN_DIRS, STALE_BASH_FILES, REQUIRED_VAULT_YML_KEYS, SOFT_REQUIRED_VAULT_YML_KEYS, REQUIRED_FOLDER_KEYS, STALE_MARKETPLACE_REPO = "kengio/onebrain", CANONICAL_MARKETPLACE_REPO = "onebrain-ai/onebrain", REQUIRED_HOOKS, ALLOWED_HOOK_EVENTS, QMD_HOOK_SUBSTRING = "onebrain qmd-reindex", ONEBRAIN_COMMAND_SUBSTRING = "onebrain", REQUIRED_PERMISSION = "Bash(onebrain *)", STALE_HOOK_SUBSTRINGS, CANONICAL_HOOK_COMMAND = "onebrain";
 var init_validator = __esm(() => {
   import_yaml2 = __toESM(require_dist(), 1);
   STANDARD_FOLDER_KEYS = [
@@ -9560,7 +9590,7 @@ var init_lib = __esm(() => {
 var require_package = __commonJS((exports, module) => {
   module.exports = {
     name: "@onebrain-ai/cli",
-    version: "2.3.1",
+    version: "2.3.3",
     description: "CLI for OneBrain \u2014 personal AI OS for Obsidian with persistent memory, 24+ skills, and Claude Code integration",
     keywords: [
       "onebrain",
@@ -11020,9 +11050,90 @@ var init_vault_sync = __esm(() => {
   import_yaml3 = __toESM(require_dist(), 1);
 });
 
+// src/commands/run-skill.ts
+var exports_run_skill = {};
+__export(exports_run_skill, {
+  runSkillCommand: () => runSkillCommand,
+  buildPrompt: () => buildPrompt
+});
+import { spawn } from "child_process";
+import { existsSync } from "fs";
+import { constants as osConstants } from "os";
+import { join as join11 } from "path";
+function resolveClaudeBin(override) {
+  if (override)
+    return override;
+  const fromEnv = process.env["CLAUDE_BIN"];
+  if (fromEnv) {
+    if (existsSync(fromEnv))
+      return fromEnv;
+    console.error(import_picocolors8.default.yellow(`CLAUDE_BIN points to a missing file: ${fromEnv} \u2014 ignoring and probing defaults`));
+  }
+  for (const candidate of CLAUDE_FALLBACK_PATHS) {
+    if (existsSync(candidate))
+      return candidate;
+  }
+  return "claude";
+}
+function buildPrompt(skill, args) {
+  const bare = skill.replace(/^\//, "");
+  if (!bare) {
+    throw new Error('skill name must not be empty (got "/" or "")');
+  }
+  const namespaced = bare.includes(":") ? bare : `onebrain:${bare}`;
+  const slash = `/${namespaced}`;
+  if (!args)
+    return slash;
+  const tokens = Object.entries(args).map(([k2, v2]) => `${k2}=${v2}`);
+  return tokens.length ? `${slash} ${tokens.join(" ")}` : slash;
+}
+async function runSkillCommand(opts) {
+  const vault = opts.vault;
+  if (!existsSync(join11(vault, "vault.yml"))) {
+    console.error(import_picocolors8.default.red(`Vault not found at ${vault} (no vault.yml present)`));
+    return 78;
+  }
+  const claudeBin = resolveClaudeBin(opts.claudeBin);
+  const prompt = buildPrompt(opts.skill, opts.args);
+  const spawnFn = opts.spawnFn ?? spawn;
+  const spawnOpts = {
+    cwd: vault,
+    stdio: "inherit"
+  };
+  const child = spawnFn(claudeBin, ["-p", prompt, "--add-dir", vault], spawnOpts);
+  return await new Promise((resolve) => {
+    child.on("exit", (code, signal) => {
+      if (signal) {
+        console.error(import_picocolors8.default.red(`claude terminated by signal: ${signal}`));
+        resolve(128 + signalNumber(signal));
+        return;
+      }
+      resolve(code ?? 1);
+    });
+    child.on("error", (err) => {
+      console.error(import_picocolors8.default.red(`Failed to spawn claude (${claudeBin}): ${err.message}`));
+      resolve(127);
+    });
+  });
+}
+function signalNumber(signal) {
+  const sigs = osConstants.signals;
+  return sigs[signal] ?? 0;
+}
+var import_picocolors8, HOME, CLAUDE_FALLBACK_PATHS;
+var init_run_skill = __esm(() => {
+  import_picocolors8 = __toESM(require_picocolors(), 1);
+  HOME = process.env["HOME"] ?? "";
+  CLAUDE_FALLBACK_PATHS = [
+    ...HOME ? [join11(HOME, ".local/bin/claude")] : [],
+    "/opt/homebrew/bin/claude",
+    "/usr/local/bin/claude"
+  ];
+});
+
 // src/index.ts
-import { existsSync as existsSync2 } from "fs";
-import { dirname as dirname4, join as join12 } from "path";
+import { existsSync as existsSync3 } from "fs";
+import { dirname as dirname4, join as join13 } from "path";
 
 // node_modules/commander/esm.mjs
 var import__ = __toESM(require_commander(), 1);
@@ -11048,7 +11159,7 @@ var import_picocolors5 = __toESM(require_picocolors(), 1);
 var import_picocolors = __toESM(require_picocolors(), 1);
 function resolveBinaryVersion() {
   if (true)
-    return "2.3.1";
+    return "2.3.3";
   try {
     const pkg = require_package();
     return pkg.version ?? "dev";
@@ -13122,12 +13233,13 @@ async function sessionInitCommand(vaultRoot) {
 init_vault_sync();
 
 // src/commands/register-schedule.ts
-var import_picocolors8 = __toESM(require_picocolors(), 1);
+var import_picocolors9 = __toESM(require_picocolors(), 1);
 var import_yaml7 = __toESM(require_dist(), 1);
-import { existsSync } from "fs";
+import { execFileSync } from "child_process";
+import { existsSync as existsSync2 } from "fs";
 import { readFile as readFile6, unlink as unlink4, writeFile as writeFile6 } from "fs/promises";
 import { homedir as homedir4 } from "os";
-import { join as join11 } from "path";
+import { isAbsolute, join as join12, resolve as pathResolve } from "path";
 
 // src/lib/scheduler/cron-parse.ts
 var CRON_FIELD_RE = /^(\*|\d+)$/;
@@ -13246,9 +13358,10 @@ function validateEntry(entry) {
 }
 
 // src/lib/scheduler/launchd.ts
+import { basename } from "path";
 var xmlEscape = (s) => s.replace(/&/g, "&amp;").replace(/</g, "&lt;").replace(/>/g, "&gt;").replace(/"/g, "&quot;");
 function labelForEntry(entry) {
-  const raw = isCommandMode(entry) ? entry.command : (entry.skill ?? "").replace(/^\//, "");
+  const raw = isCommandMode(entry) ? basename(entry.command) : (entry.skill ?? "").replace(/^\//, "");
   return raw.replace(/[^a-zA-Z0-9-]/g, "-");
 }
 function generatePlist(entry, ctx) {
@@ -13270,9 +13383,9 @@ function generatePlist(entry, ctx) {
         <string>-c</string>
         <string>${shellLine}</string>`;
     } else {
-      const plistFilePath = plistPath(entry.skill ?? "", ctx.homedir);
-      const argsFlags = entry.args ? ` ${Object.entries(entry.args).map(([k2, v2]) => `--${k2}="${v2}"`).join(" ")}` : "";
-      const shellLine = xmlEscape(`"${ctx.skillCliPath}" --vault="${ctx.vaultPath}" --skill="${entry.skill}" --headless${argsFlags}; launchctl bootout gui/${ctx.uid}/${label}; rm -f "${plistFilePath}"`);
+      const plistFilePath = `${ctx.homedir}/Library/LaunchAgents/${label}.plist`;
+      const argsFlags = entry.args ? ` ${Object.entries(entry.args).map(([k2, v2]) => `--arg="${k2}=${v2}"`).join(" ")}` : "";
+      const shellLine = xmlEscape(`"${ctx.skillCliPath}" run-skill --vault="${ctx.vaultPath}" --skill="${entry.skill}"${argsFlags}; launchctl bootout gui/${ctx.uid}/${label}; rm -f "${plistFilePath}"`);
       programArgumentsBlock = `        <string>/bin/sh</string>
         <string>-c</string>
         <string>${shellLine}</string>`;
@@ -13286,14 +13399,17 @@ function generatePlist(entry, ctx) {
 `);
   } else {
     const argsBlock = entry.args ? `
-${Object.entries(entry.args).map(([k2, v2]) => `        <string>--${xmlEscape(k2)}=${xmlEscape(v2)}</string>`).join(`
+${Object.entries(entry.args).flatMap(([k2, v2]) => [
+      "        <string>--arg</string>",
+      `        <string>${xmlEscape(`${k2}=${v2}`)}</string>`
+    ]).join(`
 `)}` : "";
     programArgumentsBlock = `        <string>${xmlEscape(ctx.skillCliPath)}</string>
+        <string>run-skill</string>
         <string>--vault</string>
         <string>${xmlEscape(ctx.vaultPath)}</string>
         <string>--skill</string>
-        <string>${xmlEscape(entry.skill ?? "")}</string>
-        <string>--headless</string>${argsBlock}`;
+        <string>${xmlEscape(entry.skill ?? "")}</string>${argsBlock}`;
   }
   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">
@@ -13334,12 +13450,12 @@ async function registerSchedule(opts) {
   if (opts.resume)
     return await resumeSkill(opts.vault, opts.resume);
   if (opts.refresh) {
-    console.log(import_picocolors8.default.dim("(--refresh: re-emitting plists with current vault path)"));
+    console.log(import_picocolors9.default.dim("(--refresh: re-emitting plists with current vault path)"));
   }
   const config = await readVaultConfig(opts.vault);
   const entries = config.schedule ?? [];
   if (entries.length === 0) {
-    console.log(import_picocolors8.default.yellow("No schedule entries in vault.yml. Nothing to register."));
+    console.log(import_picocolors9.default.yellow("No schedule entries in vault.yml. Nothing to register."));
     return;
   }
   for (const entry of entries) {
@@ -13360,16 +13476,17 @@ async function registerSchedule(opts) {
       await validateSchedulable(opts.vault, entry);
     }
   }
+  const resolvedEntries = entries.map((entry) => isCommandMode(entry) ? { ...entry, command: resolveCommandBinary(entry.command, opts.vault) } : entry);
   const skillCliPath = process.argv[1] ?? "onebrain";
   const ctx = {
     vaultPath: opts.vault,
     skillCliPath,
-    logBasePath: join11(opts.vault, "07-logs/scheduler"),
+    logBasePath: join12(opts.vault, "07-logs/scheduler"),
     uid: process.getuid?.() ?? 501,
     homedir: homedir4()
   };
   const seen = new Map;
-  for (const entry of entries) {
+  for (const entry of resolvedEntries) {
     const target = plistPath(labelForEntry(entry), ctx.homedir);
     if (seen.has(target)) {
       const existing = seen.get(target);
@@ -13381,28 +13498,28 @@ async function registerSchedule(opts) {
     }
     seen.set(target, entry);
   }
-  for (const entry of entries) {
+  for (const entry of resolvedEntries) {
     const plistContent = generatePlist(entry, ctx);
     const targetPath = plistPath(labelForEntry(entry), ctx.homedir);
     if (opts.dryRun) {
-      console.log(import_picocolors8.default.cyan(`---  ${targetPath}  ---`));
+      console.log(import_picocolors9.default.cyan(`---  ${targetPath}  ---`));
       console.log(plistContent);
       continue;
     }
     await writeFile6(targetPath, plistContent, "utf8");
-    console.log(import_picocolors8.default.green(`\u2713 Wrote ${targetPath}`));
+    console.log(import_picocolors9.default.green(`\u2713 Wrote ${targetPath}`));
   }
-  console.log(import_picocolors8.default.green(`
+  console.log(import_picocolors9.default.green(`
 Registered ${entries.length} schedule entries.`));
-  console.log(import_picocolors8.default.dim("Use launchctl to load (or restart launchd):"));
-  for (const entry of entries) {
+  console.log(import_picocolors9.default.dim("Use launchctl to load (or restart launchd):"));
+  for (const entry of resolvedEntries) {
     const target = plistPath(labelForEntry(entry), ctx.homedir);
-    console.log(import_picocolors8.default.dim(`  launchctl load ${target}`));
+    console.log(import_picocolors9.default.dim(`  launchctl load ${target}`));
   }
 }
 async function readVaultConfig(vault) {
-  const yamlPath = join11(vault, "vault.yml");
-  if (!existsSync(yamlPath))
+  const yamlPath = join12(vault, "vault.yml");
+  if (!existsSync2(yamlPath))
     return {};
   const raw = await readFile6(yamlPath, "utf8");
   return import_yaml7.parse(raw) ?? {};
@@ -13420,8 +13537,8 @@ async function validateSchedulable(vault, entry) {
     throw new Error("validateSchedulable invoked on non-skill entry \u2014 caller bug");
   }
   const skillName = entry.skill.replace(/^\//, "");
-  const skillPath = join11(vault, ".claude/plugins/onebrain/skills", skillName, "SKILL.md");
-  if (!existsSync(skillPath)) {
+  const skillPath = join12(vault, ".claude/plugins/onebrain/skills", skillName, "SKILL.md");
+  if (!existsSync2(skillPath)) {
     throw new Error(`Skill ${entry.skill} not found at ${skillPath}`);
   }
   const raw = await readFile6(skillPath, "utf8");
@@ -13456,55 +13573,85 @@ async function removeAll(vault) {
   const entries = config.schedule ?? [];
   for (const entry of entries) {
     const target = plistPath(labelForEntry(entry), homedir4());
-    if (existsSync(target)) {
+    if (existsSync2(target)) {
       await unlink4(target);
-      console.log(import_picocolors8.default.green(`\u2713 Removed ${target}`));
+      console.log(import_picocolors9.default.green(`\u2713 Removed ${target}`));
     }
   }
 }
 async function printStatus(vault) {
   const config = await readVaultConfig(vault);
   const entries = config.schedule ?? [];
-  console.log(import_picocolors8.default.cyan(`Registered schedules: ${entries.length}`));
+  console.log(import_picocolors9.default.cyan(`Registered schedules: ${entries.length}`));
   for (const entry of entries) {
     const target = plistPath(labelForEntry(entry), homedir4());
-    const installed = existsSync(target) ? "\u2713" : "\u2717";
+    const installed = existsSync2(target) ? "\u2713" : "\u2717";
     const when = entry.at ?? entry.cron ?? "?";
-    const tag = entry.at ? import_picocolors8.default.magenta("[once]") : import_picocolors8.default.dim("[cron]");
+    const tag = entry.at ? import_picocolors9.default.magenta("[once]") : import_picocolors9.default.dim("[cron]");
     let targetLabel;
     if (isCommandMode(entry)) {
       const argv = entry.args ?? [];
       const argStr = argv.length ? ` ${argv.join(" ")}` : "";
-      targetLabel = `${import_picocolors8.default.yellow("cmd:")} ${entry.command}${argStr}`;
+      targetLabel = `${import_picocolors9.default.yellow("cmd:")} ${entry.command}${argStr}`;
     } else {
       const argsMap = entry.args ?? {};
       const argStr = Object.keys(argsMap).length ? ` (${Object.entries(argsMap).map(([k2, v2]) => `${k2}=${v2}`).join(", ")})` : "";
-      targetLabel = `${import_picocolors8.default.green("skill:")} ${entry.skill}${argStr}`;
+      targetLabel = `${import_picocolors9.default.green("skill:")} ${entry.skill}${argStr}`;
     }
     console.log(`  ${installed} ${tag} ${when}  ${targetLabel}`);
   }
 }
 async function testRun(vault, skill) {
-  console.log(import_picocolors8.default.cyan(`Testing scheduled invocation of ${skill}...`));
-  console.log(import_picocolors8.default.dim("(Spawns headless Claude Code. Output streams here.)"));
-  const { spawn } = await import("child_process");
-  const child = spawn("claude", ["--vault", vault, "--skill", skill, "--headless"], {
-    stdio: "inherit"
-  });
-  await new Promise((resolve) => child.on("exit", resolve));
+  console.log(import_picocolors9.default.cyan(`Testing scheduled invocation of ${skill}...`));
+  console.log(import_picocolors9.default.dim("(Spawns `onebrain run-skill` which shells out to Claude Code.)"));
+  const { runSkillCommand: runSkillCommand2 } = await Promise.resolve().then(() => (init_run_skill(), exports_run_skill));
+  const code = await runSkillCommand2({ vault, skill });
+  if (code !== 0) {
+    console.error(import_picocolors9.default.red(`Test run exited with code ${code}`));
+    process.exit(code);
+  }
+}
+var WHICH_BIN = "/usr/bin/which";
+function resolveCommandBinary(name, vaultRoot) {
+  if (isAbsolute(name)) {
+    if (!existsSync2(name)) {
+      throw new Error(`Command not found at absolute path: ${name}. Check the path in vault.yml \u2014 launchd will silently fail at run time if the binary is missing.`);
+    }
+    return name;
+  }
+  if (name.startsWith("./") || name.startsWith("../")) {
+    const base = vaultRoot ?? process.cwd();
+    const resolved = pathResolve(base, name);
+    if (!existsSync2(resolved)) {
+      throw new Error(`Command not found at relative path: ${name} (resolved: ${resolved})`);
+    }
+    return resolved;
+  }
+  try {
+    const out2 = execFileSync(WHICH_BIN, [name], {
+      encoding: "utf8",
+      stdio: ["ignore", "pipe", "ignore"]
+    }).trim();
+    if (out2 && existsSync2(out2))
+      return out2;
+  } catch {}
+  throw new Error(`Command "${name}" not found in PATH. Use an absolute path in vault.yml (launchd's PATH is restricted to /usr/bin:/bin:/usr/sbin:/sbin and won't find ${name}).`);
 }
 async function resumeSkill(vault, skill) {
-  const marker = join11(vault, "07-logs/scheduler/.paused", `${skill.replace(/^\//, "")}.txt`);
-  if (existsSync(marker)) {
+  const marker = join12(vault, "07-logs/scheduler/.paused", `${skill.replace(/^\//, "")}.txt`);
+  if (existsSync2(marker)) {
     await unlink4(marker);
-    console.log(import_picocolors8.default.green(`\u2713 Resumed ${skill}`));
+    console.log(import_picocolors9.default.green(`\u2713 Resumed ${skill}`));
   } else {
-    console.log(import_picocolors8.default.yellow(`${skill} is not paused.`));
+    console.log(import_picocolors9.default.yellow(`${skill} is not paused.`));
   }
 }
 
+// src/index.ts
+init_run_skill();
+
 // src/commands/update.ts
-var import_picocolors9 = __toESM(require_picocolors(), 1);
+var import_picocolors10 = __toESM(require_picocolors(), 1);
 init_cli_ui();
 var GITHUB_REPO = "https://api.github.com/repos/onebrain-ai/onebrain";
 var GITHUB_RELEASES_URL = `${GITHUB_REPO}/releases/latest`;
@@ -13599,7 +13746,7 @@ async function runUpdate(opts = {}) {
   const sp1 = createStep("\uD83D\uDD0D", "Local version");
   const { version: currentVersion, publishedAt: localPublishedAt } = await currentVersionFn();
   result.currentVersion = currentVersion;
-  const localVersionLabel = localPublishedAt ? `${import_picocolors9.default.dim(currentVersion)}  ${import_picocolors9.default.dim("\xB7")}  ${import_picocolors9.default.dim(formatReleaseDate(localPublishedAt))}` : import_picocolors9.default.dim(currentVersion);
+  const localVersionLabel = localPublishedAt ? `${import_picocolors10.default.dim(currentVersion)}  ${import_picocolors10.default.dim("\xB7")}  ${import_picocolors10.default.dim(formatReleaseDate(localPublishedAt))}` : import_picocolors10.default.dim(currentVersion);
   if (sp1)
     sp1.stop(localVersionLabel);
   else
@@ -13611,9 +13758,9 @@ async function runUpdate(opts = {}) {
     const release = await fetchLatestRelease(fetchFn);
     latestVersion = release.version;
     publishedAt = release.publishedAt;
-    const dateSuffix = publishedAt ? `  ${import_picocolors9.default.dim("\xB7")}  ${import_picocolors9.default.dim(formatReleaseDate(publishedAt))}` : "";
+    const dateSuffix = publishedAt ? `  ${import_picocolors10.default.dim("\xB7")}  ${import_picocolors10.default.dim(formatReleaseDate(publishedAt))}` : "";
     if (sp2)
-      sp2.stop(`${import_picocolors9.default.green(latestVersion)}${dateSuffix}`);
+      sp2.stop(`${import_picocolors10.default.green(latestVersion)}${dateSuffix}`);
     else
       writeLine(`latest: ${latestVersion}`);
   } catch (err) {
@@ -13634,7 +13781,7 @@ async function runUpdate(opts = {}) {
   if (check) {
     if (isTTY) {
       if (currentVersion !== latestVersion) {
-        barLine(`\u2B06\uFE0F   ${import_picocolors9.default.dim(currentVersion)}  \u2192  ${import_picocolors9.default.green(latestVersion)}  \xB7 binary would upgrade`);
+        barLine(`\u2B06\uFE0F   ${import_picocolors10.default.dim(currentVersion)}  \u2192  ${import_picocolors10.default.green(latestVersion)}  \xB7 binary would upgrade`);
         barBlank();
       }
       close("Dry run complete \u2014 no changes made");
@@ -13647,7 +13794,7 @@ async function runUpdate(opts = {}) {
   }
   if (latestVersion === currentVersion) {
     if (isTTY) {
-      close(`Already up to date \u2014 @onebrain-ai/cli ${import_picocolors9.default.dim(latestVersion)}`);
+      close(`Already up to date \u2014 @onebrain-ai/cli ${import_picocolors10.default.dim(latestVersion)}`);
     } else {
       writeLine(`already up to date: @onebrain-ai/cli ${latestVersion}`);
       writeLine("done: nothing to do");
@@ -13657,14 +13804,14 @@ async function runUpdate(opts = {}) {
     return result;
   }
   if (isTTY) {
-    barLine(`\u2B06\uFE0F   ${import_picocolors9.default.dim(currentVersion)}  \u2192  ${import_picocolors9.default.green(latestVersion)}`);
+    barLine(`\u2B06\uFE0F   ${import_picocolors10.default.dim(currentVersion)}  \u2192  ${import_picocolors10.default.green(latestVersion)}`);
     barBlank();
   }
   const sp3 = createStep("\uD83D\uDCE6", "Installing @onebrain-ai/cli");
   try {
     await installBinaryFn(latestVersion);
     if (sp3)
-      sp3.stop(import_picocolors9.default.green(latestVersion));
+      sp3.stop(import_picocolors10.default.green(latestVersion));
     else
       writeLine(`upgrading: @onebrain-ai/cli ${latestVersion} installed`);
   } catch (err) {
@@ -13701,7 +13848,7 @@ async function runUpdate(opts = {}) {
   result.ok = true;
   result.exitCode = 0;
   if (isTTY) {
-    close(`Done \u2014 run ${import_picocolors9.default.cyan("/update")} in Claude to sync vault files`);
+    close(`Done \u2014 run ${import_picocolors10.default.cyan("/update")} in Claude to sync vault files`);
   } else {
     writeLine("done: run /update in Claude to sync vault files");
   }
@@ -13728,8 +13875,8 @@ function patchUtf8(stream) {
 }
 
 // src/index.ts
-var VERSION = "2.3.1";
-var RELEASE_DATE = "2026-05-12";
+var VERSION = "2.3.3";
+var RELEASE_DATE = "2026-05-13";
 patchUtf8(process.stdout);
 patchUtf8(process.stderr);
 var VERSION_STRING = `OneBrain v${VERSION} \u2014 released ${RELEASE_DATE}`;
@@ -13743,7 +13890,7 @@ function findVaultRoot(startDir) {
     return process.cwd();
   let dir = startDir;
   while (true) {
-    if (existsSync2(join12(dir, "vault.yml")))
+    if (existsSync3(join13(dir, "vault.yml")))
       return dir;
     const parent = dirname4(dir);
     if (parent === dir)
@@ -13800,7 +13947,25 @@ program2.command("vault-sync", { hidden: true }).description("Sync plugin files
 program2.command("register-hooks", { hidden: true }).description("Install Claude Code hooks into settings.json").option("--vault-dir <path>", "vault root directory (default: cwd)").action(async (opts) => {
   await registerHooksCommand(opts.vaultDir);
 });
+program2.command("run-skill", { hidden: true }).description("Run a OneBrain skill headlessly via Claude Code (used by the scheduler)").requiredOption("--vault <path>", "Vault root directory").requiredOption("--skill <name>", "Skill name (e.g. /daily)").option("--arg <key=value>", "Skill argument, repeatable (e.g. --arg topic=this-week)", collectKeyValue, {}).action(async (opts) => {
+  const exitCode = await runSkillCommand({
+    vault: opts.vault,
+    skill: opts.skill,
+    ...Object.keys(opts.arg).length > 0 ? { args: opts.arg } : {}
+  });
+  process.exit(exitCode);
+});
 program2.command("migrate", { hidden: true }).description("Run one-time migration scripts").argument("<name>", "migration name: backfill-recapped").argument("[cutoff_date]", "ISO date cutoff (YYYY-MM-DD) \u2014 skip logs newer than this date").action(async (name, cutoffDate) => {
   await migrateCommand(name, cutoffDate);
 });
+function collectKeyValue(value, prev) {
+  const eq = value.indexOf("=");
+  if (eq === -1) {
+    throw new Error(`Invalid --arg format: "${value}" (expected key=value)`);
+  }
+  if (eq === 0) {
+    throw new Error(`Invalid --arg: key is empty in "${value}"`);
+  }
+  return { ...prev, [value.slice(0, eq)]: value.slice(eq + 1) };
+}
 program2.parse(process.argv);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@onebrain-ai/cli",
-  "version": "2.3.1",
+  "version": "2.3.3",
   "description": "CLI for OneBrain — personal AI OS for Obsidian with persistent memory, 24+ skills, and Claude Code integration",
   "keywords": [
     "onebrain",