agenthud 0.11.4 → 0.12.2

package/README.md

@@ -24,27 +24,37 @@ npx agenthud
 
 Run this in a separate terminal while using Claude Code. Press `?` inside the TUI any time for in-app help.
 
+> **Platform support.** Primary development is on macOS and Linux; the full test suite runs on all three platforms in CI (including Windows). Windows runtime behavior is exercised by a manual smoke job but isn't daily-driven — issues there are valued bug reports.
+
+Pass `--cwd` to scope the view to the Claude project that contains your current directory — useful when you have many projects but only care about the one you're in right now. Exits 1 with a stderr message if no such project is registered.
+
+```bash
+agenthud           # all Claude projects on the machine
+agenthud --cwd     # only the project containing the current dir
+agenthud --once    # print one frame and exit (no alt-screen)
+```
+
 ## Live monitor
 
 AgentHUD's TUI splits the screen into a project tree and an activity viewer:
 
 ```
-┌─ 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            │
+┌─ 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] ⠧ Edit  src/auth/oauth.ts  ← bold + spinner = live │
-└──────────────────────────────────────────────────────────┘
+└────────────────────────────────────────────────────────────┘
 ```
 
 **Project tree (top pane)**
@@ -100,6 +110,7 @@ Full reference is also available inside the app — press `?`.
 |-----|--------|
 | `↑` / `k` | Move up |
 | `↓` / `j` | Move down |
+| `←` | Jump to parent (sub-agent → session, session → project) |
 | `↵` | Expand/collapse project, session, or sub-agent summary |
 | `h` | Hide selected (project / session / sub-agent) |
 | `Tab` | Switch focus to activity viewer |
@@ -180,7 +191,7 @@ Output:
 | Flag | Default | Description |
 |------|---------|-------------|
 | `--date` | today | `YYYY-MM-DD`, `today`, `yesterday`, or `-Nd` (N days ago, local date) |
-| `--include` | `response,bash,edit,thinking` | Comma-separated types or `all` |
+| `--include` | `user,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 |
@@ -204,11 +215,27 @@ 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
 
+# Tune what gets sent to the LLM — same option shape as `report`
+agenthud summary --include all                      # include every activity type
+agenthud summary --detail-limit 200                 # truncate long tool outputs
+agenthud summary --with-git                         # include git commits (default in config)
+# Defaults are CLI flag → `summary:` config → `report:` config → built-in.
+
 # 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
+
+# Open the resulting summary in your OS default app (browser, VS Code, etc.)
+agenthud summary --last 7d --open                   # -o is the short form
+
+# Open the index (~/.agenthud/summaries/index.md) instead — a hub
+# listing every daily and range summary, grouped by year/month.
+agenthud summary --open-index                       # -I is the short form
+agenthud summary -oI                                # open today + the index
 ```
 
+The index is auto-regenerated whenever a summary writes, and each summary file gets a one-line backlink footer at the top (`← all summaries · ← prev · next →`) so any markdown viewer is enough to navigate the whole corpus without leaving the file.
+
 **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.
@@ -240,8 +267,24 @@ filterPresets:
   - ["all"]
   - ["response", "user"]
   - ["commit"]
+
+# Defaults for `agenthud report` (CLI flags still win per-invocation).
+report:
+  include: [user, response, bash, edit, thinking]
+  detailLimit: 120
+  withGit: false
+  format: markdown
+
+# Defaults for `agenthud summary`. Any field omitted here is inherited
+# from `report` above. `model` is summary-specific.
+summary:
+  withGit: true
+  detailLimit: 0
+  # model: sonnet
 ```
 
+`report` / `summary` resolve each option as **CLI flag → `summary:` key → `report:` key → built-in default**. The effective set is printed to stderr at the start of each run (e.g. `agenthud: report → include=[user,response,bash,edit,thinking] detail-limit=120 with-git=off format=markdown`), so the actual values are always visible.
+
 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
@@ -254,6 +297,7 @@ App-managed state (hidden items) lives separately in `~/.agenthud/state.yaml` so
 | `~/.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 |
+| `~/.agenthud/summaries/index.md` | Auto-regenerated hub linking every summary; each summary also gets a backlink footer at the top |
 
 ## 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-WAT4DY4T.js");
+import("./main-YCUCY2QP.js");