agenthud 0.9.2 → 0.9.4

package/README.md

@@ -4,10 +4,16 @@
 [![CI](https://github.com/neochoon/agenthud/actions/workflows/ci.yml/badge.svg)](https://github.com/neochoon/agenthud/actions/workflows/ci.yml)
 [![codecov](https://codecov.io/gh/neochoon/agenthud/branch/main/graph/badge.svg)](https://codecov.io/gh/neochoon/agenthud)
 
-When working with AI coding agents like Claude Code, you lose visibility into what's happening across sessions. **AgentHUD** gives you a live session browser in a separate terminal — see every session, sub-agent, and activity as it happens.
+An observability layer for [Claude Code](https://github.com/anthropics/claude-code). **See** your live sessions, **export** structured activity logs, and **summarize** a day or a week into an LLM digest — all from one CLI.
 
 ![demo](./output960.gif)
 
+AgentHUD reads Claude Code's session files from `~/.claude/projects/` and gives you three things:
+
+- **Live monitor** ([`agenthud`](#live-monitor)) — a split-view TUI showing every project, session, sub-agent, and activity as it happens.
+- **Structured export** ([`agenthud report`](#report)) — print activity for any date as Markdown or JSON for piping to scripts, dashboards, or other LLMs.
+- **LLM digest** ([`agenthud summary`](#summary)) — synthesize a day or a date range into an engineering summary via the `claude` CLI, with caching so weekly digests are cheap to regenerate.
+
 ## Install
 
 Requires Node.js 20+.
@@ -18,43 +24,46 @@ npx agenthud
 
 Run this in a separate terminal while using Claude Code. Press `?` inside the TUI any time for in-app help.
 
-## What it shows
+## Live monitor
 
-AgentHUD reads Claude Code's session files from `~/.claude/projects/` and displays them in a split view:
+AgentHUD's TUI splits the screen into a project tree and an activity viewer:
 
 ```
-┌─ Projects ──────────────────────────────────────────────┐
-│ > 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               │
+│ ›                                                        │
+└──────────────────────────────────────────────────────────┘
 ```
 
 **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
+### Session status
 
 Each session row carries a colored badge derived from when its JSONL file was last touched:
 
@@ -67,7 +76,7 @@ Each session row carries a colored badge derived from when its JSONL file was la
 
 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
+### Activity types
 
 | Icon | Type | Description |
 |------|------|-------------|
@@ -82,11 +91,11 @@ Sub-agents use the same scheme. Projects inherit the hottest status of their ses
 | `…` | Thinking | Claude's thinking (requires `showThinkingSummaries: true`) |
 | `◆` | Commit | Git commit in the project (when `--with-git` or in viewer) |
 
-## Keyboard shortcuts
+### Keyboard shortcuts
 
 Full reference is also available inside the app — press `?`.
 
-### Project tree focus
+#### Project tree focus
 
 | Key | Action |
 |-----|--------|
@@ -101,7 +110,7 @@ Full reference is also available inside the app — press `?`.
 | `?` | Help |
 | `q` | Quit |
 
-### Activity viewer focus
+#### Activity viewer focus
 
 | Key | Action |
 |-----|--------|
@@ -110,21 +119,33 @@ 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 |
+| `r` | Refresh now |
 | `Tab` | Switch focus to project tree |
 | `?` | Help |
 | `q` | Quit |
 
-### Detail view
+#### Detail view
 
 | Key | Action |
 |-----|--------|
 | `↑` / `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:
@@ -155,7 +176,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 |
@@ -179,6 +200,10 @@ agenthud summary --prompt "Only commits"    # override prompt
 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
+
+# Cheaper model — summarization doesn't need Opus-tier reasoning
+agenthud summary --date today --model sonnet        # ~40% cheaper than Opus
+agenthud summary --last 7d --model haiku            # ~80% cheaper, 200K context
 ```
 
 **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).
@@ -191,6 +216,10 @@ Each missing daily prompts for confirmation just before generation, so you see c
 
 **`--date` formats:** `YYYY-MM-DD`, `today`, `yesterday`, or `-Nd` (N days ago).
 
+**Model selection:** Summarization is a low-reasoning task (structured input → structured markdown) — Sonnet or Haiku usually beats Opus on cost-per-summary with no quality loss. Pass `--model sonnet`, `--model haiku`, or a full model id (`--model claude-sonnet-4-6`). With no flag, `claude` uses its default model.
+
+**Cost warning:** If the day's activity log is large (~300K tokens or more), AgentHUD prints a warning before sending and asks for one more confirmation in interactive mode. `-y` skips the prompt but still prints the warning.
+
 **Requires:** [`@anthropic-ai/claude-code`](https://www.npmjs.com/package/@anthropic-ai/claude-code) installed and authenticated.
 
 ## Configuration
@@ -202,10 +231,11 @@ Each missing daily prompts for confirmation just before generation, so you see c
 refreshInterval: 2s
 
 # 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"]
 ```
 

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-6SGKXL7E.js");
+import("./main-26QL33AJ.js");