agenthud 0.12.1 → 0.12.3

package/README.md

@@ -24,6 +24,8 @@ npx agenthud
 
 Run this in a separate terminal while using Claude Code. Press `?` inside the TUI any time for in-app help.
 
+> **Platform support.** Primary development is on macOS and Linux; the full test suite runs on all three platforms in CI (including Windows). Windows runtime behavior is exercised by a manual smoke job but isn't daily-driven — issues there are valued bug reports.
+
 Pass `--cwd` to scope the view to the Claude project that contains your current directory — useful when you have many projects but only care about the one you're in right now. Exits 1 with a stderr message if no such project is registered.
 
 ```bash

package/dist/index.js

@@ -15,4 +15,4 @@ Error: Node.js ${MIN_NODE_VERSION}+ is required (current: ${process.version})
   process.exit(1);
 }
 if (!process.env.NODE_ENV) process.env.NODE_ENV = "production";
-import("./main-CRTF5EHN.js");
+import("./main-WHDPTTTD.js");

package/dist/{main-CRTF5EHN.js → main-WHDPTTTD.js}

@@ -1,7 +1,7 @@
 // src/main.ts
-import { existsSync as existsSync7, readdirSync as readdirSync3, realpathSync, rmSync } from "fs";
+import { existsSync as existsSync8, readdirSync as readdirSync3, realpathSync, rmSync } from "fs";
 import { homedir as homedir5 } from "os";
-import { join as join7 } from "path";
+import { join as join8 } from "path";
 import { createInterface as createInterface2 } from "readline";
 import { render } from "ink";
 import React from "react";
@@ -465,12 +465,21 @@ function formatEffectiveOptionsLine(command, fields) {
   if (fields.model) parts.push(`model=${fields.model}`);
   return `${command} \u2192 ${parts.join(" ")}`;
 }
+function expandCombinedShortFlags(args) {
+  return args.flatMap((arg) => {
+    if (/^-[a-zA-Z]{2,}$/.test(arg)) {
+      return arg.slice(1).split("").map((ch) => `-${ch}`);
+    }
+    return arg;
+  });
+}
 function todayLocalMidnight() {
   const now = /* @__PURE__ */ new Date();
   return new Date(now.getFullYear(), now.getMonth(), now.getDate());
 }
 function parseArgs(args, config) {
   if (args[0] === "watch") args = args.slice(1);
+  args = expandCombinedShortFlags(args);
   if (args.includes("--help") || args.includes("-h")) {
     return { mode: "watch", command: "help" };
   }
@@ -1667,23 +1676,26 @@ import { spawn as spawn2 } from "child_process";
 import {
   copyFileSync,
   createWriteStream,
-  existsSync as existsSync5,
+  existsSync as existsSync6,
   mkdirSync as mkdirSync2,
-  readFileSync as readFileSync6,
+  readFileSync as readFileSync7,
   unlinkSync
 } from "fs";
 import { homedir as homedir3 } from "os";
-import { dirname as dirname2, join as join5 } from "path";
+import { dirname as dirname2, join as join6 } from "path";
 import { createInterface } from "readline";
 import { fileURLToPath as fileURLToPath2 } from "url";
 
 // src/utils/openInDefaultApp.ts
 import { spawn } from "child_process";
-function buildOpenCommand(platform, path) {
+import { existsSync as existsSync4, readFileSync as readFileSync5 } from "fs";
+import { join as join4 } from "path";
+function buildOpenCommand(platform, path, opts = {}) {
   switch (platform) {
     case "darwin":
       return { command: "open", args: [path] };
     case "linux":
+      if (opts.wslView) return { command: "wslview", args: [path] };
       return { command: "xdg-open", args: [path] };
     case "win32":
       return { command: "cmd", args: ["/c", "start", "", path] };
@@ -1691,8 +1703,36 @@ function buildOpenCommand(platform, path) {
       return null;
   }
 }
-function openInDefaultApp(path) {
-  const cmd = buildOpenCommand(process.platform, path);
+function isWSL() {
+  if (process.env.WSL_DISTRO_NAME) return true;
+  try {
+    const ver = readFileSync5("/proc/version", "utf-8");
+    return /microsoft|wsl/i.test(ver);
+  } catch {
+    return false;
+  }
+}
+function commandExists(command) {
+  const PATH = process.env.PATH ?? "";
+  const sep = process.platform === "win32" ? ";" : ":";
+  const exts = process.platform === "win32" ? (process.env.PATHEXT?.split(";") ?? [".EXE", ".CMD", ".BAT"]).map(
+    (e) => e.toLowerCase()
+  ) : [""];
+  for (const dir of PATH.split(sep)) {
+    if (!dir) continue;
+    const full = join4(dir, command);
+    for (const ext of exts) {
+      try {
+        if (existsSync4(full + ext)) return true;
+      } catch {
+      }
+    }
+  }
+  return false;
+}
+async function openInDefaultApp(path) {
+  const wslView = isWSL() && commandExists("wslview");
+  const cmd = buildOpenCommand(process.platform, path, { wslView });
   if (!cmd) {
     process.stderr.write(
       `agenthud: --open: no known opener for platform "${process.platform}"
@@ -1700,26 +1740,64 @@ function openInDefaultApp(path) {
     );
     return;
   }
-  try {
-    const child = spawn(cmd.command, cmd.args, {
-      detached: true,
-      stdio: "ignore"
-    });
+  if (!commandExists(cmd.command)) {
+    process.stderr.write(
+      `agenthud: --open: '${cmd.command}' is not on PATH; cannot open ${path}
+`
+    );
+    if (isWSL()) {
+      process.stderr.write(
+        "agenthud: hint: on WSL install `wslu` (provides wslview) so files open with the Windows host's default app \u2014 e.g. `sudo apt install wslu`\n"
+      );
+    }
+    return;
+  }
+  await new Promise((resolve2) => {
+    let settled = false;
+    const finish = () => {
+      if (settled) return;
+      settled = true;
+      resolve2();
+    };
+    let child;
+    try {
+      child = spawn(cmd.command, cmd.args, {
+        detached: true,
+        stdio: "ignore"
+      });
+    } catch (err) {
+      const msg = err instanceof Error ? err.message : String(err);
+      process.stderr.write(`agenthud: --open failed: ${msg}
+`);
+      finish();
+      return;
+    }
     child.on("error", (err) => {
       process.stderr.write(`agenthud: --open failed: ${err.message}
 `);
+      finish();
     });
-    child.unref();
-  } catch (err) {
-    const msg = err instanceof Error ? err.message : String(err);
-    process.stderr.write(`agenthud: --open failed: ${msg}
-`);
-  }
+    child.on("exit", (code) => {
+      if (code !== null && code !== 0) {
+        process.stderr.write(
+          `agenthud: --open: '${cmd.command}' exited with code ${code}
+`
+        );
+      }
+      finish();
+    });
+    setTimeout(() => {
+      if (!settled) {
+        child.unref();
+        finish();
+      }
+    }, 200).unref();
+  });
 }
 
 // src/data/summariesIndex.ts
-import { existsSync as existsSync4, readdirSync as readdirSync2, readFileSync as readFileSync5, writeFileSync as writeFileSync2 } from "fs";
-import { join as join4 } from "path";
+import { existsSync as existsSync5, readdirSync as readdirSync2, readFileSync as readFileSync6, writeFileSync as writeFileSync2 } from "fs";
+import { join as join5 } from "path";
 var INDEX_HEADER_MARKER = "<!-- agenthud-summaries-index -->";
 var BACKLINK_START_MARKER = "<!-- agenthud-backlinks-start -->";
 var BACKLINK_END_MARKER = "<!-- agenthud-backlinks-end -->";
@@ -1761,7 +1839,7 @@ function parseSummaryFilename(name) {
   return null;
 }
 function listSummaries(dir) {
-  if (!existsSync4(dir)) return [];
+  if (!existsSync5(dir)) return [];
   let names;
   try {
     names = readdirSync2(dir);
@@ -1926,9 +2004,9 @@ function regenerateIndex(summariesDir2) {
   const entries = listSummaries(summariesDir2);
   const snippets = /* @__PURE__ */ new Map();
   for (const entry of entries) {
-    const path = join4(summariesDir2, entry.filename);
+    const path = join5(summariesDir2, entry.filename);
     try {
-      const content = readFileSync5(path, "utf-8");
+      const content = readFileSync6(path, "utf-8");
       const snippet = extractContextSnippet(content);
       if (snippet) snippets.set(entry.filename, snippet);
       const block = buildHeaderBlock(entry.filename, entries);
@@ -1939,7 +2017,7 @@ function regenerateIndex(summariesDir2) {
     } catch {
     }
   }
-  const indexPath = join4(summariesDir2, "index.md");
+  const indexPath = join5(summariesDir2, "index.md");
   try {
     writeFileSync2(
       indexPath,
@@ -1977,20 +2055,20 @@ function startStderrTicker(label, options2 = {}) {
 
 // src/data/summaryRunner.ts
 function agenthudHomeDir() {
-  const dir = join5(homedir3(), ".agenthud");
-  if (!existsSync5(dir)) mkdirSync2(dir, { recursive: true });
+  const dir = join6(homedir3(), ".agenthud");
+  if (!existsSync6(dir)) mkdirSync2(dir, { recursive: true });
   return dir;
 }
 function summariesDir() {
-  const dir = join5(agenthudHomeDir(), "summaries");
-  if (!existsSync5(dir)) mkdirSync2(dir, { recursive: true });
+  const dir = join6(agenthudHomeDir(), "summaries");
+  if (!existsSync6(dir)) mkdirSync2(dir, { recursive: true });
   return dir;
 }
 function promptFilename(kind) {
   return kind === "daily" ? "summary-prompt.md" : "summary-range-prompt.md";
 }
 function userPromptPath(kind) {
-  return join5(homedir3(), ".agenthud", promptFilename(kind));
+  return join6(homedir3(), ".agenthud", promptFilename(kind));
 }
 function formatPromptSource(kind, override) {
   if (kind === "daily" && override) {
@@ -2003,25 +2081,25 @@ function formatPromptSource(kind, override) {
 }
 function templatePath(kind) {
   const here = dirname2(fileURLToPath2(import.meta.url));
-  return join5(here, "templates", promptFilename(kind));
+  return join6(here, "templates", promptFilename(kind));
 }
 function dateKey(d) {
   return `${d.getFullYear()}-${String(d.getMonth() + 1).padStart(2, "0")}-${String(d.getDate()).padStart(2, "0")}`;
 }
 function dailyCachePath(date) {
-  return join5(summariesDir(), `${dateKey(date)}.md`);
+  return join6(summariesDir(), `${dateKey(date)}.md`);
 }
 function rangeCachePath(from, to) {
-  return join5(summariesDir(), `range-${dateKey(from)}_${dateKey(to)}.md`);
+  return join6(summariesDir(), `range-${dateKey(from)}_${dateKey(to)}.md`);
 }
 function isSameLocalDay2(a, b) {
   return a.getFullYear() === b.getFullYear() && a.getMonth() === b.getMonth() && a.getDate() === b.getDate();
 }
 function ensureUserPromptFile(kind) {
   const p = userPromptPath(kind);
-  if (existsSync5(p)) return;
+  if (existsSync6(p)) return;
   const dir = dirname2(p);
-  if (!existsSync5(dir)) mkdirSync2(dir, { recursive: true });
+  if (!existsSync6(dir)) mkdirSync2(dir, { recursive: true });
   try {
     copyFileSync(templatePath(kind), p);
   } catch {
@@ -2030,14 +2108,14 @@ function ensureUserPromptFile(kind) {
 function resolvePrompt(kind, override) {
   if (override) return override;
   const p = userPromptPath(kind);
-  if (existsSync5(p)) {
+  if (existsSync6(p)) {
     try {
-      return readFileSync6(p, "utf-8");
+      return readFileSync7(p, "utf-8");
     } catch {
     }
   }
   try {
-    return readFileSync6(templatePath(kind), "utf-8");
+    return readFileSync7(templatePath(kind), "utf-8");
   } catch {
     return "Summarize the input below.";
   }
@@ -2213,9 +2291,9 @@ async function generateDailySummary(opts) {
   const isToday = isSameLocalDay2(opts.date, opts.today);
   const cached = dailyCachePath(opts.date);
   const dateLabel = dateKey(opts.date);
-  if (!isToday && !opts.force && existsSync5(cached)) {
+  if (!isToday && !opts.force && existsSync6(cached)) {
     try {
-      const content = readFileSync6(cached, "utf-8");
+      const content = readFileSync7(cached, "utf-8");
       if (opts.announce) {
         process.stderr.write(`cached summary from ${cached}
 `);
@@ -2256,21 +2334,36 @@ async function generateDailySummary(opts) {
   });
   const reportBytes = Buffer.byteLength(reportMarkdown, "utf-8");
   const estimatedTokens = Math.ceil(reportBytes / 4);
+  const reportLines = reportMarkdown.split("\n");
+  const sessionCount = reportLines.filter((l) => l.startsWith("## ")).length;
+  const activityCount = reportLines.filter(
+    (l) => /^\[\d{2}:\d{2}\]/.test(l)
+  ).length;
+  const commitCount = reportLines.filter(
+    (l) => /^\[\d{2}:\d{2}\] ◆/.test(l)
+  ).length;
   if (opts.announce) {
-    const reportLines = reportMarkdown.split("\n");
-    const sessionCount = reportLines.filter((l) => l.startsWith("## ")).length;
-    const activityCount = reportLines.filter(
-      (l) => /^\[\d{2}:\d{2}\]/.test(l)
-    ).length;
-    const commitCount = reportLines.filter(
-      (l) => /^\[\d{2}:\d{2}\] ◆/.test(l)
-    ).length;
     const sizeKb = (reportBytes / 1024).toFixed(1);
     process.stderr.write(
       `input: ${sessionCount} sessions, ${activityCount} activities, ${commitCount} commits (${reportLines.length} lines, ${sizeKb}KB \u2248 ${estimatedTokens.toLocaleString()} tokens)
 `
     );
   }
+  if (sessionCount === 0 && activityCount === 0 && commitCount === 0) {
+    if (opts.announce) {
+      process.stderr.write(
+        `${dateLabel} has no activity \u2014 skipping (no file written)
+`
+      );
+    }
+    return {
+      code: 0,
+      markdown: "",
+      fromCache: false,
+      skipped: true,
+      usage: null
+    };
+  }
   if (opts.confirmBeforeSpawn) {
     const proceed = await opts.confirmBeforeSpawn();
     if (!proceed) {
@@ -2354,17 +2447,18 @@ async function runSummary(options2) {
     detailLimit: options2.detailLimit,
     withGit: options2.withGit
   });
-  if (res.code === 0 && !res.skipped) {
+  const indexRefreshNeeded = res.code === 0 && (!res.skipped || options2.openIndex === true);
+  if (indexRefreshNeeded) {
     try {
       regenerateIndex(summariesDir());
     } catch {
     }
   }
   if (options2.open && res.code === 0 && !res.skipped) {
-    openInDefaultApp(dailyCachePath(options2.date));
+    await openInDefaultApp(dailyCachePath(options2.date));
   }
-  if (options2.openIndex && res.code === 0 && !res.skipped) {
-    openInDefaultApp(join5(summariesDir(), "index.md"));
+  if (options2.openIndex && res.code === 0) {
+    await openInDefaultApp(join6(summariesDir(), "index.md"));
   }
   return res.code;
 }
@@ -2379,10 +2473,10 @@ async function runRangeSummary(options2) {
     options2.force,
     dates,
     options2.today,
-    existsSync5(rangeCache)
+    existsSync6(rangeCache)
   )) {
     try {
-      const content = readFileSync6(rangeCache, "utf-8");
+      const content = readFileSync7(rangeCache, "utf-8");
       process.stderr.write(
         `cached range summary from ${rangeCache}
 `
@@ -2395,9 +2489,9 @@ async function runRangeSummary(options2) {
         regenerateIndex(summariesDir());
       } catch {
       }
-      if (options2.open) openInDefaultApp(rangeCache);
+      if (options2.open) await openInDefaultApp(rangeCache);
       if (options2.openIndex) {
-        openInDefaultApp(join5(summariesDir(), "index.md"));
+        await openInDefaultApp(join6(summariesDir(), "index.md"));
       }
       return 0;
     } catch {
@@ -2407,7 +2501,7 @@ async function runRangeSummary(options2) {
   let missingCount = 0;
   for (const d of dates) {
     const isToday = isSameLocalDay2(d, options2.today);
-    if (!isToday && existsSync5(dailyCachePath(d))) cachedCount++;
+    if (!isToday && existsSync6(dailyCachePath(d))) cachedCount++;
     else missingCount++;
   }
   process.stderr.write(
@@ -2426,7 +2520,7 @@ async function runRangeSummary(options2) {
     process.stderr.write(`
 --- ${label} ---
 `);
-    const willPrompt = !options2.assumeYes && (isToday || !existsSync5(dailyCachePath(d)));
+    const willPrompt = !options2.assumeYes && (isToday || !existsSync6(dailyCachePath(d)));
     const confirmer = willPrompt ? async () => {
       const hint = isToday ? " (today \u2014 regenerated every time)" : "";
       return ask(`Generate this summary${hint}? [Y/n] `, true);
@@ -2445,7 +2539,7 @@ async function runRangeSummary(options2) {
       withGit: options2.withGit
     });
     if (res.skipped) {
-      process.stderr.write(`agenthud: ${label} \u2014 skipped by user.
+      process.stderr.write(`agenthud: ${label} \u2014 skipped.
 `);
       skippedCount++;
       continue;
@@ -2466,8 +2560,17 @@ async function runRangeSummary(options2) {
     dailyMarkdowns.push({ date: d, markdown: text });
   }
   if (dailyMarkdowns.length === 0) {
-    process.stderr.write("agenthud: no daily summaries to combine.\n");
-    return 1;
+    process.stderr.write(
+      "no daily activity in this range \u2014 nothing to combine\n"
+    );
+    if (options2.openIndex) {
+      try {
+        regenerateIndex(summariesDir());
+      } catch {
+      }
+      await openInDefaultApp(join6(summariesDir(), "index.md"));
+    }
+    return 0;
   }
   const metaInput = dailyMarkdowns.map(({ date, markdown }) => `# ${dateKey(date)}
 
@@ -2510,15 +2613,15 @@ combining ${dailyMarkdowns.length} daily summaries into range summary...
     regenerateIndex(summariesDir());
   } catch {
   }
-  if (options2.open) openInDefaultApp(rangeCache);
+  if (options2.open) await openInDefaultApp(rangeCache);
   if (options2.openIndex) {
-    openInDefaultApp(join5(summariesDir(), "index.md"));
+    await openInDefaultApp(join6(summariesDir(), "index.md"));
   }
   return 0;
 }
 
 // src/ui/App.tsx
-import { existsSync as existsSync6, watch } from "fs";
+import { existsSync as existsSync7, watch } from "fs";
 import { basename as basename3 } from "path";
 import { Box as Box5, Text as Text5, useApp, useInput, useStdout } from "ink";
 import { useCallback, useEffect as useEffect3, useMemo, useRef, useState as useState3 } from "react";
@@ -4063,7 +4166,7 @@ function App({
   useEffect3(() => {
     if (!isWatchMode) return;
     const projectsDir = getProjectsDir();
-    const usePolling = process.platform === "linux" || !existsSync6(projectsDir);
+    const usePolling = process.platform === "linux" || !existsSync7(projectsDir);
     if (usePolling) {
       const timer = setInterval(
         () => refreshRef.current(),
@@ -4605,10 +4708,10 @@ function installAltScreenCleanup() {
 }
 
 // src/utils/legacyConfig.ts
-import { join as join6, resolve } from "path";
+import { join as join7, resolve } from "path";
 function isLegacyProjectConfig(cwd, home) {
-  const legacy = resolve(join6(cwd, ".agenthud", "config.yaml"));
-  const global = resolve(join6(home, ".agenthud", "config.yaml"));
+  const legacy = resolve(join7(cwd, ".agenthud", "config.yaml"));
+  const global = resolve(join7(home, ".agenthud", "config.yaml"));
   return legacy !== global;
 }
 
@@ -4628,8 +4731,8 @@ if (options.command === "version") {
   console.log(getVersion());
   process.exit(0);
 }
-var legacyConfig = join7(process.cwd(), ".agenthud", "config.yaml");
-if (isLegacyProjectConfig(process.cwd(), homedir5()) && existsSync7(legacyConfig)) {
+var legacyConfig = join8(process.cwd(), ".agenthud", "config.yaml");
+if (isLegacyProjectConfig(process.cwd(), homedir5()) && existsSync8(legacyConfig)) {
   console.log(
     "The project-level config file (.agenthud/config.yaml) is no longer supported."
   );

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "agenthud",
-  "version": "0.12.1",
+  "version": "0.12.3",
   "description": "CLI tool to monitor agent status in real-time. Works with Claude Code, multi-agent workflows, and any AI agent system.",
   "type": "module",
   "main": "dist/index.js",