Claude HUD session stats display¶
- Date: 2026-04-21
- Status: Accepted
- Tags:
tooling
Context¶
Long Claude Code sessions can consume large amounts of tokens without clear visibility. Without real-time stats, it is easy to overshoot budget limits or miss runaway tool call loops. A heads-up display showing token usage, tool call counts, and elapsed time would help pace sessions and inform decisions about when to compress or restart.
Decision¶
Install the claude-hud plugin on the work laptop. It displays session stats (tokens used, tool calls, time elapsed) inline during Claude Code sessions, providing real-time visibility into resource consumption.
Alternatives Considered¶
| Option | Why Rejected |
|---|---|
| Manually tracking token usage via API dashboard | Requires context switching; not real-time |
| Post-session token audits | Too late to course-correct during a session |
| Custom hook to log token counts | More maintenance than a purpose-built plugin |
Consequences¶
Positive:
- Real-time visibility into token burn rate
- Easier to decide when to compress or start a new session
Negative / Trade-offs:
- Adds visual noise to the session output
- Community plugin — may lag behind Claude Code updates
Ongoing obligations:
- ✅ Validated 2026-04-21 —
claude-hud:setupandclaude-hud:configureskills confirmed active on work laptop