Releases: jarrodwatts/claude-hud
Releases · jarrodwatts/claude-hud
v0.0.12
Added
- Chinese (
zh) HUD labels as an explicit opt-in, while keeping English as the default. - Guided language selection in
/claude-hud:configureso users can choose English or Chinese without hand-editing JSON. - Offline estimated session cost display via
display.showCostfor known Anthropic model families, derived from local transcript token usage only. - Session token totals, output-style display, git push count threshold coloring, configurable model badge formatting, and a custom model override.
- Git file diff rendering with per-file and total line deltas, plus clickable OSC 8 file links where supported.
Changed
- Usage display now relies only on Claude Code's official stdin
rate_limitsfields. Background OAuth usage polling, related cache/lock behavior, and credential-derived subscriber plan labels were removed. - Setup and configure flows now better support simple onboarding: Windows setup prefers Node.js guidance, the GitHub star prompt includes
ghcompatibility guidance, and configure now exposes language as a first-class guided choice. - Plugin detection, config caching, and transcript-derived activity/session metadata are more robust and better covered by tests.
Fixed
- Stabilize Claude Code version cache behavior across resolved binary paths and mtimes, fixing Node 20 CI failures.
- Stop guessing auth mode from environment variables alone.
- Preserve task IDs across
TodoWrite, detect transcript agents recorded asAgent, and improve narrow-terminal wrapping including OSC hyperlink width handling. - Improve macOS memory reporting, config cache invalidation, and fallback rendering when terminal width is unavailable.
- Clarify official usage-data behavior and keep Bedrock/unknown pricing cases hidden rather than showing misleading estimates.
v0.0.10
Added
- Configurable HUD color overrides, including named presets, 256-color indices, and hex values.
display.customLinesupport for a short custom phrase in the HUD.- New opt-in display toggles for session name, combined context mode (
display.contextValue: "both"), Claude Code version, and approximate system RAM usage in expanded layout.
Changed
- Setup and plugin detection now better handle
CLAUDE_CONFIG_DIR, Windows shell quoting, and Bun--env-fileinstalls without inheriting project environment files. - Usage display now prefers Claude Code stdin
rate_limitsdata when available, still falls back to the existing OAuth/cache path, and presents weekly-only/free-user usage more cleanly. - Context percentages and token displays now follow Claude Code's reported context window size, including newer 1M-context sessions, with a lower fallback autocompact estimate that better matches
/context. - Usage text output now keeps the last successful values visible while syncing, shows the 7-day reset countdown when applicable, and clarifies that standard proxy environment variables are the supported way to route Anthropic traffic.
- Progress bars and expanded-layout output now adapt more cleanly to narrow terminal widths.
Fixed
- Setup is more reliable in sessions that previously failed to surface the HUD until Claude Code restarted, and plugin command discovery no longer fails with unknown-skill errors after install.
- Usage handling is more resilient under OAuth token refreshes, proxy tunnels, explicit TLS overrides, zero-byte lock files, stale-cache recovery, and rate-limit edge cases that previously caused repeated
429or syncing failures. - Account-scoped credential lookup and plugin selection are more reliable for multi-account setups and multiple installed plugin versions.
- Expanded-layout rendering now preserves speed, duration, extra labels, and weekly-only usage output correctly.
- Tool execution no longer scrolls the terminal to the top, and transcript reparsing now avoids repeatedly caching partial parse results on large histories.
v0.0.9
Changed
- Add Usage API timeout override via
CLAUDE_HUD_USAGE_TIMEOUT_MS(default now 15s).
Fixed
- Setup instructions now generate shell-safe Windows commands for
win32 + bashenvironments (#121, #148). - Bedrock startup model labels now normalize known model IDs when
model.display_nameis missing (#137). - Usage API reliability improvements for proxy and OAuth token-refresh edge cases:
- Render output now preserves regular spaces instead of non-breaking spaces to avoid vertical statusline rendering issues on startup (#142).