agenthud 0.8.0 → 0.8.2

package/README.md

@@ -105,6 +105,31 @@ Press `↵` on any activity to open a scrollable full-content view.
 | `↓` / `j` | Scroll down |
 | `↵` / `Esc` / `q` | Close |
 
+## Report
+
+Print a Markdown summary of all activity on a given date, suitable for piping to scripts or LLMs:
+
+```bash
+agenthud report                          # today
+agenthud report --date 2026-05-14        # specific date
+agenthud report --date today --include all  # all activity types
+```
+
+Output is written to stdout in Markdown format:
+
+```
+# AgentHUD Report: 2026-05-14
+
+## myproject (10:23 – 14:45)
+
+[10:23] $ npm test
+[10:35] ~ src/ui/App.tsx
+[11:15] < Added spinner hook to make the UI feel alive.
+```
+
+**`--include` types:** `response`, `bash`, `edit`, `thinking`, `read`, `glob`, `user`  
+Default: `response,bash,edit,thinking`
+
 ## Configuration
 
 Optional. Create `~/.agenthud/config.yaml`:
@@ -120,6 +145,12 @@ hiddenSubAgents:
   - code-reviewer
 ```
 
+## Environment Variables
+
+| Variable | Default | Description |
+|----------|---------|-------------|
+| `CLAUDE_PROJECTS_DIR` | `~/.claude/projects` | Path to Claude Code projects directory. Useful for backups or mounted volumes. |
+
 ## Feedback
 
 Issues and PRs welcome at [GitHub](https://github.com/neochoon/agenthud).

package/dist/index.js

@@ -14,4 +14,4 @@ Error: Node.js ${MIN_NODE_VERSION}+ is required (current: ${process.version})
   console.error("  https://nodejs.org/\n");
   process.exit(1);
 }
-import("./main-CA4K47Y5.js");
+import("./main-QZW2W2BX.js");

package/dist/{main-CA4K47Y5.js → main-QZW2W2BX.js}

@@ -1,7 +1,7 @@
 // src/main.ts
-import { createInterface } from "readline";
 import { existsSync as existsSync5, rmSync } from "fs";
 import { join as join5 } from "path";
+import { createInterface } from "readline";
 import { render } from "ink";
 import React from "react";
 
@@ -9,16 +9,50 @@ import React from "react";
 import { readFileSync } from "fs";
 import { dirname, join } from "path";
 import { fileURLToPath } from "url";
+var ALL_TYPES = [
+  "response",
+  "bash",
+  "edit",
+  "thinking",
+  "read",
+  "glob",
+  "user"
+];
+var DEFAULT_TYPES = ["response", "bash", "edit", "thinking"];
+var KNOWN_WATCH_FLAGS = /* @__PURE__ */ new Set([
+  "-w",
+  "--watch",
+  "--once",
+  "-V",
+  "--version",
+  "-h",
+  "--help"
+]);
+var KNOWN_REPORT_FLAGS = /* @__PURE__ */ new Set(["--date", "--include", "--format"]);
+var KNOWN_SUBCOMMANDS = /* @__PURE__ */ new Set(["report"]);
 function getHelp() {
   return `Usage: agenthud [options]
 
 Monitors all running Claude Code sessions in real-time.
 
 Options:
-  -w, --watch       Watch mode (default) \u2014 live updates
-  --once            Print once and exit
-  -V, --version     Show version number
-  -h, --help        Show this help message
+  -w, --watch                   Watch mode (default) \u2014 live updates
+  --once                        Print once and exit
+  -V, --version                 Show version number
+  -h, --help                    Show this help message
+
+Commands:
+  report [--date DATE] [--include TYPES]
+                                Print activity report for a date (default: today)
+    --date YYYY-MM-DD|today     Date to report on
+    --include TYPES             Comma-separated types or "all"
+                                Types: response,bash,edit,thinking,read,glob,user
+                                Default: response,bash,edit,thinking
+    --format FORMAT             Output format: markdown (default) or json
+
+Environment:
+  CLAUDE_PROJECTS_DIR           Path to Claude projects directory
+                                (default: ~/.claude/projects)
 
 Config: ~/.agenthud/config.yaml
 Logs:   ~/.agenthud/logs/
@@ -34,6 +68,26 @@ function getVersion() {
 function clearScreen() {
   console.clear();
 }
+function parseUTCMidnight(dateStr) {
+  if (dateStr === "today") {
+    const now = /* @__PURE__ */ new Date();
+    return new Date(
+      Date.UTC(now.getUTCFullYear(), now.getUTCMonth(), now.getUTCDate())
+    );
+  }
+  const match = dateStr.match(/^(\d{4})-(\d{2})-(\d{2})$/);
+  if (!match) return null;
+  const [, y, m, d] = match.map(Number);
+  const date = new Date(Date.UTC(y, m - 1, d));
+  if (Number.isNaN(date.getTime())) return null;
+  return date;
+}
+function todayUTCMidnight() {
+  const now = /* @__PURE__ */ new Date();
+  return new Date(
+    Date.UTC(now.getUTCFullYear(), now.getUTCMonth(), now.getUTCDate())
+  );
+}
 function parseArgs(args) {
   if (args.includes("--help") || args.includes("-h")) {
     return { mode: "watch", command: "help" };
@@ -44,15 +98,77 @@ function parseArgs(args) {
   if (args.includes("--once")) {
     return { mode: "once" };
   }
+  if (args[0] === "report") {
+    const rest = args.slice(1);
+    let reportDate = todayUTCMidnight();
+    let reportInclude = DEFAULT_TYPES;
+    let reportError;
+    for (const arg of rest) {
+      if (arg.startsWith("-") && !KNOWN_REPORT_FLAGS.has(arg)) {
+        reportError = `Unknown option: "${arg}". Run agenthud --help for usage.`;
+        break;
+      }
+    }
+    const dateIdx = rest.indexOf("--date");
+    if (dateIdx !== -1) {
+      const dateStr = rest[dateIdx + 1];
+      if (!dateStr) {
+        reportError = "Invalid date: missing value for --date";
+      } else {
+        const parsed = parseUTCMidnight(dateStr);
+        if (!parsed) {
+          reportError = `Invalid date: "${dateStr}". Use YYYY-MM-DD or "today".`;
+        } else {
+          reportDate = parsed;
+        }
+      }
+    }
+    const includeIdx = rest.indexOf("--include");
+    if (includeIdx !== -1) {
+      const includeStr = rest[includeIdx + 1];
+      if (includeStr === "all") {
+        reportInclude = ALL_TYPES;
+      } else if (includeStr) {
+        reportInclude = includeStr.split(",").map((s) => s.trim()).filter(Boolean);
+      }
+    }
+    let reportFormat = "markdown";
+    const formatIdx = rest.indexOf("--format");
+    if (formatIdx !== -1) {
+      const fmt = rest[formatIdx + 1];
+      if (fmt === "json" || fmt === "markdown") {
+        reportFormat = fmt;
+      } else if (fmt) {
+        reportError = `Invalid format: "${fmt}". Use "markdown" or "json".`;
+      } else {
+        reportError = "Invalid format: missing value for --format.";
+      }
+    }
+    return {
+      mode: "report",
+      reportDate,
+      reportInclude,
+      reportFormat,
+      reportError
+    };
+  }
+  if (args[0] && !args[0].startsWith("-") && !KNOWN_SUBCOMMANDS.has(args[0])) {
+    return {
+      mode: "watch",
+      error: `Unknown command: "${args[0]}". Run agenthud --help for usage.`
+    };
+  }
+  for (const arg of args) {
+    if (arg.startsWith("-") && !KNOWN_WATCH_FLAGS.has(arg)) {
+      return {
+        mode: "watch",
+        error: `Unknown option: "${arg}". Run agenthud --help for usage.`
+      };
+    }
+  }
   return { mode: "watch" };
 }
 
-// src/ui/App.tsx
-import { existsSync as existsSync4, watch, writeFileSync as writeFileSync2 } from "fs";
-import { join as join4 } from "path";
-import { Box as Box4, Text as Text4, useApp, useInput, useStdout } from "ink";
-import { useCallback, useEffect as useEffect2, useMemo, useRef, useState as useState2 } from "react";
-
 // src/config/globalConfig.ts
 import { existsSync, mkdirSync, readFileSync as readFileSync2, writeFileSync } from "fs";
 import { homedir } from "os";
@@ -145,6 +261,9 @@ function hasProjectLevelConfig() {
   return existsSync(join2(process.cwd(), ".agenthud", "config.yaml"));
 }
 
+// src/data/reportGenerator.ts
+import { statSync } from "fs";
+
 // src/data/sessionHistory.ts
 import { existsSync as existsSync2, readFileSync as readFileSync3 } from "fs";
 
@@ -295,8 +414,103 @@ function parseSessionHistory(filePath) {
   return activities;
 }
 
+// src/data/reportGenerator.ts
+function activityMatchesInclude(activity, include) {
+  const label = activity.label.toLowerCase();
+  const type = activity.type;
+  if (include.includes("response") && type === "response") return true;
+  if (include.includes("thinking") && type === "thinking") return true;
+  if (include.includes("user") && type === "user") return true;
+  if (include.includes("bash") && label === "bash") return true;
+  if (include.includes("edit") && (label === "edit" || label === "write" || label === "todowrite"))
+    return true;
+  if (include.includes("read") && (label === "read" || label === "glob" || label === "grep"))
+    return true;
+  if (include.includes("glob") && (label === "glob" || label === "grep"))
+    return true;
+  return false;
+}
+function isSameUTCDay(a, b) {
+  return a.getUTCFullYear() === b.getUTCFullYear() && a.getUTCMonth() === b.getUTCMonth() && a.getUTCDate() === b.getUTCDate();
+}
+function formatTime(date) {
+  return `${String(date.getUTCHours()).padStart(2, "0")}:${String(date.getUTCMinutes()).padStart(2, "0")}`;
+}
+function formatActivity(activity) {
+  const time = formatTime(activity.timestamp);
+  const detail = activity.detail.length > 120 ? activity.detail.slice(0, 120) : activity.detail;
+  const suffix = detail ? `: ${detail}` : "";
+  return `[${time}] ${activity.icon} ${activity.label}${suffix}`;
+}
+function formatDateString(date) {
+  return `${date.getUTCFullYear()}-${String(date.getUTCMonth() + 1).padStart(2, "0")}-${String(date.getUTCDate()).padStart(2, "0")}`;
+}
+function sessionIsOnDate(session, date, activities) {
+  try {
+    const mtime = new Date(statSync(session.filePath).mtimeMs);
+    if (isSameUTCDay(mtime, date)) return true;
+  } catch {
+  }
+  return activities.some((a) => isSameUTCDay(a.timestamp, date));
+}
+function generateReport(sessions, options2) {
+  const { date, include, format = "markdown" } = options2;
+  const dateStr = formatDateString(date);
+  const blocks = [];
+  for (const session of sessions) {
+    const allActivities = parseSessionHistory(session.filePath);
+    if (!sessionIsOnDate(session, date, allActivities)) continue;
+    const dayActivities = allActivities.filter((a) => isSameUTCDay(a.timestamp, date)).filter((a) => activityMatchesInclude(a, include));
+    if (dayActivities.length === 0) continue;
+    blocks.push({
+      session,
+      activities: dayActivities,
+      firstTime: dayActivities[0].timestamp.getTime()
+    });
+  }
+  if (blocks.length === 0) {
+    if (format === "json") {
+      return JSON.stringify({ date: dateStr, sessions: [] }, null, 2);
+    }
+    return `No activity found for ${dateStr}.`;
+  }
+  blocks.sort((a, b) => a.firstTime - b.firstTime);
+  if (format === "json") {
+    return JSON.stringify(
+      {
+        date: dateStr,
+        sessions: blocks.map(({ session, activities }) => ({
+          project: session.projectName,
+          start: formatTime(activities[0].timestamp),
+          end: formatTime(activities[activities.length - 1].timestamp),
+          activities: activities.map((a) => ({
+            time: formatTime(a.timestamp),
+            icon: a.icon,
+            label: a.label,
+            detail: a.detail.length > 120 ? a.detail.slice(0, 120) : a.detail
+          }))
+        }))
+      },
+      null,
+      2
+    );
+  }
+  const lines = [`# AgentHUD Report: ${dateStr}`, ""];
+  for (const { session, activities } of blocks) {
+    const first = formatTime(activities[0].timestamp);
+    const last = formatTime(activities[activities.length - 1].timestamp);
+    lines.push(`## ${session.projectName} (${first} \u2013 ${last})`);
+    lines.push("");
+    for (const activity of activities) {
+      lines.push(formatActivity(activity));
+    }
+    lines.push("");
+  }
+  return lines.join("\n").trimEnd();
+}
+
 // src/data/sessions.ts
-import { existsSync as existsSync3, readdirSync, readFileSync as readFileSync4, statSync } from "fs";
+import { existsSync as existsSync3, readdirSync, readFileSync as readFileSync4, statSync as statSync2 } from "fs";
 import { homedir as homedir2 } from "os";
 import { basename as basename2, join as join3 } from "path";
 
@@ -339,7 +553,7 @@ var getDisplayWidth = stringWidth;
 
 // src/data/sessions.ts
 function getProjectsDir() {
-  return join3(homedir2(), ".claude", "projects");
+  return process.env.CLAUDE_PROJECTS_DIR ?? join3(homedir2(), ".claude", "projects");
 }
 function decodeProjectPath(encoded) {
   const windowsDriveMatch = encoded.match(/^([A-Za-z])--(.*)$/);
@@ -418,7 +632,7 @@ function buildSubAgents(parentId, projectDir, config, projectName) {
     const hideKey = `${projectName}/${id}`;
     const filePath = join3(subagentsDir, file);
     try {
-      const stat = statSync(filePath);
+      const stat = statSync2(filePath);
       const { agentId, taskDescription } = readSubAgentInfo(filePath);
       return {
         id,
@@ -449,7 +663,7 @@ function discoverSessions(config) {
   try {
     projectDirs = readdirSync(projectsDir).filter((entry) => {
       try {
-        return statSync(join3(projectsDir, entry)).isDirectory();
+        return statSync2(join3(projectsDir, entry)).isDirectory();
       } catch {
         return false;
       }
@@ -475,7 +689,7 @@ function discoverSessions(config) {
       const hideKey = `${projectName}/${id}`;
       const filePath = join3(projectDir, file);
       try {
-        const stat = statSync(filePath);
+        const stat = statSync2(filePath);
         const subAgents = buildSubAgents(id, projectDir, config, projectName);
         allSessions.push({
           id,
@@ -514,6 +728,12 @@ function discoverSessions(config) {
   };
 }
 
+// src/ui/App.tsx
+import { existsSync as existsSync4, watch, writeFileSync as writeFileSync2 } from "fs";
+import { join as join4 } from "path";
+import { Box as Box4, Text as Text4, useApp, useInput, useStdout } from "ink";
+import { useCallback, useEffect as useEffect2, useMemo, useRef, useState as useState2 } from "react";
+
 // src/ui/ActivityViewerPanel.tsx
 import { Box, Text } from "ink";
 import { jsx, jsxs } from "react/jsx-runtime";
@@ -570,13 +790,14 @@ function ActivityViewerPanel({
   visibleRows,
   width,
   cursorLine,
-  hasFocus
+  hasFocus,
+  spinner = ""
 }) {
   const innerWidth = getInnerWidth(width);
   const contentWidth = innerWidth - 1;
   let titleSuffix;
   if (isLive) {
-    titleSuffix = "[LIVE \u25BC]";
+    titleSuffix = `[LIVE ${spinner || "\u25BC"}]`;
   } else {
     const badge = newCount > 0 ? ` +${newCount}\u2191` : "";
     titleSuffix = `[PAUSED \u2193${scrollOffset}${badge}]`;
@@ -711,8 +932,18 @@ function DetailViewPanel({
     clampedOffset,
     clampedOffset + visibleRows
   );
-  const titleLabel = `${activity.icon} ${activity.label}`;
+  const style = getActivityStyle(activity);
   const scrollSuffix = totalLines > visibleRows ? `[${clampedOffset + 1}-${Math.min(clampedOffset + visibleRows, totalLines)}/${totalLines}]` : "";
+  const iconWidth = getDisplayWidth(activity.icon);
+  const labelWidth = activity.label.length;
+  const scrollPart = scrollSuffix ? ` ${scrollSuffix} ${BOX.h}` : "";
+  const scrollPartWidth = scrollSuffix ? getDisplayWidth(scrollPart) : 0;
+  const dashCount = Math.max(
+    0,
+    width - 3 - iconWidth - 1 - labelWidth - 1 - scrollPartWidth - 1
+  );
+  const dashes = BOX.h.repeat(dashCount);
+  const titleRight = `${dashes}${scrollPart}${BOX.tr}`;
   const contentRows = [];
   for (let i = 0; i < visibleRows; i++) {
     const line = visibleSlice[i] ?? "";
@@ -728,7 +959,16 @@ function DetailViewPanel({
     );
   }
   return /* @__PURE__ */ jsxs2(Box2, { flexDirection: "column", width, children: [
-    /* @__PURE__ */ jsx2(Text2, { children: createTitleLine(titleLabel, scrollSuffix, width) }),
+    /* @__PURE__ */ jsxs2(Text2, { children: [
+      BOX.tl,
+      BOX.h,
+      " ",
+      /* @__PURE__ */ jsx2(Text2, { color: "cyan", children: activity.icon }),
+      " ",
+      /* @__PURE__ */ jsx2(Text2, { color: style.color, dimColor: style.dimColor, children: activity.label }),
+      " ",
+      titleRight
+    ] }),
     contentRows,
     /* @__PURE__ */ jsx2(Text2, { children: createBottomLine(width) })
   ] });
@@ -1352,11 +1592,10 @@ function App({ mode }) {
   const selectedIndex = allFlat.findIndex((s) => s.id === selectedId);
   const height = (stdout?.rows ?? 41) - 1;
   const width = stdout?.columns ?? 80;
-  const viewerRows = Math.max(
-    5,
-    Math.floor(height * VIEWER_HEIGHT_FRACTION) - 4
-  );
-  const treeRows = Math.max(3, height - viewerRows - 7);
+  const maxTreeRows = Math.floor(height * (1 - VIEWER_HEIGHT_FRACTION));
+  const naturalTreeRows = allFlat.length;
+  const treeRows = Math.max(1, Math.min(naturalTreeRows, maxTreeRows));
+  const viewerRows = Math.max(5, height - 7 - treeRows);
   const saveLog = useCallback(() => {
     if (!activities.length || !selectedId) return;
     ensureLogDir(config.logDir);
@@ -1636,7 +1875,8 @@ function App({ mode }) {
         visibleRows: viewerRows,
         width,
         cursorLine: viewerCursorLine,
-        hasFocus: focus === "viewer"
+        hasFocus: focus === "viewer",
+        spinner
       }
     ) })
   ] });
@@ -1644,6 +1884,11 @@ function App({ mode }) {
 
 // src/main.ts
 var options = parseArgs(process.argv.slice(2));
+if (options.error) {
+  process.stderr.write(`agenthud: ${options.error}
+`);
+  process.exit(1);
+}
 if (options.command === "help") {
   console.log(getHelp());
   process.exit(0);
@@ -1660,22 +1905,36 @@ if (existsSync5(legacyConfig)) {
   console.log("Settings have moved to ~/.agenthud/config.yaml.");
   const rl = createInterface({ input: process.stdin, output: process.stdout });
   await new Promise((resolve) => {
-    rl.question(
-      "Delete the old config file and continue? [y/N] ",
-      (answer) => {
-        rl.close();
-        if (answer.trim().toLowerCase() === "y") {
-          rmSync(legacyConfig);
-          console.log("Deleted .agenthud/config.yaml.");
-        } else {
-          console.log("Aborted.");
-          process.exit(0);
-        }
-        resolve();
+    rl.question("Delete the old config file and continue? [y/N] ", (answer) => {
+      rl.close();
+      if (answer.trim().toLowerCase() === "y") {
+        rmSync(legacyConfig);
+        console.log("Deleted .agenthud/config.yaml.");
+      } else {
+        console.log("Aborted.");
+        process.exit(0);
       }
-    );
+      resolve();
+    });
   });
 }
+if (options.mode === "report") {
+  if (options.reportError) {
+    process.stderr.write(`agenthud: ${options.reportError}
+`);
+    process.exit(1);
+  }
+  const config = loadGlobalConfig();
+  const tree = discoverSessions(config);
+  const markdown = generateReport(tree.sessions, {
+    date: options.reportDate,
+    include: options.reportInclude,
+    format: options.reportFormat
+  });
+  process.stdout.write(`${markdown}
+`);
+  process.exit(0);
+}
 if (options.mode === "watch") {
   clearScreen();
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "agenthud",
-  "version": "0.8.0",
+  "version": "0.8.2",
   "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",