Skip to content

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:setup and claude-hud:configure skills confirmed active on work laptop