Compact display: short labels, clock-style reset time, optional balance label

Author: hcrossCreated Sep 17, 2026Updated Sep 17, 2026

Problem

On narrow terminals the expanded usage line is too wide. Three sources of verbosity:

  1. Reset wording: (resets in 3h 32m) — the wording is rarely needed; a clock glyph + duration would do.
  2. Long progress labels: Context, Usage, Weekly — short forms would help.
  3. The external balance label (e.g. Ollama Pro) is always appended when the external snapshot provides one; there is no hard off switch (only the externalBalanceLabelMode gating).

Proposal

All opt-in via ~/.claude/plugins/claude-hud/config.json display.*:

1. display.compactResetTime (boolean, default false)

  • Duration compaction: strip the unit separator and drop the minutes unit when hours are present: 3h 32m3h32, 45m stays 45m, 3d 14h3d14h.
  • Reset suffix becomes (⏰3h32), ignoring showResetLabel wording (the glyph replaces it).
  • Applies to 5h / weekly / scoped windows and the limit-reached line.

2. display.labelOverrides (object, default {})

Map of progress-label key → custom text, e.g.:

json
{ "display": { "labelOverrides": { "context": "Ctx", "usage": "Usg", "weekly": "Wkl" } } }
  • Keys: context, usage, weekly, approxRam.
  • Overrides win over the i18n label; the label-column alignment must measure the overridden text, not the i18n text.

3. display.showBalanceLabel (boolean, default true)

  • false hides the external snapshot balance_label (e.g. Ollama Pro) everywhere it would be appended.

Example target

[Ollama | glm-5.3-flash:cloud]
Ctx █░░░░░░░░ 3% │ Usg █░░░░░░░░ 7% (⏰3h32) | Wkl ████░░░░░░ 36% (⏰3d14h)