Observability Dashboard: `hx dashboard`

[ashigirl96]

Summary

A dashboard (TUI and/or web) that visualizes hook execution history, decisions, latency, and LLM costs.

Motivation

Currently there is no visibility into whether hooks fired, what they decided, or how long they took. Debugging hooks is a black box. Making hook behavior observable is the foundation for trust and iterative improvement.

Proposed CLI

hx dashboard          # TUI dashboard
hx dashboard --web    # open in browser

Key Features

• Execution log: Timeline of hook invocations with event type, matcher, and result
• Decision history: Block / allow / modify decisions with the reason
• Latency tracking: Per-hook execution time, highlight slow hooks
• LLM cost tracking: Token usage and estimated cost for prompt/agent hooks
• Filtering: By extension, event type, date range, decision type
• Live mode: Stream hook events in real-time during a Claude Code session

Implementation Notes

• Hooks write structured log entries (JSONL) to .claude/hooks/logs/
• Dashboard reads and aggregates the log files
• The logger preset from the Built-in Hook Library could serve as the data source