agenthud 0.9.4 → 0.11.0

package/dist/{main-26QL33AJ.js → main-KTFHI6KH.js}

@@ -1,24 +1,14 @@
 // src/main.ts
-import { existsSync as existsSync6, rmSync } from "fs";
+import { existsSync as existsSync6, readdirSync as readdirSync2, realpathSync, rmSync } from "fs";
 import { homedir as homedir5 } from "os";
 import { join as join6 } from "path";
 import { createInterface as createInterface2 } from "readline";
-
-// src/utils/legacyConfig.ts
-import { join, resolve } from "path";
-function isLegacyProjectConfig(cwd, home) {
-  const legacy = resolve(join(cwd, ".agenthud", "config.yaml"));
-  const global = resolve(join(home, ".agenthud", "config.yaml"));
-  return legacy !== global;
-}
-
-// src/main.ts
 import { render } from "ink";
 import React from "react";
 
 // src/cli.ts
 import { readFileSync } from "fs";
-import { dirname, join as join2 } from "path";
+import { dirname, join } from "path";
 import { fileURLToPath } from "url";
 var ALL_TYPES = [
   "response",
@@ -37,7 +27,8 @@ var KNOWN_WATCH_FLAGS = /* @__PURE__ */ new Set([
   "-V",
   "--version",
   "-h",
-  "--help"
+  "--help",
+  "--cwd"
 ]);
 var KNOWN_REPORT_FLAGS = /* @__PURE__ */ new Set([
   "--date",
@@ -66,6 +57,9 @@ Monitors all running Claude Code sessions in real-time.
 Options:
   -w, --watch                   Watch mode (default) \u2014 live updates
   --once                        Print once and exit
+  --cwd                         Scope the view to the Claude project
+                                containing the current directory.
+                                Exits 1 if no such project is found.
   -V, --version                 Show version number
   -h, --help                    Show this help message
 
@@ -103,7 +97,7 @@ Config: ~/.agenthud/config.yaml
 function getVersion() {
   const __dirname2 = dirname(fileURLToPath(import.meta.url));
   const packageJson = JSON.parse(
-    readFileSync(join2(__dirname2, "..", "package.json"), "utf-8")
+    readFileSync(join(__dirname2, "..", "package.json"), "utf-8")
   );
   return packageJson.version;
 }
@@ -144,7 +138,7 @@ function parseArgs(args) {
     return { mode: "watch", command: "version" };
   }
   if (args.includes("--once")) {
-    return { mode: "once" };
+    return args.includes("--cwd") ? { mode: "once", scopeToCwd: true } : { mode: "once" };
   }
   if (args[0] === "report") {
     const rest = args.slice(1);
@@ -367,54 +361,16 @@ function parseArgs(args) {
       };
     }
   }
-  return { mode: "watch" };
-}
-
-// src/utils/altScreen.ts
-var ENTER = "\x1B[?1049h";
-var LEAVE = "\x1B[?1049l";
-var entered = false;
-var left = false;
-function enterAltScreen() {
-  if (entered) return;
-  entered = true;
-  process.stdout.write(ENTER);
-}
-function leaveAltScreen() {
-  if (left || !entered) return;
-  left = true;
-  process.stdout.write(LEAVE);
-}
-var hooksInstalled = false;
-function installAltScreenCleanup() {
-  if (hooksInstalled) return;
-  hooksInstalled = true;
-  process.on("exit", () => {
-    leaveAltScreen();
-  });
-  process.on("SIGINT", () => {
-    leaveAltScreen();
-    process.exit(130);
-  });
-  process.on("SIGTERM", () => {
-    leaveAltScreen();
-    process.exit(143);
-  });
-  process.on("uncaughtException", (err) => {
-    leaveAltScreen();
-    setImmediate(() => {
-      throw err;
-    });
-  });
+  return args.includes("--cwd") ? { mode: "watch", scopeToCwd: true } : { mode: "watch" };
 }
 
 // src/config/globalConfig.ts
 import { existsSync, mkdirSync, readFileSync as readFileSync2, writeFileSync } from "fs";
 import { homedir } from "os";
-import { join as join3 } from "path";
+import { join as join2 } from "path";
 import { parse as parseYaml, stringify as stringifyYaml } from "yaml";
-var CONFIG_PATH = join3(homedir(), ".agenthud", "config.yaml");
-var STATE_PATH = join3(homedir(), ".agenthud", "state.yaml");
+var CONFIG_PATH = join2(homedir(), ".agenthud", "config.yaml");
+var STATE_PATH = join2(homedir(), ".agenthud", "state.yaml");
 var DEFAULT_GLOBAL_CONFIG = {
   refreshIntervalMs: 2e3,
   hiddenSessions: [],
@@ -436,7 +392,7 @@ function parseInterval(value) {
   return match[2] === "m" ? n * 60 * 1e3 : n * 1e3;
 }
 function ensureAgenthudDir() {
-  const dir = join3(homedir(), ".agenthud");
+  const dir = join2(homedir(), ".agenthud");
   if (!existsSync(dir)) mkdirSync(dir, { recursive: true });
 }
 function writeDefaultConfig() {
@@ -604,8 +560,8 @@ function hideProject(name) {
   updateState({ hiddenProjects: [...config.hiddenProjects, name] });
 }
 function hasProjectLevelConfig() {
-  const candidate = join3(process.cwd(), ".agenthud", "config.yaml");
-  if (candidate === join3(homedir(), ".agenthud", "config.yaml")) return false;
+  const candidate = join2(process.cwd(), ".agenthud", "config.yaml");
+  if (candidate === join2(homedir(), ".agenthud", "config.yaml")) return false;
   return existsSync(candidate);
 }
 
@@ -643,7 +599,7 @@ function getCommitDetail(projectPath, hash) {
   if (!projectPath) return null;
   try {
     return execSync(
-      `git --git-dir="${projectPath}/.git" show --stat --patch --no-color ${hash}`,
+      `git -C "${projectPath}" show --stat --patch --no-color ${hash}`,
       { encoding: "utf-8", stdio: ["ignore", "pipe", "ignore"] }
     ).trim();
   } catch {
@@ -657,7 +613,7 @@ function parseGitCommits(projectPath, startDate, endDate) {
   let raw;
   try {
     raw = execSync(
-      `git --git-dir="${projectPath}/.git" log --format="%ct|%h|%s" --after="${start} 00:00:00" --before="${end} 23:59:59"`,
+      `git -C "${projectPath}" log --format="%ct|%h|%s" --after="${start} 00:00:00" --before="${end} 23:59:59"`,
       { encoding: "utf-8", stdio: ["ignore", "pipe", "ignore"] }
     ).trim();
   } catch {
@@ -685,20 +641,11 @@ function parseGitCommits(projectPath, startDate, endDate) {
 // src/data/sessionHistory.ts
 import { existsSync as existsSync2, readFileSync as readFileSync3 } from "fs";
 
-// src/data/activityParser.ts
+// src/data/toolDetails.ts
 import { basename } from "path";
 function stripAnsi(text) {
   return text.replace(/\x1b\[[0-9;]*m/g, "");
 }
-function parseModelName(modelId) {
-  const opusMatch = modelId.match(/claude-opus-(\d+)-(\d+)/);
-  if (opusMatch) return `opus-${opusMatch[1]}.${opusMatch[2]}`;
-  const sonnetMatch = modelId.match(/claude-sonnet-(\d+)/);
-  if (sonnetMatch) return `sonnet-${sonnetMatch[1]}`;
-  const haikuMatch = modelId.match(/claude-(\d+)-(\d+)-haiku/);
-  if (haikuMatch) return `haiku-${haikuMatch[1]}.${haikuMatch[2]}`;
-  return modelId.replace(/-\d{8}$/, "");
-}
 function getToolDetail(_toolName, input) {
   if (!input) return "";
   if (input.command) return stripAnsi(input.command);
@@ -708,11 +655,141 @@ function getToolDetail(_toolName, input) {
   if (input.description) return stripAnsi(input.description);
   return "";
 }
+function rangeStr(start, lines) {
+  return `L${start}-${start + Math.max(lines, 1) - 1}`;
+}
+function patchSpan(hunks) {
+  if (hunks.length === 0) return null;
+  const start = Math.min(...hunks.map((h) => h.newStart));
+  const end = Math.max(
+    ...hunks.map((h) => h.newStart + Math.max(h.newLines, 1) - 1)
+  );
+  return `L${start}-${end}`;
+}
+function countChanges(hunks) {
+  let add = 0;
+  let del = 0;
+  for (const h of hunks) {
+    for (const line of h.lines ?? []) {
+      if (line.startsWith("+")) add++;
+      else if (line.startsWith("-")) del++;
+    }
+  }
+  const parts = [];
+  if (add > 0) parts.push(`+${add}`);
+  if (del > 0) parts.push(`-${del}`);
+  return parts.join(" ");
+}
+function joinParts(...parts) {
+  return parts.filter((p) => !!p).join(" ");
+}
+function summarizeToolDetail(name, input, result) {
+  const file = input?.file_path ? basename(input.file_path) : "";
+  if (name === "Edit" || name === "Write") {
+    const hunks = result?.structuredPatch;
+    if (hunks && hunks.length > 0) {
+      return joinParts(file, patchSpan(hunks), countChanges(hunks));
+    }
+    if (name === "Write") {
+      const content = result?.content ?? input?.content;
+      if (content) {
+        const n = content.split("\n").length - (content.endsWith("\n") ? 1 : 0);
+        return joinParts(file, rangeStr(1, n), `+${n}`);
+      }
+    }
+    return file;
+  }
+  if (name === "Read") {
+    const f = result?.file;
+    if (typeof f?.startLine === "number" && typeof f?.numLines === "number") {
+      return joinParts(file, rangeStr(f.startLine, f.numLines));
+    }
+    if (typeof input?.offset === "number" && typeof input?.limit === "number") {
+      return joinParts(file, rangeStr(input.offset, input.limit));
+    }
+    return file;
+  }
+  if (name === "TaskUpdate") {
+    const id = input?.taskId ?? result?.taskId;
+    const idStr = id ? `#${id}` : "";
+    const sc = result?.statusChange;
+    if (sc?.from && sc?.to) return joinParts(idStr, `${sc.from}\u2192${sc.to}`);
+    if (result?.updatedFields?.length) {
+      return joinParts(idStr, result.updatedFields.join(", "));
+    }
+    if (input?.status) return joinParts(idStr, input.status);
+    return idStr;
+  }
+  if (name === "TaskCreate") {
+    return input?.subject ?? "";
+  }
+  return getToolDetail(name, input);
+}
+function numberLines(content, start) {
+  const lines = content.split("\n");
+  if (lines.length > 1 && lines[lines.length - 1] === "") lines.pop();
+  const width = String(start + lines.length - 1).length;
+  return lines.map((line, i) => `${String(start + i).padStart(width)}: ${line}`).join("\n");
+}
+function buildToolDetailBody(name, input, result) {
+  if (name === "Write") {
+    const content = result?.content ?? input?.content;
+    if (content) return { text: content, kind: "code" };
+  }
+  if (name === "Read") {
+    const content = result?.file?.content;
+    if (content) {
+      const start = result?.file?.startLine ?? input?.offset ?? 1;
+      return { text: numberLines(content, start), kind: "code", numbered: true };
+    }
+  }
+  if (name === "Edit" || name === "Write") {
+    const hunks = result?.structuredPatch;
+    if (hunks && hunks.length > 0) {
+      const text = hunks.map(
+        (h) => `@@ -${h.oldStart},${h.oldLines} +${h.newStart},${h.newLines} @@
+${(h.lines ?? []).join("\n")}`
+      ).join("\n");
+      return { text, kind: "diff" };
+    }
+  }
+  return null;
+}
+
+// src/data/activityParser.ts
+function parseModelName(modelId) {
+  const opusMatch = modelId.match(/claude-opus-(\d+)-(\d+)/);
+  if (opusMatch) return `opus-${opusMatch[1]}.${opusMatch[2]}`;
+  const sonnetMatch = modelId.match(/claude-sonnet-(\d+)/);
+  if (sonnetMatch) return `sonnet-${sonnetMatch[1]}`;
+  const haikuMatch = modelId.match(/claude-(\d+)-(\d+)-haiku/);
+  if (haikuMatch) return `haiku-${haikuMatch[1]}.${haikuMatch[2]}`;
+  return modelId.replace(/-\d{8}$/, "");
+}
 function parseActivitiesFromLines(lines) {
   const activities = [];
   let tokenCount = 0;
   let modelName = null;
   let sessionStartTime = null;
+  const resultsById = /* @__PURE__ */ new Map();
+  for (const line of lines) {
+    let entry;
+    try {
+      entry = JSON.parse(line);
+    } catch {
+      continue;
+    }
+    if (entry.type !== "user") continue;
+    const tur = entry.toolUseResult;
+    if (!tur || typeof tur !== "object") continue;
+    const content = entry.message?.content;
+    if (!Array.isArray(content)) continue;
+    for (const b of content) {
+      if (b?.type === "tool_result" && typeof b.tool_use_id === "string") {
+        resultsById.set(b.tool_use_id, tur);
+      }
+    }
+  }
   for (const line of lines) {
     let entry;
     try {
@@ -767,19 +844,27 @@ function parseActivitiesFromLines(lines) {
           } else if (block.type === "tool_use" && block.name) {
             if (block.name === "TodoWrite") continue;
             const icon = ICONS[block.name] ?? ICONS.Default;
-            const detail = getToolDetail(block.name, block.input);
+            const result = block.id ? resultsById.get(block.id) : void 0;
+            const detail = summarizeToolDetail(block.name, block.input, result);
+            const body = buildToolDetailBody(block.name, block.input, result);
             const last = activities[activities.length - 1];
             if (last && last.type === "tool" && last.label === block.name && last.detail === detail) {
               last.count = (last.count ?? 1) + 1;
               last.timestamp = timestamp;
             } else {
-              activities.push({
+              const entry2 = {
                 timestamp,
                 type: "tool",
                 icon,
                 label: block.name,
                 detail
-              });
+              };
+              if (body) {
+                entry2.detailBody = body.text;
+                entry2.detailKind = body.kind;
+                if (body.numbered) entry2.detailNumbered = true;
+              }
+              activities.push(entry2);
             }
           } else if (block.type === "text" && block.text && block.text.length > 10) {
             activities.push({
@@ -947,25 +1032,10 @@ function generateReport(sessions, options2) {
   return lines.join("\n").trimEnd();
 }
 
-// src/data/summaryRunner.ts
-import { spawn } from "child_process";
-import {
-  copyFileSync,
-  createWriteStream,
-  existsSync as existsSync4,
-  mkdirSync as mkdirSync2,
-  readFileSync as readFileSync5,
-  unlinkSync
-} from "fs";
-import { homedir as homedir3 } from "os";
-import { dirname as dirname2, join as join5 } from "path";
-import { createInterface } from "readline";
-import { fileURLToPath as fileURLToPath2 } from "url";
-
 // src/data/sessions.ts
 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 join4 } from "path";
+import { basename as basename2, join as join3 } from "path";
 
 // src/ui/constants.ts
 import stringWidth from "string-width";
@@ -1026,9 +1096,36 @@ function getDisplayWidth(s) {
   return w;
 }
 
+// src/data/sessionLiveness.ts
+function detectLiveState(tailLines, mtimeMs, now) {
+  if (now - mtimeMs > THIRTY_MINUTES_MS) return null;
+  for (let i = tailLines.length - 1; i >= 0; i--) {
+    const line = tailLines[i];
+    if (!line || !line.trim()) continue;
+    let entry;
+    try {
+      entry = JSON.parse(line);
+    } catch {
+      continue;
+    }
+    if (entry.type === "assistant") {
+      const content = entry.message?.content;
+      const blocks = Array.isArray(content) ? content : [];
+      const toolUses = blocks.filter((b) => b && b.type === "tool_use");
+      if (toolUses.length === 0) return "waiting";
+      if (toolUses.some((b) => b.name === "AskUserQuestion")) return "waiting";
+      return "working";
+    }
+    if (entry.type === "user") {
+      return "working";
+    }
+  }
+  return null;
+}
+
 // src/data/sessions.ts
 function getProjectsDir() {
-  return process.env.CLAUDE_PROJECTS_DIR ?? join4(homedir2(), ".claude", "projects");
+  return process.env.CLAUDE_PROJECTS_DIR ?? join3(homedir2(), ".claude", "projects");
 }
 function decodeProjectPath(encoded) {
   const windowsDriveMatch = encoded.match(/^([A-Za-z])--(.*)$/);
@@ -1079,23 +1176,26 @@ function readSubAgentInfo(filePath) {
     return { agentId: null, taskDescription: null };
   }
 }
-function readModelName(filePath) {
-  if (!existsSync3(filePath)) return null;
+function readSessionTail(filePath, mtimeMs, now) {
+  if (!existsSync3(filePath)) return { modelName: null, liveState: null };
   try {
     const content = readFileSync4(filePath, "utf-8");
-    const lines = content.trim().split("\n").filter(Boolean);
-    for (const line of lines.slice(-50).reverse()) {
+    const tail = content.trim().split("\n").filter(Boolean).slice(-50);
+    let modelName = null;
+    for (const line of [...tail].reverse()) {
       try {
         const entry = JSON.parse(line);
         if (entry.type === "assistant" && entry.message?.model) {
-          return parseModelName(entry.message.model);
+          modelName = parseModelName(entry.message.model);
+          break;
         }
       } catch {
       }
     }
+    return { modelName, liveState: detectLiveState(tail, mtimeMs, now) };
   } catch {
+    return { modelName: null, liveState: null };
   }
-  return null;
 }
 var SYSTEM_PREFIXES = [
   "<command-name>",
@@ -1162,7 +1262,7 @@ function readEntrypoint(filePath) {
   }
 }
 function buildSubAgents(parentId, projectDir, config, projectName) {
-  const subagentsDir = join4(projectDir, parentId, "subagents");
+  const subagentsDir = join3(projectDir, parentId, "subagents");
   if (!existsSync3(subagentsDir)) return [];
   let files;
   try {
@@ -1175,10 +1275,15 @@ function buildSubAgents(parentId, projectDir, config, projectName) {
   return files.map((file) => {
     const id = file.replace(/\.jsonl$/, "");
     const hideKey = `${projectName}/${id}`;
-    const filePath = join4(subagentsDir, file);
+    const filePath = join3(subagentsDir, file);
     try {
       const stat = statSync2(filePath);
       const { agentId, taskDescription } = readSubAgentInfo(filePath);
+      const { modelName, liveState } = readSessionTail(
+        filePath,
+        stat.mtimeMs,
+        Date.now()
+      );
       return {
         id,
         hideKey,
@@ -1187,12 +1292,13 @@ function buildSubAgents(parentId, projectDir, config, projectName) {
         projectName: "",
         lastModifiedMs: stat.mtimeMs,
         status: getSessionStatus(stat.mtimeMs),
-        modelName: readModelName(filePath),
+        modelName,
         subAgents: [],
         agentId: agentId ?? void 0,
         taskDescription: taskDescription ?? void 0,
         nonInteractive: false,
-        firstUserPrompt: null
+        firstUserPrompt: null,
+        liveState
       };
     } catch {
       return null;
@@ -1201,7 +1307,36 @@ function buildSubAgents(parentId, projectDir, config, projectName) {
     (n) => n !== null && !config.hiddenSubAgents.includes(n.hideKey)
   ).sort((a, b) => b.lastModifiedMs - a.lastModifiedMs);
 }
-function discoverSessions(config) {
+function findContainingProject(cwd, projectPaths, options2) {
+  const resolve2 = options2?.realpath ?? ((p) => p);
+  const cwdR = resolve2(cwd);
+  let best = null;
+  let bestLen = -1;
+  for (const raw of projectPaths) {
+    let pR;
+    try {
+      pR = resolve2(raw);
+    } catch {
+      continue;
+    }
+    if (cwdR === pR) {
+      if (pR.length > bestLen) {
+        best = raw;
+        bestLen = pR.length;
+      }
+      continue;
+    }
+    const boundary = cwdR[pR.length];
+    if ((boundary === "/" || boundary === "\\") && cwdR.startsWith(pR)) {
+      if (pR.length > bestLen) {
+        best = raw;
+        bestLen = pR.length;
+      }
+    }
+  }
+  return best;
+}
+function discoverSessions(config, options2) {
   const projectsDir = getProjectsDir();
   if (!existsSync3(projectsDir)) {
     return {
@@ -1215,7 +1350,7 @@ function discoverSessions(config) {
   try {
     projectDirs = readdirSync(projectsDir).filter((entry) => {
       try {
-        return statSync2(join4(projectsDir, entry)).isDirectory();
+        return statSync2(join3(projectsDir, entry)).isDirectory();
       } catch {
         return false;
       }
@@ -1229,9 +1364,11 @@ function discoverSessions(config) {
     };
   }
   const allSessions = [];
+  const scope = options2?.scopeToProject ?? null;
   for (const encodedDir of projectDirs) {
-    const projectDir = join4(projectsDir, encodedDir);
+    const projectDir = join3(projectsDir, encodedDir);
     const decodedPath = decodeProjectPath(encodedDir);
+    if (scope !== null && decodedPath !== scope) continue;
     const projectName = basename2(decodedPath);
     let files;
     try {
@@ -1244,10 +1381,16 @@ function discoverSessions(config) {
     for (const file of files) {
       const id = file.replace(/\.jsonl$/, "");
       const hideKey = `${projectName}/${id}`;
-      const filePath = join4(projectDir, file);
+      const filePath = join3(projectDir, file);
       try {
         const stat = statSync2(filePath);
         const subAgents = buildSubAgents(id, projectDir, config, projectName);
+        const nonInteractive = readEntrypoint(filePath) === "sdk-cli";
+        const { modelName, liveState } = readSessionTail(
+          filePath,
+          stat.mtimeMs,
+          Date.now()
+        );
         allSessions.push({
           id,
           hideKey,
@@ -1256,10 +1399,11 @@ function discoverSessions(config) {
           projectName,
           lastModifiedMs: stat.mtimeMs,
           status: getSessionStatus(stat.mtimeMs),
-          modelName: readModelName(filePath),
+          modelName,
           subAgents,
-          nonInteractive: readEntrypoint(filePath) === "sdk-cli",
-          firstUserPrompt: readFirstUserPrompt(filePath)
+          nonInteractive,
+          firstUserPrompt: readFirstUserPrompt(filePath),
+          liveState: nonInteractive ? null : liveState
         });
       } catch {
       }
@@ -1315,13 +1459,26 @@ function discoverSessions(config) {
 }
 
 // src/data/summaryRunner.ts
+import { spawn } from "child_process";
+import {
+  copyFileSync,
+  createWriteStream,
+  existsSync as existsSync4,
+  mkdirSync as mkdirSync2,
+  readFileSync as readFileSync5,
+  unlinkSync
+} from "fs";
+import { homedir as homedir3 } from "os";
+import { dirname as dirname2, join as join4 } from "path";
+import { createInterface } from "readline";
+import { fileURLToPath as fileURLToPath2 } from "url";
 function agenthudHomeDir() {
-  const dir = join5(homedir3(), ".agenthud");
+  const dir = join4(homedir3(), ".agenthud");
   if (!existsSync4(dir)) mkdirSync2(dir, { recursive: true });
   return dir;
 }
 function summariesDir() {
-  const dir = join5(agenthudHomeDir(), "summaries");
+  const dir = join4(agenthudHomeDir(), "summaries");
   if (!existsSync4(dir)) mkdirSync2(dir, { recursive: true });
   return dir;
 }
@@ -1329,20 +1486,20 @@ function promptFilename(kind) {
   return kind === "daily" ? "summary-prompt.md" : "summary-range-prompt.md";
 }
 function userPromptPath(kind) {
-  return join5(homedir3(), ".agenthud", promptFilename(kind));
+  return join4(homedir3(), ".agenthud", promptFilename(kind));
 }
 function templatePath(kind) {
   const here = dirname2(fileURLToPath2(import.meta.url));
-  return join5(here, "templates", promptFilename(kind));
+  return join4(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 join4(summariesDir(), `${dateKey(date)}.md`);
 }
 function rangeCachePath(from, to) {
-  return join5(summariesDir(), `range-${dateKey(from)}_${dateKey(to)}.md`);
+  return join4(summariesDir(), `range-${dateKey(from)}_${dateKey(to)}.md`);
 }
 function isSameLocalDay2(a, b) {
   return a.getFullYear() === b.getFullYear() && a.getMonth() === b.getMonth() && a.getDate() === b.getDate();
@@ -1801,12 +1958,39 @@ agenthud: combining ${dailyMarkdowns.length} daily summaries into range summary.
 
 // src/ui/App.tsx
 import { existsSync as existsSync5, 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";
 
 // src/ui/ActivityViewerPanel.tsx
 import { Box, Text } from "ink";
-import { jsx, jsxs } from "react/jsx-runtime";
+import { memo } from "react";
+import { Fragment, jsx, jsxs } from "react/jsx-runtime";
+function brighten(color) {
+  switch (color) {
+    case void 0:
+    case "gray":
+      return "white";
+    case "white":
+      return "whiteBright";
+    case "green":
+      return "greenBright";
+    case "yellow":
+      return "yellowBright";
+    case "magenta":
+      return "magentaBright";
+    case "cyan":
+      return "cyanBright";
+    case "red":
+      return "redBright";
+    case "blue":
+      return "blueBright";
+    case "black":
+      return "blackBright";
+    default:
+      return color;
+  }
+}
 function getActivityStyle(activity) {
   if (activity.type === "user") {
     return { color: "white", dimColor: false };
@@ -1855,6 +2039,76 @@ function truncateDetail2(detail, maxWidth) {
   }
   return `${truncated}\u2026`;
 }
+var ActivityRow = memo(function ActivityRow2({
+  activity,
+  timestamp,
+  width,
+  contentWidth,
+  isCursor,
+  isLiveRow,
+  liveSpinnerFrame,
+  liveTick
+}) {
+  const style = getActivityStyle(activity);
+  const timestampWidth = timestamp.length;
+  const icon = isLiveRow && liveSpinnerFrame ? liveSpinnerFrame : activity.icon;
+  const iconWidth = getDisplayWidth(icon);
+  const label = activity.label;
+  const detail = activity.detail;
+  const count = activity.count;
+  const countSuffix = count && count > 1 ? ` (\xD7${count})` : "";
+  const countSuffixWidth = countSuffix.length;
+  const prefixWidth = 2 + timestampWidth + iconWidth + 1;
+  const labelPart = detail ? `${label}: ` : label;
+  const labelWidth = labelPart.length;
+  const detailMaxWidth = width - 2 - timestampWidth - iconWidth - 1 - labelWidth - countSuffixWidth - 1;
+  let labelContent;
+  if (detail) {
+    const truncated = truncateDetail2(detail, Math.max(0, detailMaxWidth));
+    labelContent = `${labelPart}${truncated}${countSuffix}`;
+  } else {
+    labelContent = label + countSuffix;
+  }
+  const usedWidth = 1 + 1 + timestampWidth + iconWidth + 1 + getDisplayWidth(labelContent) + 1;
+  const padding = Math.max(0, width - usedWidth);
+  const SWEEP_WIDTH = 10;
+  let labelNode = labelContent;
+  if (isLiveRow && !isCursor && liveTick != null && labelContent.length > 0) {
+    const period = labelContent.length + SWEEP_WIDTH;
+    const offset = liveTick % period - SWEEP_WIDTH;
+    const litStart = Math.max(0, offset);
+    const litEnd = Math.min(labelContent.length, offset + SWEEP_WIDTH);
+    if (litEnd > litStart) {
+      const pre = labelContent.slice(0, litStart);
+      const lit = labelContent.slice(litStart, litEnd);
+      const post = labelContent.slice(litEnd);
+      labelNode = /* @__PURE__ */ jsxs(Fragment, { children: [
+        pre,
+        /* @__PURE__ */ jsx(Text, { color: brighten(style.color), bold: true, children: lit }),
+        post
+      ] });
+    }
+  }
+  return /* @__PURE__ */ jsxs(Text, { children: [
+    BOX.v,
+    " ",
+    /* @__PURE__ */ jsxs(Text, { backgroundColor: isCursor ? "blue" : void 0, children: [
+      /* @__PURE__ */ jsx(Text, { dimColor: !isCursor && !isLiveRow, children: timestamp }),
+      /* @__PURE__ */ jsx(Text, { color: "cyan", bold: isLiveRow, children: icon }),
+      " ",
+      /* @__PURE__ */ jsx(
+        Text,
+        {
+          color: isCursor ? void 0 : style.color,
+          dimColor: !isCursor && !isLiveRow && style.dimColor,
+          children: labelNode
+        }
+      ),
+      " ".repeat(padding)
+    ] }),
+    BOX.v
+  ] });
+});
 function ActivityViewerPanel({
   activities,
   sessionName,
@@ -1862,8 +2116,8 @@ function ActivityViewerPanel({
   isLive,
   newCount,
   visibleRows,
-  trailingBlankRows = 0,
-  liveIndicatorPosition = null,
+  liveSpinnerFrame = null,
+  liveTick = null,
   width,
   cursorLine,
   hasFocus,
@@ -1907,57 +2161,28 @@ function ActivityViewerPanel({
   } else {
     const effectiveCursor = Math.min(cursorLine, visibleActivities.length - 1);
     const cursorIndexInSlice = visibleActivities.length - 1 - effectiveCursor;
+    const liveRowIndex = visibleActivities.length - 1;
+    const liveTreatment = isLive && !!liveSpinnerFrame;
     for (let i = 0; i < visibleActivities.length; i++) {
       const activity = visibleActivities[i];
-      const style = getActivityStyle(activity);
       const isCursor = hasFocus && i === cursorIndexInSlice;
-      const time = formatActivityTime(activity.timestamp, now);
-      const timestamp = `[${time}] `;
-      const timestampWidth = timestamp.length;
-      const icon = activity.icon;
-      const iconWidth = getDisplayWidth(icon);
-      const label = activity.label;
-      const detail = activity.detail;
-      const count = activity.count;
-      const countSuffix = count && count > 1 ? ` (\xD7${count})` : "";
-      const countSuffixWidth = countSuffix.length;
-      const prefixWidth = 2 + timestampWidth + iconWidth + 1;
-      const labelPart = detail ? `${label}: ` : label;
-      const labelWidth = labelPart.length;
-      const _availableForDetail = contentWidth - prefixWidth - labelWidth - countSuffixWidth + 1;
-      const detailMaxWidth = width - 2 - timestampWidth - iconWidth - 1 - labelWidth - countSuffixWidth - 1;
-      let labelContent;
-      let _displayWidth;
-      if (detail) {
-        const truncated = truncateDetail2(detail, Math.max(0, detailMaxWidth));
-        labelContent = `${labelPart}${truncated}${countSuffix}`;
-        _displayWidth = prefixWidth - 1 + labelWidth + getDisplayWidth(truncated) + countSuffixWidth;
-      } else {
-        labelContent = label + countSuffix;
-        _displayWidth = prefixWidth - 1 + label.length + countSuffixWidth;
-      }
-      const usedWidth = 1 + 1 + timestampWidth + iconWidth + 1 + getDisplayWidth(labelContent) + 1;
-      const padding = Math.max(0, width - usedWidth);
+      const isLiveRow = liveTreatment && i === liveRowIndex;
+      const timestamp = `[${formatActivityTime(activity.timestamp, now)}] `;
       lines.push(
-        /* @__PURE__ */ jsxs(Text, { children: [
-          BOX.v,
-          " ",
-          /* @__PURE__ */ jsxs(Text, { backgroundColor: isCursor ? "blue" : void 0, children: [
-            /* @__PURE__ */ jsx(Text, { dimColor: !isCursor, children: timestamp }),
-            /* @__PURE__ */ jsx(Text, { color: "cyan", children: icon }),
-            " ",
-            /* @__PURE__ */ jsx(
-              Text,
-              {
-                color: isCursor ? void 0 : style.color,
-                dimColor: !isCursor && style.dimColor,
-                children: labelContent
-              }
-            ),
-            " ".repeat(padding)
-          ] }),
-          BOX.v
-        ] }, `activity-${i}`)
+        /* @__PURE__ */ jsx(
+          ActivityRow,
+          {
+            activity,
+            timestamp,
+            width,
+            contentWidth,
+            isCursor,
+            isLiveRow,
+            liveSpinnerFrame: isLiveRow ? liveSpinnerFrame ?? void 0 : void 0,
+            liveTick: isLiveRow ? liveTick ?? void 0 : void 0
+          },
+          `activity-${i}`
+        )
       );
     }
   }
@@ -1967,29 +2192,7 @@ function ActivityViewerPanel({
   for (let i = 0; i < padCount; i++) {
     padded.push(/* @__PURE__ */ jsx(Text, { children: emptyRow }, `pad-${i}`));
   }
-  const hasContent = visibleActivities.length > 0;
-  const trailing = [];
-  for (let i = 0; i < trailingBlankRows; i++) {
-    if (i === 0 && isLive && liveIndicatorPosition != null && hasContent) {
-      const pos = Math.max(0, liveIndicatorPosition);
-      const arrow = "\u203A";
-      const safePos = Math.min(pos, Math.max(0, contentWidth - 1));
-      const padAfter = Math.max(0, contentWidth - safePos - 1);
-      trailing.push(
-        /* @__PURE__ */ jsxs(Text, { children: [
-          BOX.v,
-          " ",
-          " ".repeat(safePos),
-          /* @__PURE__ */ jsx(Text, { color: "cyan", dimColor: true, children: arrow }),
-          " ".repeat(padAfter),
-          BOX.v
-        ] }, `trail-${i}`)
-      );
-    } else {
-      trailing.push(/* @__PURE__ */ jsx(Text, { children: emptyRow }, `trail-${i}`));
-    }
-  }
-  const finalLines = [...padded, ...lines, ...trailing];
+  const finalLines = [...padded, ...lines];
   return /* @__PURE__ */ jsxs(Box, { flexDirection: "column", width, children: [
     /* @__PURE__ */ jsx(Text, { color: isLive ? void 0 : "yellow", children: createTitleLine(sessionName, titleSuffix, width) }),
     finalLines,
@@ -2052,8 +2255,31 @@ function getLineStyle(category) {
 }
 
 // src/ui/DetailViewPanel.tsx
-import { jsx as jsx2, jsxs as jsxs2 } from "react/jsx-runtime";
-function wrapClassified(text, maxWidth, classifier) {
+import { Fragment as Fragment2, jsx as jsx2, jsxs as jsxs2 } from "react/jsx-runtime";
+function splitLineNumberGutter(text) {
+  const m = text.match(/^(\s*\d+: )(.*)$/);
+  return m ? [m[1], m[2]] : null;
+}
+function hardWrapByWidth(line, maxWidth) {
+  if (maxWidth <= 0) return [line];
+  const out = [];
+  let cur = "";
+  let curW = 0;
+  for (const ch of line) {
+    const w = getDisplayWidth(ch);
+    if (curW + w > maxWidth && cur !== "") {
+      out.push(cur);
+      cur = ch;
+      curW = w;
+    } else {
+      cur += ch;
+      curW += w;
+    }
+  }
+  if (cur !== "") out.push(cur);
+  return out.length > 0 ? out : [line];
+}
+function wrapClassified(text, maxWidth, classifier, preserveWhitespace = false) {
   if (!text) return [{ text: "(empty)", category: "prose" }];
   const sourceLines = text.split("\n");
   const categories = classifier(sourceLines);
@@ -2065,6 +2291,12 @@ function wrapClassified(text, maxWidth, classifier) {
       out.push({ text: "", category: cat });
       continue;
     }
+    if (preserveWhitespace) {
+      for (const chunk of hardWrapByWidth(line, maxWidth)) {
+        out.push({ text: chunk, category: cat });
+      }
+      continue;
+    }
     const words = line.split(" ");
     let current = "";
     for (const word of words) {
@@ -2089,8 +2321,15 @@ function DetailViewPanel({
 }) {
   const innerWidth = getInnerWidth(width);
   const contentWidth = innerWidth - 1;
-  const classifier = activity.type === "commit" ? classifyDiffLines : classifyCodeFences;
-  const allLines = wrapClassified(activity.detail, contentWidth, classifier);
+  const body = activity.detailBody ?? activity.detail;
+  const classifier = activity.detailKind === "diff" ? classifyDiffLines : activity.detailKind === "code" ? classifyCodeFences : activity.type === "commit" ? classifyDiffLines : classifyCodeFences;
+  const preserveWhitespace = activity.detailKind === "diff" || activity.detailKind === "code" || activity.type === "commit";
+  const allLines = wrapClassified(
+    body,
+    contentWidth,
+    classifier,
+    preserveWhitespace
+  );
   const totalLines = allLines.length;
   const clampedOffset = Math.min(
     scrollOffset,
@@ -2117,11 +2356,15 @@ function DetailViewPanel({
     const entry = visibleSlice[i] ?? { text: "", category: "prose" };
     const padding = Math.max(0, contentWidth - getDisplayWidth(entry.text));
     const lineStyle = getLineStyle(entry.category);
+    const gutterSplit = activity.detailNumbered ? splitLineNumberGutter(entry.text) : null;
     contentRows.push(
       /* @__PURE__ */ jsxs2(Text2, { children: [
         BOX.v,
         " ",
-        /* @__PURE__ */ jsx2(Text2, { color: lineStyle.color, dimColor: lineStyle.dimColor, children: entry.text }),
+        gutterSplit ? /* @__PURE__ */ jsxs2(Fragment2, { children: [
+          /* @__PURE__ */ jsx2(Text2, { dimColor: true, children: gutterSplit[0] }),
+          /* @__PURE__ */ jsx2(Text2, { color: lineStyle.color, dimColor: lineStyle.dimColor, children: gutterSplit[1] })
+        ] }) : /* @__PURE__ */ jsx2(Text2, { color: lineStyle.color, dimColor: lineStyle.dimColor, children: entry.text }),
         " ".repeat(padding),
         BOX.v
       ] }, i)
@@ -2155,6 +2398,7 @@ var SECTIONS = [
       ["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)"],
       ["Tab", "Switch focus to activity viewer"],
       ["r", "Refresh now"]
     ]
@@ -2292,11 +2536,15 @@ function useHotkeys({
   onDetailClose,
   onDetailScrollUp,
   onDetailScrollDown,
+  onDetailScrollHalfPageUp,
+  onDetailScrollHalfPageDown,
   onFilter,
   onHelp,
   onHelpScroll,
   onHelpScrollToTop,
-  filterLabel
+  onToggleTracking,
+  filterLabel,
+  trackingOn = false
 }) {
   const handleInput = (input, key) => {
     if (helpMode) {
@@ -2337,6 +2585,14 @@ function useHotkeys({
       return;
     }
     if (detailMode) {
+      if (key.ctrl && input === "u") {
+        onDetailScrollHalfPageUp();
+        return;
+      }
+      if (key.ctrl && input === "d") {
+        onDetailScrollHalfPageDown();
+        return;
+      }
       if (key.upArrow || input === "k") {
         onDetailScrollUp();
         return;
@@ -2371,6 +2627,10 @@ function useHotkeys({
       onFilter();
       return;
     }
+    if (input === "t" && !key.ctrl && onToggleTracking) {
+      onToggleTracking();
+      return;
+    }
     if (key.pageUp) {
       onScrollPageUp();
       return;
@@ -2430,7 +2690,9 @@ function useHotkeys({
       }
     }
   };
-  const statusBarItems = helpMode ? ["\u2191\u2193/jk: scroll", "PgDn/Space: page", "\u21B5/Esc/q/?: close"] : detailMode ? ["\u2191\u2193/jk: scroll", "\u21B5/Esc: close", "?: help"] : focus === "tree" ? [
+  const trackingItems = trackingOn ? ["TRK \u25CF"] : ["t: track"];
+  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",
     "PgUp/Dn: page",
@@ -2440,6 +2702,7 @@ function useHotkeys({
     "?: help",
     "q: quit"
   ] : [
+    ...trackingItems,
     "Tab: projects",
     "\u2191\u2193/jk: scroll",
     "PgUp/Dn: page",
@@ -2453,42 +2716,37 @@ function useHotkeys({
   return { handleInput, statusBarItems };
 }
 
-// src/ui/hooks/useSlide.ts
+// src/ui/hooks/useSpinner.ts
 import { useEffect, useState } from "react";
-function useSlide(active, positions, intervalMs = 180, resetKey) {
+var FRAMES = ["\u280B", "\u2819", "\u2839", "\u2838", "\u283C", "\u2834", "\u2826", "\u2827", "\u2807", "\u280F"];
+function useSpinner(active, intervalMs = 100) {
   const [index, setIndex] = useState(0);
-  useEffect(() => {
-    setIndex(0);
-  }, [resetKey]);
   useEffect(() => {
     if (!active) return;
     const timer = setInterval(() => {
-      setIndex((i) => (i + 1) % positions);
+      setIndex((i) => (i + 1) % FRAMES.length);
     }, intervalMs);
     return () => clearInterval(timer);
-  }, [active, positions, intervalMs]);
-  return index;
+  }, [active, intervalMs]);
+  return active ? FRAMES[index] : "";
 }
 
-// src/ui/hooks/useSpinner.ts
+// src/ui/hooks/useTick.ts
 import { useEffect as useEffect2, useState as useState2 } from "react";
-var FRAMES = ["\u280B", "\u2819", "\u2839", "\u2838", "\u283C", "\u2834", "\u2826", "\u2827", "\u2807", "\u280F"];
-function useSpinner(active, intervalMs = 100) {
-  const [index, setIndex] = useState2(0);
+function useTick(active, intervalMs = 100) {
+  const [n, setN] = useState2(0);
   useEffect2(() => {
     if (!active) return;
-    const timer = setInterval(() => {
-      setIndex((i) => (i + 1) % FRAMES.length);
-    }, intervalMs);
-    return () => clearInterval(timer);
+    const id = setInterval(() => setN((x) => x + 1), intervalMs);
+    return () => clearInterval(id);
   }, [active, intervalMs]);
-  return active ? FRAMES[index] : "";
+  return n;
 }
 
 // src/ui/SessionTreePanel.tsx
 import { homedir as homedir4 } from "os";
 import { Box as Box4, Text as Text4 } from "ink";
-import { Fragment, jsx as jsx4, jsxs as jsxs4 } from "react/jsx-runtime";
+import { Fragment as Fragment3, jsx as jsx4, jsxs as jsxs4 } from "react/jsx-runtime";
 function formatElapsed(lastModifiedMs, now = Date.now()) {
   const elapsed = Math.max(0, now - lastModifiedMs);
   const seconds = Math.floor(elapsed / 1e3);
@@ -2519,6 +2777,13 @@ function getStatusColor(status) {
       return "gray";
   }
 }
+function getBadge(session) {
+  if (session.liveState === "working")
+    return { text: "[working]", color: "green" };
+  if (session.liveState === "waiting")
+    return { text: "[waiting]", color: "magenta" };
+  return { text: `[${session.status}]`, color: getStatusColor(session.status) };
+}
 function formatProjectPath(projectPath) {
   const home = homedir4();
   const raw = projectPath.startsWith(home) ? `~${projectPath.slice(home.length)}` : projectPath;
@@ -2532,8 +2797,7 @@ function SessionRow({
   contentWidth
 }) {
   const isParent = prefix === "    ";
-  const statusColor = getStatusColor(session.status);
-  const badge = `[${session.status}]`;
+  const { text: badge, color: badgeColor } = getBadge(session);
   const elapsed = formatElapsed(session.lastModifiedMs);
   const model = session.modelName ?? "";
   const isNonInteractive = session.nonInteractive;
@@ -2582,7 +2846,7 @@ function SessionRow({
           /* @__PURE__ */ jsx4(Text4, { bold: !shouldDim, children: rawName }),
           shortIdDisplay ? /* @__PURE__ */ jsx4(Text4, { dimColor: true, children: shortIdDisplay }) : null,
           /* @__PURE__ */ jsx4(Text4, { children: " " }),
-          /* @__PURE__ */ jsx4(Text4, { color: statusColor, children: badge }),
+          /* @__PURE__ */ jsx4(Text4, { color: badgeColor, children: badge }),
           middleText ? /* @__PURE__ */ jsx4(Text4, { dimColor: true, children: middleSection }) : null,
           /* @__PURE__ */ jsx4(Text4, { children: gap }),
           /* @__PURE__ */ jsx4(Text4, { dimColor: true, children: elapsed }),
@@ -2706,7 +2970,7 @@ function ProjectRow({
         dimColor: muted,
         children: [
           nameText,
-          pathText ? /* @__PURE__ */ jsxs4(Fragment, { children: [
+          pathText ? /* @__PURE__ */ jsxs4(Fragment3, { children: [
             "  ",
             /* @__PURE__ */ jsx4(Text4, { dimColor: true, children: pathText })
           ] }) : null,
@@ -2781,11 +3045,16 @@ function SessionTreePanel({
   hasFocus,
   width = DEFAULT_PANEL_WIDTH,
   maxRows,
-  expandedIds = /* @__PURE__ */ new Set()
+  expandedIds = /* @__PURE__ */ new Set(),
+  trackingOn = false,
+  spinner = "",
+  scopeLabel
 }) {
   const innerWidth = getInnerWidth(width);
   const contentWidth = innerWidth - 1;
-  const titleLine = createTitleLine("Projects", "", width);
+  const titleSuffix = trackingOn ? `[LIVE ${spinner || "\u25BC"}]` : "";
+  const titleText = scopeLabel ? `Projects [${scopeLabel}]` : "Projects";
+  const titleLine = createTitleLine(titleText, titleSuffix, width);
   const bottomLine = createBottomLine(width);
   const totalProjectCount = projects.length + coldProjects.length;
   if (totalProjectCount === 0) {
@@ -2879,7 +3148,7 @@ function SessionTreePanel({
 }
 
 // src/ui/App.tsx
-import { Fragment as Fragment2, jsx as jsx5, jsxs as jsxs5 } from "react/jsx-runtime";
+import { Fragment as Fragment4, jsx as jsx5, jsxs as jsxs5 } from "react/jsx-runtime";
 var VIEWER_HEIGHT_FRACTION = 0.55;
 function subSummarySentinel(parentId) {
   return {
@@ -2893,7 +3162,8 @@ function subSummarySentinel(parentId) {
     modelName: null,
     subAgents: [],
     nonInteractive: false,
-    firstUserPrompt: null
+    firstUserPrompt: null,
+    liveState: null
   };
 }
 function appendSubAgentRows(result, session, expandedIds) {
@@ -2932,7 +3202,8 @@ function flattenSessions2(tree, expandedIds) {
       modelName: null,
       subAgents: [],
       nonInteractive: false,
-      firstUserPrompt: null
+      firstUserPrompt: null,
+      liveState: null
     });
     const shouldShowSessions = isCold ? expandedIds.has(`__expanded-${sentinelId}`) : !expandedIds.has(`__collapsed-${sentinelId}`);
     if (shouldShowSessions) {
@@ -2957,7 +3228,8 @@ function flattenSessions2(tree, expandedIds) {
       modelName: null,
       subAgents: [],
       nonInteractive: false,
-      firstUserPrompt: null
+      firstUserPrompt: null,
+      liveState: null
     });
     if (expandedIds.has("__cold__")) {
       for (const project of tree.coldProjects) {
@@ -2980,14 +3252,69 @@ function getSelectedActivity(acts, live, scrollOff, rows, cursorLine) {
   const effectiveCursor = Math.min(cursorLine, visible.length - 1);
   return visible[visible.length - 1 - effectiveCursor] ?? null;
 }
-function App({ mode }) {
+function pickTrackingTarget(tree, selectedId, seen) {
+  const ids = /* @__PURE__ */ new Set();
+  const liveSubs = [];
+  const liveParents = [];
+  for (const p of tree.projects) {
+    for (const s of p.sessions) {
+      ids.add(s.id);
+      if (s.status === "hot" || s.status === "warm") {
+        liveParents.push({
+          id: s.id,
+          mtime: s.lastModifiedMs,
+          isNew: !seen.has(s.id)
+        });
+      }
+      for (const sa of s.subAgents) {
+        ids.add(sa.id);
+        if (sa.status === "hot" || sa.status === "warm") {
+          liveSubs.push({
+            id: sa.id,
+            mtime: sa.lastModifiedMs,
+            isNew: !seen.has(sa.id)
+          });
+        }
+      }
+    }
+  }
+  const newest = (xs) => xs.length === 0 ? null : xs.reduce((a, b) => a.mtime > b.mtime ? a : b).id;
+  const newSubTarget = newest(liveSubs.filter((s) => s.isNew));
+  if (newSubTarget) return { target: newSubTarget, ids };
+  const newParentTarget = newest(liveParents.filter((p) => p.isNew));
+  if (newParentTarget) return { target: newParentTarget, ids };
+  const currentIsLive = selectedId != null && (liveSubs.some((s) => s.id === selectedId) || liveParents.some((p) => p.id === selectedId));
+  if (currentIsLive) return { target: null, ids };
+  return {
+    target: newest(liveSubs) ?? newest(liveParents),
+    ids
+  };
+}
+function collectAllIds(tree) {
+  const ids = /* @__PURE__ */ new Set();
+  for (const p of tree.projects) {
+    for (const s of p.sessions) {
+      ids.add(s.id);
+      for (const sa of s.subAgents) ids.add(sa.id);
+    }
+  }
+  return ids;
+}
+function App({
+  mode,
+  scopeToProject: scopeToProject2
+}) {
   const { exit } = useApp();
   const { stdout } = useStdout();
   const isWatchMode = mode === "watch";
   const config = useMemo(() => loadGlobalConfig(), []);
   const migrationWarning = useMemo(() => hasProjectLevelConfig(), []);
+  const discoverOptions = useMemo(
+    () => scopeToProject2 ? { scopeToProject: scopeToProject2 } : void 0,
+    [scopeToProject2]
+  );
   const [sessionTree, setSessionTree] = useState3(
-    () => discoverSessions(config)
+    () => discoverSessions(config, discoverOptions)
   );
   const [selectedId, setSelectedId] = useState3(() => {
     const firstProject = sessionTree.projects[0];
@@ -3011,6 +3338,8 @@ function App({ mode }) {
   const [helpMode, setHelpMode] = useState3(false);
   const [helpScroll, setHelpScroll] = useState3(0);
   const helpTotalLinesRef = useRef(0);
+  const [tracking, setTracking] = useState3(false);
+  const seenIdsRef = useRef(/* @__PURE__ */ new Set());
   const allFlat = useMemo(
     () => flattenSessions2(sessionTree, expandedIds),
     [sessionTree, expandedIds]
@@ -3093,13 +3422,26 @@ function App({ mode }) {
   }, [selectedId, isWatchMode]);
   const refresh = useCallback(() => {
     const freshConfig = loadGlobalConfig();
-    const tree = discoverSessions(freshConfig);
+    const tree = discoverSessions(freshConfig, discoverOptions);
     const updatedFlat = flattenSessions2(tree, expandedIds);
-    const node = updatedFlat.find((s) => s.id === selectedId);
+    let nextSelected = selectedId;
+    if (tracking) {
+      const { target, ids } = pickTrackingTarget(
+        tree,
+        selectedId,
+        seenIdsRef.current
+      );
+      if (target && target !== selectedId) {
+        setSelectedId(target);
+        nextSelected = target;
+      }
+      seenIdsRef.current = ids;
+    }
+    const node = updatedFlat.find((s) => s.id === nextSelected);
     if (!node) {
       const allSessions = tree.projects?.flatMap((p) => p.sessions) ?? [];
       const parentSession = allSessions.find(
-        (s) => s.subAgents.some((sa) => sa.id === selectedId)
+        (s) => s.subAgents.some((sa) => sa.id === nextSelected)
       );
       if (parentSession) setSelectedId(parentSession.id);
     }
@@ -3112,7 +3454,7 @@ function App({ mode }) {
       setScrollOffset((o) => o + delta);
       setNewCount((n) => n + delta);
     }
-  }, [selectedId, isLive, expandedIds]);
+  }, [selectedId, isLive, expandedIds, tracking, discoverOptions]);
   const refreshRef = useRef(refresh);
   useEffect3(() => {
     refreshRef.current = refresh;
@@ -3147,6 +3489,11 @@ function App({ mode }) {
       if (debounce) clearTimeout(debounce);
     };
   }, [isWatchMode, config.refreshIntervalMs]);
+  useEffect3(() => {
+    if (!isWatchMode || !tracking) return;
+    const timer = setInterval(() => refreshRef.current(), 1e3);
+    return () => clearInterval(timer);
+  }, [isWatchMode, tracking]);
   const filterPresets = config.filterPresets;
   const activePreset = useMemo(
     () => filterPresets[filterIndex % filterPresets.length] ?? [],
@@ -3171,26 +3518,18 @@ function App({ mode }) {
   const maxTreeRows = Math.floor(height * (1 - VIEWER_HEIGHT_FRACTION));
   const naturalTreeRows = allFlat.length;
   const treeRows = Math.max(1, Math.min(naturalTreeRows, maxTreeRows));
-  const VIEWER_BREATHING_ROWS = 1;
-  const viewerRows = Math.max(
-    5,
-    height - 7 - treeRows - VIEWER_BREATHING_ROWS
-  );
-  const spinner = useSpinner(isWatchMode);
-  const viewerIndicatorWidth = Math.max(1, width - 3);
-  const liveIndicatorPosition = useSlide(
-    isWatchMode,
-    viewerIndicatorWidth,
-    180,
-    // Reset to 0 whenever the viewer's subject changes so each new
-    // session/sub-agent restarts the arrow from the left.
-    selectedId
-  );
+  const viewerRows = Math.max(5, height - 7 - treeRows);
+  const spinner = useSpinner(isWatchMode, 150);
+  const tickActive = isWatchMode && isLive && !helpMode && !detailMode && activities.length > 0;
+  const liveTick = useTick(tickActive, 150);
   const helpViewportRows = Math.max(1, height - 3);
   const helpScrollStep = (delta) => {
     const max = Math.max(0, helpTotalLinesRef.current - helpViewportRows);
     setHelpScroll((s) => Math.max(0, Math.min(max, s + delta)));
   };
+  const stopTracking = () => {
+    if (tracking) setTracking(false);
+  };
   const { handleInput, statusBarItems } = useHotkeys({
     focus,
     detailMode,
@@ -3201,12 +3540,29 @@ function App({ mode }) {
     },
     onHelpScroll: helpScrollStep,
     onHelpScrollToTop: () => setHelpScroll(0),
+    onToggleTracking: () => {
+      setTracking((on) => {
+        const next = !on;
+        if (next) {
+          seenIdsRef.current = collectAllIds(sessionTree);
+          const { target } = pickTrackingTarget(
+            sessionTree,
+            selectedId,
+            seenIdsRef.current
+          );
+          if (target) setSelectedId(target);
+        }
+        return next;
+      });
+    },
+    trackingOn: tracking,
     onSwitchFocus: () => setFocus((f) => f === "tree" ? "viewer" : "tree"),
     // cursorLine = "entries back from the newest" (0 = newest = bottom row).
     // Up arrow moves visually upward = older direction = cursorLine++.
     // Down arrow moves visually downward = newer direction = cursorLine--.
     onScrollUp: () => {
       if (focus === "tree") {
+        stopTracking();
         if (selectedIndex === -1) return;
         const prev = Math.max(0, selectedIndex - 1);
         setSelectedId(allFlat[prev]?.id ?? selectedId);
@@ -3223,6 +3579,7 @@ function App({ mode }) {
     },
     onScrollDown: () => {
       if (focus === "tree") {
+        stopTracking();
         if (selectedIndex === -1) return;
         const next = Math.min(allFlat.length - 1, selectedIndex + 1);
         setSelectedId(allFlat[next]?.id ?? selectedId);
@@ -3246,6 +3603,7 @@ function App({ mode }) {
     // PgDn = visually down = newer direction = scrollOffset--
     onScrollPageUp: () => {
       if (focus === "tree") {
+        stopTracking();
         const prev = Math.max(0, selectedIndex - 5);
         setSelectedId(allFlat[prev]?.id ?? selectedId);
       } else {
@@ -3258,6 +3616,7 @@ function App({ mode }) {
     },
     onScrollPageDown: () => {
       if (focus === "tree") {
+        stopTracking();
         const next = Math.min(allFlat.length - 1, selectedIndex + 5);
         setSelectedId(allFlat[next]?.id ?? selectedId);
       } else {
@@ -3274,6 +3633,7 @@ function App({ mode }) {
     },
     onScrollHalfPageUp: () => {
       if (focus === "tree") {
+        stopTracking();
         const prev = Math.max(0, selectedIndex - Math.ceil(5 / 2));
         setSelectedId(allFlat[prev]?.id ?? selectedId);
       } else {
@@ -3289,6 +3649,7 @@ function App({ mode }) {
     },
     onScrollHalfPageDown: () => {
       if (focus === "tree") {
+        stopTracking();
         const next = Math.min(
           allFlat.length - 1,
           selectedIndex + Math.ceil(5 / 2)
@@ -3326,6 +3687,14 @@ function App({ mode }) {
     onDetailScrollDown: () => {
       setDetailScrollOffset((o) => o + 1);
     },
+    onDetailScrollHalfPageUp: () => {
+      const step = Math.max(1, Math.floor(viewerRows / 2));
+      setDetailScrollOffset((o) => Math.max(0, o - step));
+    },
+    onDetailScrollHalfPageDown: () => {
+      const step = Math.max(1, Math.floor(viewerRows / 2));
+      setDetailScrollOffset((o) => o + step);
+    },
     onEnter: () => {
       if (focus === "viewer") {
         const act = getSelectedActivity(
@@ -3349,6 +3718,7 @@ function App({ mode }) {
         return;
       }
       if (focus !== "tree" || !selectedId) return;
+      stopTracking();
       if (selectedId.startsWith("__proj-") && selectedId.endsWith("__")) {
         const projectName = selectedId.slice(7, -2);
         const isCold = sessionTree.coldProjects.some(
@@ -3433,6 +3803,7 @@ function App({ mode }) {
     },
     onHide: () => {
       if (focus !== "tree" || !selectedId) return;
+      stopTracking();
       if (selectedId.startsWith("__proj-") && selectedId.endsWith("__")) {
         const projectName = selectedId.slice(7, -2);
         hideProject(projectName);
@@ -3492,7 +3863,13 @@ function App({ mode }) {
   if (isWatchMode && (width < MIN_WIDTH || height + 1 < MIN_HEIGHT)) {
     return /* @__PURE__ */ jsxs5(Box5, { flexDirection: "column", width, children: [
       /* @__PURE__ */ jsx5(Text5, { bold: true, children: "AgentHUD needs a larger terminal." }),
-      /* @__PURE__ */ jsx5(Text5, { dimColor: true, children: `Minimum: ${MIN_WIDTH} cols \xD7 ${MIN_HEIGHT} rows` }),
+      /* @__PURE__ */ jsx5(
+        Text5,
+        {
+          dimColor: true,
+          children: `Minimum: ${MIN_WIDTH} cols \xD7 ${MIN_HEIGHT} rows`
+        }
+      ),
       /* @__PURE__ */ jsx5(Text5, { dimColor: true, children: `Current: ${width} cols \xD7 ${height + 1} rows` }),
       /* @__PURE__ */ jsx5(Text5, { children: " " }),
       /* @__PURE__ */ jsx5(Text5, { dimColor: true, children: "Resize the window and AgentHUD will redraw automatically." }),
@@ -3527,7 +3904,7 @@ function App({ mode }) {
           helpTotalLinesRef.current = n;
         }
       }
-    ) : /* @__PURE__ */ jsxs5(Fragment2, { children: [
+    ) : /* @__PURE__ */ jsxs5(Fragment4, { children: [
       migrationWarning && /* @__PURE__ */ jsx5(Box5, { marginBottom: 1, children: /* @__PURE__ */ jsx5(Text5, { color: "yellow", children: "Config moved to ~/.agenthud/config.yaml" }) }),
       /* @__PURE__ */ jsx5(
         SessionTreePanel,
@@ -3538,7 +3915,10 @@ function App({ mode }) {
           hasFocus: focus === "tree",
           width,
           maxRows: treeRows,
-          expandedIds
+          expandedIds,
+          trackingOn: tracking,
+          spinner,
+          scopeLabel: scopeToProject2 ? basename3(scopeToProject2) : void 0
         }
       ),
       /* @__PURE__ */ jsx5(Box5, { marginTop: 1, children: detailMode && detailActivity ? /* @__PURE__ */ jsx5(
@@ -3559,8 +3939,8 @@ function App({ mode }) {
           isLive,
           newCount,
           visibleRows: viewerRows,
-          trailingBlankRows: VIEWER_BREATHING_ROWS,
-          liveIndicatorPosition,
+          liveSpinnerFrame: spinner,
+          liveTick,
           width,
           cursorLine: viewerCursorLine,
           hasFocus: focus === "viewer",
@@ -3572,6 +3952,52 @@ function App({ mode }) {
   ] });
 }
 
+// src/utils/altScreen.ts
+var ENTER = "\x1B[?1049h";
+var LEAVE = "\x1B[?1049l";
+var entered = false;
+var left = false;
+function enterAltScreen() {
+  if (entered) return;
+  entered = true;
+  process.stdout.write(ENTER);
+}
+function leaveAltScreen() {
+  if (left || !entered) return;
+  left = true;
+  process.stdout.write(LEAVE);
+}
+var hooksInstalled = false;
+function installAltScreenCleanup() {
+  if (hooksInstalled) return;
+  hooksInstalled = true;
+  process.on("exit", () => {
+    leaveAltScreen();
+  });
+  process.on("SIGINT", () => {
+    leaveAltScreen();
+    process.exit(130);
+  });
+  process.on("SIGTERM", () => {
+    leaveAltScreen();
+    process.exit(143);
+  });
+  process.on("uncaughtException", (err) => {
+    leaveAltScreen();
+    setImmediate(() => {
+      throw err;
+    });
+  });
+}
+
+// src/utils/legacyConfig.ts
+import { join as join5, resolve } from "path";
+function isLegacyProjectConfig(cwd, home) {
+  const legacy = resolve(join5(cwd, ".agenthud", "config.yaml"));
+  const global = resolve(join5(home, ".agenthud", "config.yaml"));
+  return legacy !== global;
+}
+
 // src/main.ts
 var options = parseArgs(process.argv.slice(2));
 if (options.error) {
@@ -3658,10 +4084,39 @@ if (options.mode === "summary") {
   });
   process.exit(exitCode);
 }
+var scopeToProject;
+if (options.scopeToCwd) {
+  const projectsDir = getProjectsDir();
+  let registered = [];
+  try {
+    registered = readdirSync2(projectsDir).map(decodeProjectPath);
+  } catch {
+  }
+  const safeReal = (p) => {
+    try {
+      return realpathSync(p);
+    } catch {
+      return p;
+    }
+  };
+  const match = findContainingProject(process.cwd(), registered, {
+    realpath: safeReal
+  });
+  if (!match) {
+    process.stderr.write(
+      `agenthud: --cwd: no Claude project found at or above ${process.cwd()}
+`
+    );
+    process.exit(1);
+  }
+  scopeToProject = match;
+  process.stderr.write(`agenthud: scope = ${match}
+`);
+}
 if (options.mode === "watch") {
   installAltScreenCleanup();
   enterAltScreen();
 } else {
   if (options.mode === "once") clearScreen();
 }
-render(React.createElement(App, { mode: options.mode }));
+render(React.createElement(App, { mode: options.mode, scopeToProject }));