agenthud 0.9.1 → 0.9.3

package/README.md

@@ -23,36 +23,52 @@ Run this in a separate terminal while using Claude Code. Press `?` inside the TU
 AgentHUD reads Claude Code's session files from `~/.claude/projects/` and displays them in a split view:
 
 ```
-┌─ Sessions ──────────────────────────────────────────────┐
-│ > agenthud  ~/WestbrookAI/agenthud                      │
-│     #864f [hot] Fix the auth bug in login flow          │
-│         ├─ » code-reviewer                              │
-│     (#398c [warm])                                      │
-│   myproject  ~/work/myproject                           │
-│     #def4 [hot] Add OAuth support                       │
-│ ... 12 cold projects                                    │
-└─────────────────────────────────────────────────────────┘
-┌─ Activity · agenthud ───────────────────────────────────┐
-│ [10:23] ○ Read  src/ui/App.tsx                          │
-│ [10:23] ~ Edit  src/ui/App.tsx                          │
-│ [10:23] $ Bash  npm test                                │
-│ [10:23] < Response  Tests passed successfully           │
-│ [10:25] ◆ abc1234  feat: fix auth callback              │
-└─────────────────────────────────────────────────────────┘
+┌─ Projects ───────────────────────────────────────────────┐
+│ > agenthud  ~/WestbrookAI/agenthud                   13m │
+│     #864f [hot] Fix the auth bug in login flow           │
+│         ├─ » code-reviewer                               │
+│     (#398c [warm])                                       │
+│   myproject  ~/work/myproject                         2d │
+│     #def4 [hot] Add OAuth support                        │
+│ ... 12 cold projects                                     │
+└──────────────────────────────────────────────────────────┘
+┌─ Activity · agenthud ────────────────────────────────────┐
+│ [10:23] ○ Read  src/ui/App.tsx                           │
+│ [10:23] ~ Edit  src/ui/App.tsx                           │
+│ [10:23] $ Bash  npm test                                 │
+│ [10:23] < Response  Tests passed successfully            │
+│ [10:25] ◆ abc1234  feat: fix auth callback               │
+│ ›                                                        │
+└──────────────────────────────────────────────────────────┘
 ```
 
-**Session tree (top pane)**
+**Project tree (top pane)**
 - Sessions grouped under their project (project name + path at the top).
-- Session rows show short ID + first user prompt (the session's "topic").
+- Session rows show short ID + first user prompt (the session's "topic"). Long titles truncate with a `…` suffix.
+- Right edge of each row shows how long ago it was last touched: `42m`, `17h`, `3d`, `2w`, `1mo`, `1y`. Project rows use the most recent session's mtime.
 - Non-interactive sessions (from `claude -p`, SDK, `agenthud summary`) appear in parens and dimmed.
 - Sub-agents nest one level deeper under their parent session.
 - Cold projects collapse under `... N cold projects` at the bottom (press Enter on the line to expand).
 - Press `h` to hide a project, session, or sub-agent (saved to `~/.agenthud/state.yaml`).
 
 **Activity viewer (bottom pane)**
-- Real-time feed for the selected session: file reads, edits, bash, responses, thinking, git commits.
+- Real-time feed for the selected session: file reads, edits, bash, responses, thinking, git commits. Newest at the bottom, like `tail -f`.
+- A `›` slides left → right along the bottom row while the viewer is in LIVE mode — visible proof the feed is alive. Hidden when paused (scrolled into history) or when the session has no activity yet.
 - Press `f` to cycle through filter presets (configurable).
-- Press `↵` on any row to open a scrollable detail view; on a commit row this shows `git show --stat`.
+- Press `↵` on any row to open a scrollable detail view; on a commit row this shows `git show --stat --patch`.
+
+## Session status
+
+Each session row carries a colored badge derived from when its JSONL file was last touched:
+
+| Badge | Color | Meaning |
+|-------|-------|---------|
+| `[hot]` | green | Updated in the last 30 minutes — actively running |
+| `[warm]` | yellow | Updated in the last hour |
+| `[cool]` | cyan | Updated earlier today |
+| `[cold]` | gray | Last updated yesterday or earlier — collapsed under `... N cold projects` at the bottom |
+
+Sub-agents use the same scheme. Projects inherit the hottest status of their sessions; a project is treated as "cold" only when all its sessions are cold.
 
 ## Activity types
 
@@ -73,7 +89,7 @@ AgentHUD reads Claude Code's session files from `~/.claude/projects/` and displa
 
 Full reference is also available inside the app — press `?`.
 
-### Session tree focus
+### Project tree focus
 
 | Key | Action |
 |-----|--------|
@@ -97,12 +113,12 @@ Full reference is also available inside the app — press `?`.
 | `PgUp` / `Ctrl+B` | Page up |
 | `PgDn` / `Ctrl+F` | Page down |
 | `Ctrl+U` / `Ctrl+D` | Half page up / down |
-| `g` | Jump to live (newest) |
-| `G` | Jump to oldest |
+| `g` | Jump to top (oldest) |
+| `G` | Jump to live (newest, bottom) |
 | `↵` | Open detail view |
 | `f` | Cycle filter preset |
-| `s` | Save log to `~/.agenthud/logs/` |
-| `Tab` | Switch focus to session tree |
+| `r` | Refresh now |
+| `Tab` | Switch focus to project tree |
 | `?` | Help |
 | `q` | Quit |
 
@@ -113,6 +129,17 @@ Full reference is also available inside the app — press `?`.
 | `↑` / `k` / `↓` / `j` | Scroll |
 | `↵` / `Esc` / `q` | Close |
 
+Detail view colors the content based on activity type:
+
+- **Git commit detail** (`git show --stat --patch`): added lines green (`+`), removed lines red (`-`), hunk headers cyan (`@@ ... @@`), `commit/Author/Date/diff` metadata dimmed.
+- **Response / thinking / prompt**: text inside triple-backtick code fences renders in cyan so the boundary between prose and code is obvious. No language-specific syntax highlighting — just code-vs-prose separation.
+
+## Behavior
+
+- **Alternate screen buffer.** Watch mode uses the alt-screen (like `vim`, `htop`, `btop`), so quitting (`q`) restores the pre-launch shell completely. No TUI residue, no "is it still running?" confusion.
+- **Minimum terminal size.** 80 cols × 20 rows. Smaller terminals show a one-line hint and redraw automatically when you resize.
+- **Help overlay scrolls.** Press `?` for an in-app reference. The overlay scrolls (`j/k`, `PgUp/PgDn`, `Ctrl+B/F`, `Space`, `g/G`) so the full content is reachable on shorter terminals.
+
 ## Report
 
 Print activity for a date in Markdown or JSON — suitable for piping to scripts or LLMs:
@@ -143,7 +170,7 @@ Output:
 
 | Flag | Default | Description |
 |------|---------|-------------|
-| `--date` | today | `YYYY-MM-DD` or `today` (local date) |
+| `--date` | today | `YYYY-MM-DD`, `today`, `yesterday`, or `-Nd` (N days ago, local date) |
 | `--include` | `response,bash,edit,thinking` | Comma-separated types or `all` |
 | `--format` | `markdown` | `markdown` or `json` |
 | `--detail-limit` | `120` | Max chars per detail field; `0` = unlimited |
@@ -153,18 +180,31 @@ Output:
 
 ## Summary
 
-Generate an LLM-based summary of a day's activity using the `claude` CLI:
+Generate an LLM-based summary of one day or a date range using the `claude` CLI:
 
 ```bash
+# Single day
 agenthud summary                            # today (always regenerated)
+agenthud summary --date yesterday           # natural-language date
 agenthud summary --date 2026-05-14          # past date (cached on second run)
 agenthud summary --date 2026-05-14 --force  # ignore cache
 agenthud summary --prompt "Only commits"    # override prompt
+
+# Date range — daily summaries are re-summarized into a meta-summary
+agenthud summary --last 7d                          # last 7 days, ending today
+agenthud summary --from 2026-05-10 --to 2026-05-16  # explicit range
+agenthud summary --last 7d -y                       # skip per-day confirmations
 ```
 
-Results are saved to `~/.agenthud/summaries/YYYY-MM-DD.md`. Past dates are cached and returned instantly on re-run. Today is always regenerated (activity still growing).
+**Daily summaries** are saved to `~/.agenthud/summaries/YYYY-MM-DD.md`. Past dates are cached and returned instantly; today is always regenerated (activity still growing).
+
+**Range summaries** generate any missing daily summaries first, then feed those into a second `claude` call that produces a cross-day synthesis (themes, multi-day workstreams, recurring patterns). Output is cached to `~/.agenthud/summaries/range-FROM_TO.md`. Cached dailies cost nothing to reuse, so weekly summaries are cheap after the first run.
 
-**Prompt customization:** The summary uses `~/.agenthud/summary-prompt.md`, auto-created from a built-in template on first run. Edit it freely or override per-call with `--prompt`.
+Each missing daily prompts for confirmation just before generation, so you see concrete context (session/activity/commit counts and report size) before deciding. Pass `-y` / `--yes` to skip all prompts. Press Enter to accept the default (`[Y/n]`).
+
+**Prompt customization:** The daily template lives at `~/.agenthud/summary-prompt.md` and the range template at `~/.agenthud/summary-range-prompt.md`. Both are auto-created from built-in templates on first run. Edit them freely.
+
+**`--date` formats:** `YYYY-MM-DD`, `today`, `yesterday`, or `-Nd` (N days ago).
 
 **Requires:** [`@anthropic-ai/claude-code`](https://www.npmjs.com/package/@anthropic-ai/claude-code) installed and authenticated.
 
@@ -176,14 +216,12 @@ Results are saved to `~/.agenthud/summaries/YYYY-MM-DD.md`. Past dates are cache
 # How often to poll for activity updates (Linux fallback when fs.watch isn't used)
 refreshInterval: 2s
 
-# Where 's' key saves activity logs
-logDir: ~/.agenthud/logs
-
 # Activity filter presets (cycle with 'f' key in viewer)
-# Each list is one preset; [] means "all". First preset is the default.
+# Each list is one preset. Use "all" (or "*") to show everything.
+# Types: response, user, bash, edit, thinking, read, glob, commit
 filterPresets:
-  - []
-  - ["response"]
+  - ["all"]
+  - ["response", "user"]
   - ["commit"]
 ```
 
@@ -195,9 +233,10 @@ App-managed state (hidden items) lives separately in `~/.agenthud/state.yaml` so
 |------|---------|
 | `~/.agenthud/config.yaml` | User settings (edit freely) |
 | `~/.agenthud/state.yaml` | Hidden projects/sessions/sub-agents (app-managed) |
-| `~/.agenthud/summary-prompt.md` | LLM prompt template for `summary` |
-| `~/.agenthud/summaries/` | Cached daily summaries |
-| `~/.agenthud/logs/` | Saved activity logs (`s` key) |
+| `~/.agenthud/summary-prompt.md` | LLM prompt template for daily `summary` |
+| `~/.agenthud/summary-range-prompt.md` | LLM prompt template for range `summary --last/--from/--to` |
+| `~/.agenthud/summaries/YYYY-MM-DD.md` | Cached daily summaries |
+| `~/.agenthud/summaries/range-FROM_TO.md` | Cached range summaries |
 
 ## Environment Variables
 

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