agenthud 0.13.3 → 0.14.0

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-GMNV6O4E.js");
+import("./main-S5INN7N3.js");

package/dist/{main-GMNV6O4E.js → main-S5INN7N3.js}

@@ -179,7 +179,8 @@ function loadGlobalConfig() {
       config.report.detailLimit = r.detailLimit;
     }
     if (typeof r.withGit === "boolean") config.report.withGit = r.withGit;
-    if (r.format === "markdown" || r.format === "json") config.report.format = r.format;
+    if (r.format === "markdown" || r.format === "json")
+      config.report.format = r.format;
   }
   if (configRaw.summary && typeof configRaw.summary === "object") {
     const s = configRaw.summary;
@@ -194,7 +195,8 @@ function loadGlobalConfig() {
       config.summary.detailLimit = s.detailLimit;
     }
     if (typeof s.withGit === "boolean") config.summary.withGit = s.withGit;
-    if (s.format === "markdown" || s.format === "json") config.summary.format = s.format;
+    if (s.format === "markdown" || s.format === "json")
+      config.summary.format = s.format;
     if (typeof s.model === "string" && s.model.trim().length > 0) {
       config.summary.model = s.model.trim();
     }
@@ -247,7 +249,7 @@ function loadGlobalConfig() {
   return config;
 }
 function updateState(updates) {
-  let state = {
+  const state = {
     hiddenSessions: [],
     hiddenSubAgents: [],
     hiddenProjects: []
@@ -296,6 +298,27 @@ function hideProject(name) {
   if (config.hiddenProjects.includes(name)) return;
   updateState({ hiddenProjects: [...config.hiddenProjects, name] });
 }
+function unhideSession(id) {
+  const config = loadGlobalConfig();
+  if (!config.hiddenSessions.includes(id)) return;
+  updateState({
+    hiddenSessions: config.hiddenSessions.filter((s) => s !== id)
+  });
+}
+function unhideSubAgent(id) {
+  const config = loadGlobalConfig();
+  if (!config.hiddenSubAgents.includes(id)) return;
+  updateState({
+    hiddenSubAgents: config.hiddenSubAgents.filter((s) => s !== id)
+  });
+}
+function unhideProject(name) {
+  const config = loadGlobalConfig();
+  if (!config.hiddenProjects.includes(name)) return;
+  updateState({
+    hiddenProjects: config.hiddenProjects.filter((p) => p !== name)
+  });
+}
 function hasProjectLevelConfig() {
   const candidate = join(process.cwd(), ".agenthud", "config.yaml");
   if (candidate === join(homedir(), ".agenthud", "config.yaml")) return false;
@@ -978,7 +1001,11 @@ function buildToolDetailBody(name, input, result) {
     const content = result?.file?.content;
     if (content) {
       const start = result?.file?.startLine ?? input?.offset ?? 1;
-      return { text: numberLines(content, start), kind: "code", numbered: true };
+      return {
+        text: numberLines(content, start),
+        kind: "code",
+        numbered: true
+      };
     }
   }
   if (name === "Edit" || name === "Write") {
@@ -1470,6 +1497,15 @@ function readFirstUserPrompt(filePath) {
   } catch {
     return null;
   }
+  const MIN_SUBSTANTIAL_LEN = 10;
+  const isSubstantial = (text) => {
+    const trimmed = text.trim();
+    if (trimmed.length < MIN_SUBSTANTIAL_LEN) return false;
+    if (trimmed.startsWith("/")) return false;
+    return true;
+  };
+  let first = null;
+  let latestSubstantial = null;
   for (const line of content.split("\n")) {
     if (!line.trim()) continue;
     let entry;
@@ -1495,9 +1531,11 @@ function readFirstUserPrompt(filePath) {
     if (!text || isSystemNoise(text)) continue;
     const firstLine = text.split("\n").find((l) => l.trim()) ?? "";
     if (!firstLine || isSystemNoise(firstLine)) continue;
-    return capWithEllipsis(firstLine);
+    const capped = capWithEllipsis(firstLine);
+    if (first === null) first = capped;
+    if (isSubstantial(firstLine)) latestSubstantial = capped;
   }
-  return null;
+  return latestSubstantial ?? first;
 }
 function readEntrypoint(filePath) {
   if (!existsSync3(filePath)) return null;
@@ -1552,9 +1590,10 @@ function buildSubAgents(parentId, projectDir, config, projectName) {
     } catch {
       return null;
     }
-  }).filter(
-    (n) => n !== null && !config.hiddenSubAgents.includes(n.hideKey)
-  ).sort((a, b) => b.lastModifiedMs - a.lastModifiedMs);
+  }).filter((n) => n !== null).map((n) => {
+    if (config.hiddenSubAgents.includes(n.hideKey)) n.hidden = true;
+    return n;
+  }).sort((a, b) => b.lastModifiedMs - a.lastModifiedMs);
 }
 function findContainingProject(cwd, projectPaths, options2) {
   const resolve2 = options2?.realpath ?? ((p) => p);
@@ -1592,7 +1631,8 @@ function discoverSessions(config, options2) {
       projects: [],
       coldProjects: [],
       totalCount: 0,
-      timestamp: (/* @__PURE__ */ new Date()).toISOString()
+      timestamp: (/* @__PURE__ */ new Date()).toISOString(),
+      hiddenStats: { total: 0, active: 0 }
     };
   }
   let projectDirs;
@@ -1609,7 +1649,8 @@ function discoverSessions(config, options2) {
       projects: [],
       coldProjects: [],
       totalCount: 0,
-      timestamp: (/* @__PURE__ */ new Date()).toISOString()
+      timestamp: (/* @__PURE__ */ new Date()).toISOString(),
+      hiddenStats: { total: 0, active: 0 }
     };
   }
   const allSessions = [];
@@ -1659,8 +1700,23 @@ function discoverSessions(config, options2) {
     }
   }
   const byProject = /* @__PURE__ */ new Map();
+  let hiddenTotal = 0;
+  let hiddenActive = 0;
   for (const s of allSessions) {
-    if (config.hiddenSessions.includes(s.hideKey)) continue;
+    const sessionHidden = config.hiddenSessions.includes(s.hideKey);
+    const projectHidden = config.hiddenProjects.includes(s.projectName);
+    if (sessionHidden || projectHidden) {
+      hiddenTotal++;
+      if (s.status === "hot" || s.status === "warm") hiddenActive++;
+      s.hidden = true;
+    }
+    for (const sub of s.subAgents) {
+      if (sub.hidden || projectHidden) {
+        if (projectHidden) sub.hidden = true;
+        hiddenTotal++;
+        if (sub.status === "hot" || sub.status === "warm") hiddenActive++;
+      }
+    }
     const arr = byProject.get(s.projectPath) ?? [];
     arr.push(s);
     byProject.set(s.projectPath, arr);
@@ -1675,7 +1731,7 @@ function discoverSessions(config, options2) {
   for (const [projectPath, sessions] of byProject) {
     if (sessions.length === 0) continue;
     const projectName = sessions[0].projectName;
-    if (config.hiddenProjects.includes(projectName)) continue;
+    const projectHidden = config.hiddenProjects.includes(projectName);
     sessions.sort((a, b) => {
       if (a.nonInteractive !== b.nonInteractive) {
         return a.nonInteractive ? 1 : -1;
@@ -1685,7 +1741,13 @@ function discoverSessions(config, options2) {
       return b.lastModifiedMs - a.lastModifiedMs;
     });
     const hotness = sessions[0].status;
-    allProjects.push({ name: projectName, projectPath, sessions, hotness });
+    allProjects.push({
+      name: projectName,
+      projectPath,
+      sessions,
+      hotness,
+      hidden: projectHidden || void 0
+    });
   }
   const activeProjects = allProjects.filter((p) => p.hotness !== "cold");
   const coldProjects = allProjects.filter((p) => p.hotness === "cold");
@@ -1703,7 +1765,8 @@ function discoverSessions(config, options2) {
     projects: activeProjects,
     coldProjects,
     totalCount,
-    timestamp: (/* @__PURE__ */ new Date()).toISOString()
+    timestamp: (/* @__PURE__ */ new Date()).toISOString(),
+    hiddenStats: { total: hiddenTotal, active: hiddenActive }
   };
 }
 
@@ -1842,6 +1905,27 @@ async function openInDefaultApp(path) {
   });
 }
 
+// src/utils/stderrTicker.ts
+function formatTickerLine(label, elapsedSeconds, dots) {
+  const tail = ".".repeat(dots % 4).padEnd(3, " ");
+  return `${label}${tail} ${elapsedSeconds}s`;
+}
+function startStderrTicker(label, options2 = {}) {
+  const intervalMs = options2.intervalMs ?? 500;
+  const stream = options2.stream ?? process.stderr;
+  const start = Date.now();
+  let ticks = 0;
+  const id = setInterval(() => {
+    ticks++;
+    const elapsed = Math.floor((Date.now() - start) / 1e3);
+    stream.write(`\r${formatTickerLine(label, elapsed, ticks)}`);
+  }, intervalMs);
+  return function stop() {
+    clearInterval(id);
+    if (ticks > 0) stream.write("\r\x1B[K");
+  };
+}
+
 // src/data/summariesIndex.ts
 import { existsSync as existsSync5, readdirSync as readdirSync2, readFileSync as readFileSync6, writeFileSync as writeFileSync2 } from "fs";
 import { join as join5 } from "path";
@@ -2001,15 +2085,11 @@ function buildHeaderBlock(currentFilename, entries) {
     const idx = dailies.findIndex((e) => e.filename === currentFilename);
     if (idx > 0) {
       const prev = dailies[idx - 1];
-      parts.push(
-        `[\u2190 ${formatDateLabel(prev.date)}](./${prev.filename})`
-      );
+      parts.push(`[\u2190 ${formatDateLabel(prev.date)}](./${prev.filename})`);
     }
     if (idx >= 0 && idx < dailies.length - 1) {
       const next = dailies[idx + 1];
-      parts.push(
-        `[${formatDateLabel(next.date)} \u2192](./${next.filename})`
-      );
+      parts.push(`[${formatDateLabel(next.date)} \u2192](./${next.filename})`);
     }
   }
   const backlinkLine = parts.join(" \xB7 ");
@@ -2066,11 +2146,7 @@ function regenerateIndex(summariesDir2) {
   }
   const indexPath = join5(summariesDir2, "index.md");
   try {
-    writeFileSync2(
-      indexPath,
-      buildIndexMarkdown(entries, snippets),
-      "utf-8"
-    );
+    writeFileSync2(indexPath, buildIndexMarkdown(entries, snippets), "utf-8");
   } catch (err) {
     process.stderr.write(
       `warning: cannot write summaries index (${err.message})
@@ -2079,27 +2155,6 @@ function regenerateIndex(summariesDir2) {
   }
 }
 
-// src/utils/stderrTicker.ts
-function formatTickerLine(label, elapsedSeconds, dots) {
-  const tail = ".".repeat(dots % 4).padEnd(3, " ");
-  return `${label}${tail} ${elapsedSeconds}s`;
-}
-function startStderrTicker(label, options2 = {}) {
-  const intervalMs = options2.intervalMs ?? 500;
-  const stream = options2.stream ?? process.stderr;
-  const start = Date.now();
-  let ticks = 0;
-  const id = setInterval(() => {
-    ticks++;
-    const elapsed = Math.floor((Date.now() - start) / 1e3);
-    stream.write(`\r${formatTickerLine(label, elapsed, ticks)}`);
-  }, intervalMs);
-  return function stop() {
-    clearInterval(id);
-    if (ticks > 0) stream.write("\r\x1B[K");
-  };
-}
-
 // src/data/summaryRunner.ts
 function agenthudHomeDir() {
   const dir = join6(homedir3(), ".agenthud");
@@ -2227,14 +2282,10 @@ function spawnClaude(opts) {
     ];
     if (opts.model) args.push("--model", opts.model);
     args.push(opts.prompt);
-    const proc = spawn2(
-      "claude",
-      args,
-      {
-        stdio: ["pipe", "pipe", "pipe"],
-        cwd: agenthudHomeDir()
-      }
-    );
+    const proc = spawn2("claude", args, {
+      stdio: ["pipe", "pipe", "pipe"],
+      cwd: agenthudHomeDir()
+    });
     let cacheStream = null;
     if (opts.cachePath) {
       cacheStream = createWriteStream(opts.cachePath, { encoding: "utf-8" });
@@ -2534,10 +2585,8 @@ async function runRangeSummary(options2) {
   )) {
     try {
       const content = readFileSync7(rangeCache, "utf-8");
-      process.stderr.write(
-        `cached range summary from ${rangeCache}
-`
-      );
+      process.stderr.write(`cached range summary from ${rangeCache}
+`);
       if (!options2.open) {
         process.stdout.write(content);
         if (!content.endsWith("\n")) process.stdout.write("\n");
@@ -2565,10 +2614,8 @@ async function runRangeSummary(options2) {
     `range ${fromLabel} \u2192 ${toLabel} (${dates.length} days)
 `
   );
-  process.stderr.write(
-    `${cachedCount} cached, ${missingCount} to generate
-`
-  );
+  process.stderr.write(`${cachedCount} cached, ${missingCount} to generate
+`);
   const dailyMarkdowns = [];
   let skippedCount = 0;
   for (const d of dates) {
@@ -3106,12 +3153,19 @@ var SECTIONS = [
     title: "Project tree",
     rows: [
       ["\u2191 \u2193 / k j", "Move selection"],
-      ["\u2190", "Jump to parent (sub-agent \u2192 session, session \u2192 project)"],
+      ["\u2190 / h", "Jump to parent (sub-agent \u2192 session, session \u2192 project)"],
       ["PgUp / Ctrl+B", "Page up"],
       ["PgDn / Ctrl+F", "Page down"],
       ["\u21B5", "Expand/collapse project, session, or summary"],
-      ["h", "Hide selected (project/session/sub-agent)"],
-      ["t", "Track: auto-follow the newest live sub-agent (any nav key turns it off)"],
+      [
+        "H",
+        "Toggle hide on selected \u2014 hides if visible, unhides if hidden (Shift+H)"
+      ],
+      ["a", "Toggle show hidden items in the tree (dim \u2298 marker)"],
+      [
+        "t",
+        "Track: auto-follow the newest live sub-agent (any nav key turns it off)"
+      ],
       ["Tab", "Switch focus to activity viewer"],
       ["r", "Refresh now"]
     ]
@@ -3257,6 +3311,7 @@ function useHotkeys({
   onHelpScrollToTop,
   onToggleTracking,
   onJumpToParent,
+  onToggleShowHidden,
   filterLabel,
   trackingOn = false
 }) {
@@ -3341,7 +3396,7 @@ function useHotkeys({
       onFilter();
       return;
     }
-    if (input === "t" && !key.ctrl && onToggleTracking) {
+    if (input === "t" && !key.ctrl && focus === "tree" && onToggleTracking) {
       onToggleTracking();
       return;
     }
@@ -3372,11 +3427,15 @@ function useHotkeys({
       }
     }
     if (focus === "tree") {
-      if (input === "h") {
+      if (input === "H") {
         onHide();
         return;
       }
-      if (key.leftArrow && onJumpToParent) {
+      if (input === "a" && onToggleShowHidden) {
+        onToggleShowHidden();
+        return;
+      }
+      if ((input === "h" || key.leftArrow) && onJumpToParent) {
         onJumpToParent();
         return;
       }
@@ -3408,16 +3467,16 @@ function useHotkeys({
       }
     }
   };
-  const trackingItems = trackingOn ? ["TRK \u25CF"] : ["t: track"];
+  const trackingItems = trackingOn ? ["TRK \u25CF"] : [];
   const statusBarItems = helpMode ? ["\u2191\u2193/jk: scroll", "PgDn/Space: page", "\u21B5/Esc/q/?: close"] : detailMode ? ["\u2191\u2193/jk: scroll", "C-u/d: \xBDpage", "\u21B5/Esc: close", "?: help"] : focus === "tree" ? [
     ...trackingItems,
     "Tab: viewer",
     "\u2191\u2193/jk: select",
-    "\u2190: parent",
+    "h/\u2190: parent",
     "PgUp/Dn: page",
     "\u21B5: expand",
-    "h: hide",
-    "r: refresh",
+    "H: hide",
+    "a: show hidden",
     "?: help",
     "q: quit"
   ] : [
@@ -3525,7 +3584,8 @@ function SessionRow({
   const rightParts = [elapsed];
   if (model) rightParts.push(model);
   const rightSide = rightParts.join(" ");
-  const leftCoreBase = `${prefix}${rawName}${shortIdDisplay} ${badge}`;
+  const hiddenMarker = session.hidden ? "\u2298 " : "";
+  const leftCoreBase = `${prefix}${rawName}${shortIdDisplay} ${hiddenMarker}${badge}`;
   const leftCoreWidth = getDisplayWidth(leftCoreBase);
   const rightWidth = getDisplayWidth(rightSide);
   const RIGHT_GAP = 3;
@@ -3550,7 +3610,7 @@ function SessionRow({
   const focused = isSelected && hasFocus;
   const muted = isSelected && !hasFocus;
   const showBg = focused || muted;
-  const shouldDim = isNonInteractive || muted;
+  const shouldDim = isNonInteractive || muted || !!session.hidden || session.status === "cold";
   return /* @__PURE__ */ jsxs4(Text4, { children: [
     BOX.v,
     " ",
@@ -3565,6 +3625,7 @@ function SessionRow({
           /* @__PURE__ */ jsx4(Text4, { bold: !shouldDim, children: rawName }),
           shortIdDisplay ? /* @__PURE__ */ jsx4(Text4, { dimColor: true, children: shortIdDisplay }) : null,
           /* @__PURE__ */ jsx4(Text4, { children: " " }),
+          session.hidden ? /* @__PURE__ */ jsx4(Text4, { dimColor: true, children: "\u2298 " }) : null,
           /* @__PURE__ */ jsx4(Text4, { color: badgeColor, children: badge }),
           middleText ? /* @__PURE__ */ jsx4(Text4, { dimColor: true, children: middleSection }) : null,
           /* @__PURE__ */ jsx4(Text4, { children: gap }),
@@ -3626,10 +3687,28 @@ function flattenSessions(projects, coldProjects, expandedIds) {
     result.push({ kind: "project", project, sentinelId });
     const collapsed = expandedIds.has(`__collapsed-${sentinelId}`);
     if (!collapsed) {
-      for (const session of project.sessions) {
+      const activeSessions = project.sessions.filter(
+        (s) => s.status !== "cold"
+      );
+      const coldSessions = project.sessions.filter((s) => s.status === "cold");
+      for (const session of activeSessions) {
         result.push({ kind: "session", session, prefix: "    " });
         appendSessionRows(result, session, expandedIds);
       }
+      if (coldSessions.length > 0) {
+        const coldKey = `__cold-sessions-${project.name}__`;
+        result.push({
+          kind: "cold-sessions-summary",
+          projectName: project.name,
+          count: coldSessions.length
+        });
+        if (expandedIds.has(coldKey)) {
+          for (const session of coldSessions) {
+            result.push({ kind: "session", session, prefix: "    " });
+            appendSessionRows(result, session, expandedIds);
+          }
+        }
+      }
     }
   }
   if (coldProjects.length > 0) {
@@ -3656,28 +3735,61 @@ function ProjectRow({
   hasFocus,
   contentWidth
 }) {
-  const nameText = `> ${project.name}`;
+  const nameText = `> ${project.hidden ? "\u2298 " : ""}${project.name}`;
   const pathText = project.projectPath ? formatProjectPath(project.projectPath) : "";
   const latestMtime = project.sessions.reduce(
     (acc, s) => Math.max(acc, s.lastModifiedMs),
     0
   );
   const elapsed = latestMtime > 0 ? formatElapsed(latestMtime) : "";
+  const sessionCount = project.sessions.length;
+  const subAgentCount = project.sessions.reduce(
+    (n, s) => n + s.subAgents.length,
+    0
+  );
+  const isActive = (status) => status === "hot" || status === "warm";
+  const activeSessionCount = project.sessions.filter(
+    (s) => isActive(s.status)
+  ).length;
+  const activeSubAgentCount = project.sessions.reduce(
+    (n, s) => n + s.subAgents.filter((sa) => isActive(sa.status)).length,
+    0
+  );
+  const buildCountsSegments = (short) => [
+    {
+      text: short ? `${sessionCount}s` : `${sessionCount} sessions`,
+      dim: true
+    },
+    ...activeParen(activeSessionCount, "green", { bold: false }),
+    {
+      text: short ? ` \xB7 ${subAgentCount}a` : ` \xB7 ${subAgentCount} sub-agents`,
+      dim: true
+    },
+    ...activeParen(activeSubAgentCount, "green", { bold: false })
+  ];
+  const longSegs = buildCountsSegments(false);
+  const shortSegs = buildCountsSegments(true);
+  const segWidth = (segs) => segs.reduce((n, s) => n + getDisplayWidth(s.text), 0);
   const nameWidth = getDisplayWidth(nameText);
   const pathWidth = pathText ? getDisplayWidth(pathText) : 0;
   const elapsedWidth = elapsed ? getDisplayWidth(elapsed) : 0;
   const middleGap = pathText ? 2 : 0;
   const leftWidth = nameWidth + middleGap + pathWidth;
   const PROJECT_RIGHT_GAP = 3;
+  const COUNTS_GAP = 2;
+  const fitsCounts = (segs) => leftWidth + COUNTS_GAP + segWidth(segs) + PROJECT_RIGHT_GAP + elapsedWidth <= contentWidth;
+  const countsSegs = fitsCounts(longSegs) ? longSegs : fitsCounts(shortSegs) ? shortSegs : null;
+  const countsWidth = countsSegs ? COUNTS_GAP + segWidth(countsSegs) : 0;
   const rightGap = Math.max(
     PROJECT_RIGHT_GAP,
-    contentWidth - leftWidth - elapsedWidth
+    contentWidth - leftWidth - countsWidth - elapsedWidth
   );
-  const totalWidth = leftWidth + rightGap + elapsedWidth;
+  const totalWidth = leftWidth + countsWidth + rightGap + elapsedWidth;
   const padding = Math.max(0, contentWidth - totalWidth);
   const focused = isSelected && hasFocus;
   const muted = isSelected && !hasFocus;
   const showBg = focused || muted;
+  const dim = muted || !!project.hidden;
   return /* @__PURE__ */ jsxs4(Text4, { children: [
     BOX.v,
     " ",
@@ -3685,14 +3797,27 @@ function ProjectRow({
       Text4,
       {
         backgroundColor: showBg ? "blue" : void 0,
-        bold: !showBg,
-        dimColor: muted,
+        bold: !showBg && !project.hidden,
+        dimColor: dim,
         children: [
           nameText,
           pathText ? /* @__PURE__ */ jsxs4(Fragment3, { children: [
             "  ",
             /* @__PURE__ */ jsx4(Text4, { dimColor: true, children: pathText })
           ] }) : null,
+          countsSegs ? /* @__PURE__ */ jsxs4(Fragment3, { children: [
+            " ".repeat(COUNTS_GAP),
+            countsSegs.map((seg, i) => /* @__PURE__ */ jsx4(
+              Text4,
+              {
+                color: seg.color,
+                dimColor: seg.dim,
+                bold: seg.bold,
+                children: seg.text
+              },
+              `pcnt-${i}`
+            ))
+          ] }) : null,
           " ".repeat(rightGap),
           elapsed ? /* @__PURE__ */ jsx4(Text4, { dimColor: true, children: elapsed }) : null,
           " ".repeat(padding)
@@ -3712,21 +3837,19 @@ function SubagentSummaryRow({
   const parts = [];
   if (coolCount > 0) parts.push(`${coolCount} cool`);
   if (coldCount > 0) parts.push(`${coldCount} cold`);
+  const baseText = `        \u2514\u2500 ... ${parts.join("  ")}`;
   const hint = " +";
-  const text = `        \u2514\u2500 ... ${parts.join("  ")}`;
-  const padding = Math.max(
-    0,
-    contentWidth - getDisplayWidth(text) - getDisplayWidth(hint)
-  );
   const focused = isSelected && hasFocus;
   const muted = isSelected && !hasFocus;
+  const showHint = focused && getDisplayWidth(baseText) + getDisplayWidth(hint) <= contentWidth;
+  const text = showHint ? `${baseText}${hint}` : baseText;
+  const padding = Math.max(0, contentWidth - getDisplayWidth(text));
   return /* @__PURE__ */ jsxs4(Text4, { children: [
     BOX.v,
     " ",
     /* @__PURE__ */ jsxs4(Text4, { dimColor: !focused, inverse: focused || muted, children: [
       text,
-      " ".repeat(padding),
-      hint
+      " ".repeat(padding)
     ] }),
     BOX.v
   ] });
@@ -3757,6 +3880,121 @@ function ColdProjectsSummaryRow({
     }
   );
 }
+function ColdSessionsSummaryRow({
+  count,
+  isSelected,
+  hasFocus,
+  contentWidth
+}) {
+  const prefix = "    ";
+  const baseLabel = `... ${count} cold`;
+  const hint = " +";
+  const baseText = `${prefix}${baseLabel}`;
+  const showHint = isSelected && hasFocus && getDisplayWidth(baseText) + getDisplayWidth(hint) <= contentWidth;
+  const text = showHint ? `${baseText}${hint}` : baseText;
+  const padding = Math.max(0, contentWidth - getDisplayWidth(text));
+  const focused = isSelected && hasFocus;
+  const muted = isSelected && !hasFocus;
+  return /* @__PURE__ */ jsxs4(Text4, { children: [
+    BOX.v,
+    " ",
+    /* @__PURE__ */ jsx4(
+      Text4,
+      {
+        backgroundColor: focused || muted ? "blue" : void 0,
+        bold: focused,
+        dimColor: !focused,
+        children: text
+      }
+    ),
+    " ".repeat(padding),
+    BOX.v
+  ] });
+}
+function activeParen(count, color, opts = {}) {
+  if (count === 0) return [];
+  const { bold = true, dim = false } = opts;
+  return [
+    { text: " (", dim: true },
+    { text: `${count}`, color, bold, dim },
+    { text: ")", dim: true }
+  ];
+}
+function hiddenSeg(hidden, short) {
+  if (hidden.total === 0) return [];
+  const segs = [{ text: ` \xB7 \u2298 ${hidden.total}`, dim: true }];
+  if (!short) segs.push({ text: " hidden", dim: true });
+  if (hidden.active > 0) {
+    segs.push(...activeParen(hidden.active, "yellow"));
+  }
+  return segs;
+}
+function buildTitleSegments(label, census, availableWidth) {
+  const labelSeg = { text: label, dim: true };
+  if (!census) return [labelSeg];
+  const widthOf = (segs) => segs.reduce((w, s) => w + getDisplayWidth(s.text), 0);
+  const c = census;
+  const LEVELS = [
+    // L0: full long form
+    {
+      projectsSuffix: " projects",
+      sessionsSuffix: " sessions",
+      subAgentsSuffix: " sub-agents"
+    },
+    // L1: short form (single-letter abbreviations)
+    {
+      projectsSuffix: "p",
+      sessionsSuffix: "s",
+      subAgentsSuffix: "a",
+      hiddenShort: true
+    },
+    // L2: drop sub-agents
+    { projectsSuffix: "p", sessionsSuffix: "s", hiddenShort: true },
+    // L3: drop sessions
+    { projectsSuffix: "p", hiddenShort: true },
+    // L4: drop project active counter
+    { projectsSuffix: "p", showProjectActive: false, hiddenShort: true },
+    // L5: just hidden alert
+    { hiddenShort: true },
+    // L6: just the label
+    { hiddenShort: true, omitHidden: true }
+  ];
+  const buildLevel = (level) => {
+    const segs = [labelSeg];
+    if (level.projectsSuffix !== void 0) {
+      segs.push({
+        text: ` ${c.projects.total}${level.projectsSuffix}`,
+        dim: true
+      });
+      if (level.showProjectActive !== false) {
+        segs.push(...activeParen(c.projects.active, "green"));
+      }
+    }
+    if (level.sessionsSuffix !== void 0) {
+      segs.push({
+        text: ` \xB7 ${c.sessions.total}${level.sessionsSuffix}`,
+        dim: true
+      });
+      segs.push(...activeParen(c.sessions.active, "green"));
+    }
+    if (level.subAgentsSuffix !== void 0) {
+      segs.push({
+        text: ` \xB7 ${c.subAgents.total}${level.subAgentsSuffix}`,
+        dim: true
+      });
+      segs.push(...activeParen(c.subAgents.active, "green"));
+    }
+    if (!level.omitHidden) {
+      segs.push(...hiddenSeg(c.hidden, level.hiddenShort ?? false));
+    }
+    return segs;
+  };
+  const candidates = LEVELS.map(buildLevel);
+  for (const cand of candidates) {
+    if (widthOf(cand) <= availableWidth) return cand;
+  }
+  return candidates[candidates.length - 1];
+}
 function SessionTreePanel({
   projects,
   coldProjects,
@@ -3767,7 +4005,8 @@ function SessionTreePanel({
   expandedIds = /* @__PURE__ */ new Set(),
   trackingOn = false,
   spinner = "",
-  scopeLabel
+  scopeLabel,
+  census
 }) {
   const innerWidth = getInnerWidth(width);
   const contentWidth = innerWidth - 1;
@@ -3775,12 +4014,38 @@ function SessionTreePanel({
   const titleText = scopeLabel ? `Projects [${scopeLabel}]` : "Projects";
   const titleLine = createTitleLine(titleText, titleSuffix, width);
   const bottomLine = createBottomLine(width);
+  const censusSegments = census ? (() => {
+    const segs = buildTitleSegments("", census, contentWidth);
+    const withoutLabel = segs[0]?.text === "" ? segs.slice(1) : segs;
+    return withoutLabel.map(
+      (seg, i) => i === 0 ? { ...seg, text: seg.text.replace(/^ /, "") } : seg
+    );
+  })() : null;
+  const censusWidth = censusSegments ? censusSegments.reduce((w, s) => w + getDisplayWidth(s.text), 0) : 0;
+  const censusPadding = censusSegments ? Math.max(0, contentWidth - censusWidth) : 0;
+  const renderCensusRow = () => censusSegments ? /* @__PURE__ */ jsxs4(Text4, { children: [
+    BOX.v,
+    " ",
+    censusSegments.map((seg, i) => /* @__PURE__ */ jsx4(
+      Text4,
+      {
+        color: seg.color,
+        dimColor: seg.dim,
+        bold: seg.bold,
+        children: seg.text
+      },
+      `census-${i}`
+    )),
+    " ".repeat(censusPadding),
+    BOX.v
+  ] }) : null;
   const totalProjectCount = projects.length + coldProjects.length;
   if (totalProjectCount === 0) {
     const emptyText = "No Claude sessions";
     const emptyPadding = Math.max(0, contentWidth - emptyText.length);
     return /* @__PURE__ */ jsxs4(Box4, { flexDirection: "column", width, children: [
       /* @__PURE__ */ jsx4(Text4, { children: titleLine }),
+      renderCensusRow(),
       /* @__PURE__ */ jsxs4(Text4, { children: [
         BOX.v,
         " ",
@@ -3799,10 +4064,14 @@ function SessionTreePanel({
     if (row.kind === "subagent-summary")
       return selectedId === `__sub-${row.parentId}__`;
     if (row.kind === "cold-projects-summary") return selectedId === "__cold__";
+    if (row.kind === "cold-sessions-summary")
+      return selectedId === `__cold-sessions-${row.projectName}__`;
     return false;
   });
-  const needsOverflow = maxRows !== void 0 && totalRows > maxRows;
-  const visibleCount = needsOverflow ? maxRows - 1 : totalRows;
+  const censusRowCost = censusSegments ? 1 : 0;
+  const effectiveMaxRows = maxRows !== void 0 ? Math.max(1, maxRows - censusRowCost) : void 0;
+  const needsOverflow = effectiveMaxRows !== void 0 && totalRows > effectiveMaxRows;
+  const visibleCount = needsOverflow ? effectiveMaxRows - 1 : totalRows;
   let scrollTop = 0;
   if (needsOverflow && selectedFlatIndex >= 0) {
     scrollTop = Math.max(0, selectedFlatIndex - visibleCount + 1);
@@ -3812,6 +4081,7 @@ function SessionTreePanel({
   const hiddenBelow = totalRows - (scrollTop + displayRows.length);
   return /* @__PURE__ */ jsxs4(Box4, { flexDirection: "column", width, children: [
     /* @__PURE__ */ jsx4(Text4, { children: titleLine }),
+    renderCensusRow(),
     displayRows.map(
       (row, idx) => row.kind === "project" ? /* @__PURE__ */ jsx4(
         ProjectRow,
@@ -3842,7 +4112,7 @@ function SessionTreePanel({
           hasFocus
         },
         `subagent-summary-${idx}`
-      ) : /* @__PURE__ */ jsx4(
+      ) : row.kind === "cold-projects-summary" ? /* @__PURE__ */ jsx4(
         ColdProjectsSummaryRow,
         {
           count: row.count,
@@ -3851,6 +4121,16 @@ function SessionTreePanel({
           width
         },
         "cold-summary"
+      ) : /* @__PURE__ */ jsx4(
+        ColdSessionsSummaryRow,
+        {
+          count: row.count,
+          projectName: row.projectName,
+          isSelected: selectedId === `__cold-sessions-${row.projectName}__`,
+          hasFocus,
+          contentWidth
+        },
+        `cold-sessions-${row.projectName}`
       )
     ),
     hiddenBelow > 0 && /* @__PURE__ */ jsxs4(Text4, { children: [
@@ -3904,9 +4184,9 @@ function adjustViewerCursorOnNewActivities(args) {
 // src/ui/App.tsx
 import { Fragment as Fragment4, jsx as jsx5, jsxs as jsxs5 } from "react/jsx-runtime";
 var VIEWER_HEIGHT_FRACTION = 0.55;
-function subSummarySentinel(parentId) {
+function makeSentinel(id) {
   return {
-    id: `__sub-${parentId}__`,
+    id,
     hideKey: "",
     filePath: "",
     projectPath: "",
@@ -3920,6 +4200,8 @@ function subSummarySentinel(parentId) {
     liveState: null
   };
 }
+var subSummarySentinel = (parentId) => makeSentinel(`__sub-${parentId}__`);
+var coldSessionsSummarySentinel = (projectName) => makeSentinel(`__cold-sessions-${projectName}__`);
 function appendSubAgentRows(result, session, expandedIds) {
   const isCold = session.status === "cold";
   const sessionCollapsedKey = `__collapsed-session-${session.id}`;
@@ -3942,6 +4224,66 @@ function appendSubAgentRows(result, session, expandedIds) {
     }
   }
 }
+function filterTreeByHidden(tree) {
+  const visibleSession = (s) => ({
+    ...s,
+    subAgents: s.subAgents.filter((sa) => !sa.hidden)
+  });
+  const visibleProject = (p) => ({
+    ...p,
+    sessions: p.sessions.filter((s) => !s.hidden).map(visibleSession)
+  });
+  return {
+    ...tree,
+    projects: tree.projects.filter((p) => !p.hidden).map(visibleProject),
+    coldProjects: tree.coldProjects.filter((p) => !p.hidden).map(visibleProject)
+  };
+}
+function computeCensus(tree) {
+  let projectsTotal = 0;
+  let projectsActive = 0;
+  let sessionsTotal = 0;
+  let sessionsActive = 0;
+  let subAgentsTotal = 0;
+  let subAgentsActive = 0;
+  let hiddenTotal = 0;
+  let hiddenActive = 0;
+  const isActive = (n) => n.status === "hot" || n.status === "warm";
+  for (const p of [...tree.projects, ...tree.coldProjects]) {
+    projectsTotal++;
+    let projectHasVisibleActive = false;
+    for (const s of p.sessions) {
+      sessionsTotal++;
+      const sessionVisible = !s.hidden && !p.hidden;
+      if (sessionVisible) {
+        if (isActive(s)) {
+          sessionsActive++;
+          projectHasVisibleActive = true;
+        }
+      } else {
+        hiddenTotal++;
+        if (isActive(s)) hiddenActive++;
+      }
+      for (const sa of s.subAgents) {
+        subAgentsTotal++;
+        const saVisible = !sa.hidden && !s.hidden && !p.hidden;
+        if (saVisible) {
+          if (isActive(sa)) subAgentsActive++;
+        } else {
+          hiddenTotal++;
+          if (isActive(sa)) hiddenActive++;
+        }
+      }
+    }
+    if (projectHasVisibleActive) projectsActive++;
+  }
+  return {
+    projects: { total: projectsTotal, active: projectsActive },
+    sessions: { total: sessionsTotal, active: sessionsActive },
+    subAgents: { total: subAgentsTotal, active: subAgentsActive },
+    hidden: { total: hiddenTotal, active: hiddenActive }
+  };
+}
 function flattenSessions2(tree, expandedIds) {
   const result = [];
   const projectToFlat = (project, isCold) => {
@@ -3962,9 +4304,32 @@ function flattenSessions2(tree, expandedIds) {
     });
     const shouldShowSessions = isCold ? expandedIds.has(`__expanded-${sentinelId}`) : !expandedIds.has(`__collapsed-${sentinelId}`);
     if (shouldShowSessions) {
-      for (const session of project.sessions) {
-        result.push(session);
-        appendSubAgentRows(result, session, expandedIds);
+      if (isCold) {
+        for (const session of project.sessions) {
+          result.push(session);
+          appendSubAgentRows(result, session, expandedIds);
+        }
+      } else {
+        const activeSessions = project.sessions.filter(
+          (s) => s.status !== "cold"
+        );
+        const coldSessions = project.sessions.filter(
+          (s) => s.status === "cold"
+        );
+        for (const session of activeSessions) {
+          result.push(session);
+          appendSubAgentRows(result, session, expandedIds);
+        }
+        if (coldSessions.length > 0) {
+          const coldKey = `__cold-sessions-${project.name}__`;
+          result.push(coldSessionsSummarySentinel(project.name));
+          if (expandedIds.has(coldKey)) {
+            for (const session of coldSessions) {
+              result.push(session);
+              appendSubAgentRows(result, session, expandedIds);
+            }
+          }
+        }
       }
     }
   };
@@ -4127,9 +4492,15 @@ function App({
   const helpTotalLinesRef = useRef(0);
   const [tracking, setTracking] = useState3(false);
   const seenIdsRef = useRef(/* @__PURE__ */ new Set());
+  const [showHidden, setShowHidden] = useState3(false);
+  const displayTree = useMemo(
+    () => showHidden ? sessionTree : filterTreeByHidden(sessionTree),
+    [sessionTree, showHidden]
+  );
+  const census = useMemo(() => computeCensus(sessionTree), [sessionTree]);
   const allFlat = useMemo(
-    () => flattenSessions2(sessionTree, expandedIds),
-    [sessionTree, expandedIds]
+    () => flattenSessions2(displayTree, expandedIds),
+    [displayTree, expandedIds]
   );
   const allFlatRef = useRef(allFlat);
   useEffect3(() => {
@@ -4210,11 +4581,12 @@ function App({
   const refresh = useCallback(() => {
     const freshConfig = loadGlobalConfig();
     const tree = discoverSessions(freshConfig, discoverOptions);
-    const updatedFlat = flattenSessions2(tree, expandedIds);
+    const trackingTree = showHidden ? tree : filterTreeByHidden(tree);
+    const updatedFlat = flattenSessions2(trackingTree, expandedIds);
     let nextSelected = selectedId;
     if (tracking) {
       const { target, ids } = pickTrackingTarget(
-        tree,
+        trackingTree,
         selectedId,
         seenIdsRef.current
       );
@@ -4236,7 +4608,7 @@ function App({
     if (!node || !node.filePath) return;
     const newActivities = parseSessionHistory(node.filePath);
     setActivities(newActivities);
-  }, [selectedId, expandedIds, tracking, discoverOptions]);
+  }, [selectedId, expandedIds, tracking, discoverOptions, showHidden]);
   const refreshRef = useRef(refresh);
   useEffect3(() => {
     refreshRef.current = refresh;
@@ -4354,9 +4726,9 @@ function App({
       setTracking((on) => {
         const next = !on;
         if (next) {
-          seenIdsRef.current = collectAllIds(sessionTree);
+          seenIdsRef.current = collectAllIds(displayTree);
           const { target } = pickTrackingTarget(
-            sessionTree,
+            displayTree,
             selectedId,
             seenIdsRef.current
           );
@@ -4370,7 +4742,7 @@ function App({
       if (focus !== "tree") return;
       stopTracking();
       if (!selectedId) return;
-      const target = findParentTarget(selectedId, sessionTree, allFlat);
+      const target = findParentTarget(selectedId, displayTree, allFlat);
       if (target && target !== selectedId) setSelectedId(target);
     },
     onSwitchFocus: () => setFocus((f) => f === "tree" ? "viewer" : "tree"),
@@ -4389,10 +4761,7 @@ function App({
         } else {
           setIsLive(false);
           setScrollOffset(
-            (o) => Math.min(
-              o + 1,
-              Math.max(0, mergedActivities.length - viewerRows)
-            )
+            (o) => Math.min(o + 1, Math.max(0, mergedActivities.length - viewerRows))
           );
         }
       }
@@ -4544,7 +4913,7 @@ function App({
       stopTracking();
       if (selectedId.startsWith("__proj-") && selectedId.endsWith("__")) {
         const projectName = selectedId.slice(7, -2);
-        const isCold = sessionTree.coldProjects.some(
+        const isCold = displayTree.coldProjects.some(
           (p) => p.name === projectName
         );
         const toggleKey = isCold ? `__expanded-${selectedId}` : `__collapsed-${selectedId}`;
@@ -4571,6 +4940,15 @@ function App({
         });
         return;
       }
+      if (selectedId.startsWith("__cold-sessions-") && selectedId.endsWith("__")) {
+        setExpandedIds((prev) => {
+          const next = new Set(prev);
+          if (next.has(selectedId)) next.delete(selectedId);
+          else next.add(selectedId);
+          return next;
+        });
+        return;
+      }
       if (selectedId.startsWith("__sub-") && selectedId.endsWith("__")) {
         const parentId = selectedId.slice(6, -2);
         setExpandedIds((prev) => {
@@ -4580,7 +4958,10 @@ function App({
             setSelectedId(parentId);
           } else {
             next.add(parentId);
-            const allSessions2 = sessionTree.projects?.flatMap((p) => p.sessions) ?? [];
+            const allSessions2 = [
+              ...displayTree.projects.flatMap((p) => p.sessions),
+              ...displayTree.coldProjects.flatMap((p) => p.sessions)
+            ];
             const parent = allSessions2.find((s) => s.id === parentId);
             const firstNew = parent?.subAgents.find(
               (sa) => sa.status === "cool" || sa.status === "cold"
@@ -4592,8 +4973,8 @@ function App({
         return;
       }
       const allSessions3 = [
-        ...sessionTree.projects.flatMap((p) => p.sessions),
-        ...sessionTree.coldProjects.flatMap((p) => p.sessions)
+        ...displayTree.projects.flatMap((p) => p.sessions),
+        ...displayTree.coldProjects.flatMap((p) => p.sessions)
       ];
       const selectedSessionObj = allSessions3.find((s) => s.id === selectedId);
       if (selectedSessionObj && selectedSessionObj.subAgents.length > 0) {
@@ -4627,42 +5008,60 @@ function App({
     onHide: () => {
       if (focus !== "tree" || !selectedId) return;
       stopTracking();
+      const nextAfterHide = () => allFlat[selectedIndex + 1]?.id ?? allFlat[selectedIndex - 1]?.id ?? null;
+      const applyHideToggle = (params) => {
+        if (params.isHidden) {
+          params.unhide();
+          refresh();
+          return;
+        }
+        params.hide();
+        refresh();
+        if (!showHidden) setSelectedId(nextAfterHide());
+      };
       if (selectedId.startsWith("__proj-") && selectedId.endsWith("__")) {
         const projectName = selectedId.slice(7, -2);
-        hideProject(projectName);
-        refresh();
-        const nextId = allFlat[selectedIndex + 1]?.id ?? allFlat[selectedIndex - 1]?.id ?? null;
-        setSelectedId(nextId);
+        const proj = sessionTree.projects.find((p) => p.name === projectName) ?? sessionTree.coldProjects.find((p) => p.name === projectName);
+        applyHideToggle({
+          isHidden: !!proj?.hidden,
+          hide: () => hideProject(projectName),
+          unhide: () => unhideProject(projectName)
+        });
         return;
       }
       if (selectedId === "__cold__") {
         const coldSessions = sessionTree.coldProjects?.flatMap((p) => p.sessions) ?? [];
         for (const s of coldSessions) hideSession(s.hideKey);
-        const nextId = allFlat[selectedIndex - 1]?.id ?? null;
         refresh();
-        setSelectedId(nextId);
+        setSelectedId(nextAfterHide());
         return;
       }
-      const allSessions4 = sessionTree.projects?.flatMap((p) => p.sessions) ?? [];
-      const selectedSession2 = allSessions4.find((s) => s.id === selectedId);
+      const allSessionsFull = [
+        ...sessionTree.projects.flatMap((p) => p.sessions),
+        ...sessionTree.coldProjects.flatMap((p) => p.sessions)
+      ];
+      const selectedSession2 = allSessionsFull.find((s) => s.id === selectedId);
       if (selectedSession2) {
-        hideSession(selectedSession2.hideKey);
-        const nextId = allFlat[selectedIndex + 1]?.id ?? allFlat[selectedIndex - 1]?.id ?? null;
-        refresh();
-        setSelectedId(nextId);
+        applyHideToggle({
+          isHidden: !!selectedSession2.hidden,
+          hide: () => hideSession(selectedSession2.hideKey),
+          unhide: () => unhideSession(selectedSession2.hideKey)
+        });
         return;
       }
-      for (const s of allSessions4) {
-        const selectedSubAgent = s.subAgents.find((sa) => sa.id === selectedId);
-        if (selectedSubAgent) {
-          hideSubAgent(selectedSubAgent.hideKey);
-          const nextId = allFlat[selectedIndex + 1]?.id ?? allFlat[selectedIndex - 1]?.id ?? null;
-          refresh();
-          setSelectedId(nextId);
+      for (const s of allSessionsFull) {
+        const sa = s.subAgents.find((x) => x.id === selectedId);
+        if (sa) {
+          applyHideToggle({
+            isHidden: !!sa.hidden,
+            hide: () => hideSubAgent(sa.hideKey),
+            unhide: () => unhideSubAgent(sa.hideKey)
+          });
           return;
         }
       }
     },
+    onToggleShowHidden: () => setShowHidden((on) => !on),
     onRefresh: refresh,
     onQuit: exit,
     onFilter: () => setFilterIndex((i) => (i + 1) % filterPresets.length),
@@ -4674,7 +5073,7 @@ function App({
   let selectedSession = rawSelected;
   if (isProjectSentinel && selectedId) {
     const projectName = selectedId.slice(7, -2);
-    const project = sessionTree.projects.find((p) => p.name === projectName) ?? sessionTree.coldProjects.find((p) => p.name === projectName);
+    const project = displayTree.projects.find((p) => p.name === projectName) ?? displayTree.coldProjects.find((p) => p.name === projectName);
     if (project && project.sessions.length > 0) {
       selectedSession = project.sessions[0];
     }
@@ -4732,8 +5131,8 @@ function App({
       /* @__PURE__ */ jsx5(
         SessionTreePanel,
         {
-          projects: sessionTree.projects ?? [],
-          coldProjects: sessionTree.coldProjects ?? [],
+          projects: displayTree.projects ?? [],
+          coldProjects: displayTree.coldProjects ?? [],
           selectedId,
           hasFocus: focus === "tree",
           width,
@@ -4741,7 +5140,8 @@ function App({
           expandedIds,
           trackingOn: tracking,
           spinner,
-          scopeLabel: scopeToProject2 ? basename3(scopeToProject2) : void 0
+          scopeLabel: scopeToProject2 ? basename3(scopeToProject2) : void 0,
+          census: isWatchMode ? census : void 0
         }
       ),
       /* @__PURE__ */ jsx5(Box5, { marginTop: 1, children: detailMode && detailActivity ? /* @__PURE__ */ jsx5(

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "agenthud",
-  "version": "0.13.3",
+  "version": "0.14.0",
   "description": "Claude Code TUI dashboard: live monitor for parallel sessions and sub-agents, with LLM-generated daily/weekly digest",
   "type": "module",
   "main": "dist/index.js",