This release includes 2 breaking changes for platform teams planning a safe upgrade.
Published 1mo
Developer Productivity
✓ No known CVEs patched
✓ No known CVEs patched in this version
Topics
agent
ai-agent
anthropic
claude
claude-code
claude-code-cli
+12 more
claude-code-tui
cli
coding-agent
web
developer-tools
digest
live-monitor
llm
monitor
observability
session-monitor
tui
Summary
AI summaryProject‑grouped session tree, new CLI summary command, in‑app help overlay, git commit integration, and configurable hidden projects are introduced.
Full changelog
New
- Project-grouped session tree — Sessions are now grouped under their project (project name + path at the top). Session rows show short ID + first user prompt instead of redundant project name.
agenthud summarycommand — Generate LLM summary of daily activity viaclaude -p. Cached at~/.agenthud/summaries/YYYY-MM-DD.md. Options:--date,--prompt,--force. Editable prompt template at~/.agenthud/summary-prompt.md.- In-app help (
?key) — Full-screen help overlay listing all shortcuts, CLI commands, and file locations. - Activity filter (
fkey) — Cycle through filter presets (configurable inconfig.yaml). - Git commits in viewer + report —
◆commit entries appear in the activity timeline.--with-gitflag forreport. Press↵on a commit to seegit show --stat. agenthud reportformats —--format jsonfor machine-readable output,--detail-limit Nfor truncation control.hiddenProjectsconfig — Hide entire projects from the tree viahkey.- Cold projects collapse — Projects where all sessions are cold collapse into a single
... N cold projectsrow at the bottom. - Non-interactive sessions visualized — Sessions from
claude -p/ SDK shown in parens and dimmed. CLAUDE_PROJECTS_DIRenv var — Override the Claude projects directory.
Changed
- Config / state split —
~/.agenthud/config.yamlholds user settings;~/.agenthud/state.yamlholds app-managed hidden items. Auto-migrates on first run. - Cold sessions and projects default collapsed — Inverse expansion: alive items default expanded (Enter collapses), cold items default collapsed (Enter expands).
agenthud summaryruns from~/.agenthud/— Avoids polluting user's working project with summary session files.- Newlines preserved in detail view — Multi-line responses/thinking/prompts display with proper line breaks (previously flattened to single line).
- Viewer cursor/scroll preserved on refresh — fs.watch updates no longer reset the viewer position.
- g/G keys swapped —
g= live (newest, top),G= oldest (bottom) — matches vim visual convention. getDisplayWidthcached — ~17% CPU reduction by memoizing repeated stringWidth calls.
Fixed
- Memory leak —
NODE_ENV=productionby default to stop React dev-mode profiler accumulating PerformanceMeasure objects (~600KB/s leak → ~50KB/s). - Git access via
--git-dir— Only.gitneeds to be accessible (works with mounted backups). - Sub-agent navigation snap — Arrow keys recover gracefully when sub-agent disappears from flat list.
- Time displayed in local timezone — Report and viewer use local time instead of UTC.
- Ctrl+F no longer triggers filter —
fkey only fires without Ctrl modifier.
Breaking Changes
- `g` and `G` key bindings swapped (g = newest, G = oldest)
- Config/state split: user settings now in `~/.agenthud/config.yaml`, app‑managed hidden items in `~/.agenthud/state.yaml` (auto‑migration on first run)
Weekly OSS security release digest.
The CVE patches and breaking changes that affected production tools this week. One email, every Sunday.
No spam, unsubscribe anytime.
Share this release
About AgentHUD
All releases →Related context
Related tools
Earlier breaking changes
- v0.14.0 `h` key now aliases vim-left (←) instead of hide.
Beta — feedback welcome: [email protected]