agenthud 0.8.5 → 0.9.0

package/README.md

@@ -16,7 +16,7 @@ Requires Node.js 20+.
 npx agenthud
 ```
 
-Run this in a separate terminal while using Claude Code.
+Run this in a separate terminal while using Claude Code. Press `?` inside the TUI any time for in-app help.
 
 ## What it shows
 
@@ -24,29 +24,35 @@ AgentHUD reads Claude Code's session files from `~/.claude/projects/` and displa
 
 ```
 ┌─ Sessions ──────────────────────────────────────────────┐
-│ > agenthud                                              │
-│     sub-agent: code-reviewer                            │
-│   myproject                                             │
-│   dotfiles                                              │
+│ > 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:45] ○ Read  src/ui/App.tsx                       │
-│ [10:23:46] ~ Edit  src/ui/App.tsx                       │
-│ [10:23:47] $ Bash  npm test                             │
-│ [10:23:50] < Response  Tests passed successfully        │
-│ [10:23:51] … Thinking  Analyzing the test results...    │
+│ [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)**
-- All Claude Code sessions across all projects
-- Sub-agents shown nested under their parent session
-- Live indicator on currently active session
+- Sessions grouped under their project (project name + path at the top).
+- Session rows show short ID + first user prompt (the session's "topic").
+- 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 activity feed for the selected session
-- File reads, edits, bash commands, responses, thinking blocks
-- Automatically tails the live session; press `g` to scroll back to top
+- Real-time feed for the selected session: file reads, edits, bash, responses, thinking, git commits.
+- 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`.
 
 ## Activity types
 
@@ -61,61 +67,66 @@ AgentHUD reads Claude Code's session files from `~/.claude/projects/` and displa
 | `<` | Response | Claude's text response |
 | `>` | User | Your message |
 | `…` | Thinking | Claude's thinking (requires `showThinkingSummaries: true`) |
+| `◆` | Commit | Git commit in the project (when `--with-git` or in viewer) |
 
 ## Keyboard shortcuts
 
+Full reference is also available inside the app — press `?`.
+
 ### Session tree focus
 
 | Key | Action |
 |-----|--------|
-| `↑` / `k` | Select previous session |
-| `↓` / `j` | Select next session |
-| `↵` | Expand / collapse sub-agents |
-| `h` | Hide session or sub-agent |
-| `Tab` | Switch to activity viewer |
+| `↑` / `k` | Move up |
+| `↓` / `j` | Move down |
+| `↵` | Expand/collapse project, session, or sub-agent summary |
+| `h` | Hide selected (project / session / sub-agent) |
+| `Tab` | Switch focus to activity viewer |
 | `PgUp` / `Ctrl+B` | Page up |
 | `PgDn` / `Ctrl+F` | Page down |
-| `r` | Refresh |
+| `r` | Refresh now |
+| `?` | Help |
 | `q` | Quit |
 
 ### Activity viewer focus
 
 | Key | Action |
 |-----|--------|
-| `↑` / `k` | Scroll up |
-| `↓` / `j` | Scroll down |
-| `g` | Jump to top |
-| `G` | Jump to bottom (live) |
-| `↵` | Open detail view |
-| `s` | Save log to `~/.agenthud/logs/` |
-| `Tab` | Switch to session tree |
+| `↑` / `k` | Scroll one line up |
+| `↓` / `j` | Scroll one line down |
 | `PgUp` / `Ctrl+B` | Page up |
 | `PgDn` / `Ctrl+F` | Page down |
-| `Ctrl+U` | Half page up |
-| `Ctrl+D` | Half page down |
+| `Ctrl+U` / `Ctrl+D` | Half page up / down |
+| `g` | Jump to live (newest) |
+| `G` | Jump to oldest |
+| `↵` | Open detail view |
+| `f` | Cycle filter preset |
+| `s` | Save log to `~/.agenthud/logs/` |
+| `Tab` | Switch focus to session tree |
+| `?` | Help |
 | `q` | Quit |
 
-### Detail view (full content)
-
-Press `↵` on any activity to open a scrollable full-content view.
+### Detail view
 
 | Key | Action |
 |-----|--------|
-| `↑` / `k` | Scroll up |
-| `↓` / `j` | Scroll down |
+| `↑` / `k` / `↓` / `j` | Scroll |
 | `↵` / `Esc` / `q` | Close |
 
 ## Report
 
-Print a Markdown summary of all activity on a given date, suitable for piping to scripts or LLMs:
+Print activity for a date in Markdown or JSON — suitable for piping to scripts or LLMs:
 
 ```bash
-agenthud report                          # today
-agenthud report --date 2026-05-14        # specific date
-agenthud report --date today --include all  # all activity types
+agenthud report                                      # today (Markdown)
+agenthud report --date 2026-05-14                    # specific date
+agenthud report --date today --include all           # all activity types
+agenthud report --format json                        # JSON output
+agenthud report --detail-limit 0                     # no truncation (full text)
+agenthud report --with-git                           # merge git commits into timeline
 ```
 
-Output is written to stdout in Markdown format:
+Output:
 
 ```
 # AgentHUD Report: 2026-05-14
@@ -125,43 +136,69 @@ Output is written to stdout in Markdown format:
 [10:23] $ npm test
 [10:35] ~ src/ui/App.tsx
 [11:15] < Added spinner hook to make the UI feel alive.
+[14:30] ◆ abc1234 feat: fix auth callback
 ```
 
-**`--include` types:** `response`, `bash`, `edit`, `thinking`, `read`, `glob`, `user`  
-Default: `response,bash,edit,thinking`
+**Options:**
+
+| Flag | Default | Description |
+|------|---------|-------------|
+| `--date` | today | `YYYY-MM-DD` or `today` (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 |
+| `--with-git` | off | Merge git commits from each session's project into the timeline |
+
+`--include` types: `response`, `bash`, `edit`, `thinking`, `read`, `glob`, `user`
 
 ## Summary
 
 Generate an LLM-based summary of a day's activity using the `claude` CLI:
 
 ```bash
-agenthud summary                          # today
-agenthud summary --date 2026-05-14        # past date (cached on second run)
-agenthud summary --date 2026-05-14 --force # ignore cache
-agenthud summary --prompt "커밋만 요약해"  # override prompt
+agenthud summary                            # today (always regenerated)
+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
 ```
 
-Results are saved to `~/.agenthud/summaries/YYYY-MM-DD.md`. Past dates are cached and returned instantly on re-run. Today's date is always regenerated since activity is still growing.
+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).
 
-**Prompt customization:** The summary uses `~/.agenthud/summary-prompt.md`, which is auto-created from a built-in template on first run. Edit it freely or override per-call with `--prompt`.
+**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`.
 
-**Requires:** [`@anthropic-ai/claude-code`](https://www.npmjs.com/package/@anthropic-ai/claude-code) installed and authenticated (`npm i -g @anthropic-ai/claude-code`).
+**Requires:** [`@anthropic-ai/claude-code`](https://www.npmjs.com/package/@anthropic-ai/claude-code) installed and authenticated.
 
 ## Configuration
 
-Optional. Create `~/.agenthud/config.yaml`:
+`~/.agenthud/config.yaml` is auto-created on first run with sensible defaults. Edit it freely:
 
 ```yaml
-refreshInterval: 2s       # How often to poll for updates (default: 2s)
-logDir: ~/.agenthud/logs  # Where to save logs with 's' key
-
-# Sessions/sub-agents to hide from the tree
-hiddenSessions:
-  - old-project
-hiddenSubAgents:
-  - code-reviewer
+# 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.
+filterPresets:
+  - []
+  - ["response"]
+  - ["commit"]
 ```
 
+App-managed state (hidden items) lives separately in `~/.agenthud/state.yaml` so your config file stays clean. You shouldn't need to edit it manually — use `h` in the TUI to hide things.
+
+## Files
+
+| Path | Purpose |
+|------|---------|
+| `~/.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) |
+
 ## Environment Variables
 
 | Variable | Default | Description |

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