Added

• Add default-off Skills and MCP activity lines, with sanitized active names and Skill-tool suppression when the Skills line is enabled (#527, #595).
• Add optional advisor model display with sanitized transcript-derived and override labels (#573).
• Add display.autoCompactWindow support for context denominator calculations, including token-display denominator handling (#589).

Fixed

• Render external balance_label values alongside stdin rate_limits instead of treating them as mutually exclusive (#598, #599).
• Preserve inherited terminal width in setup-generated statusline commands before probing /dev/tty, fixing narrow-pane wrapping/flicker in terminals without a controlling TTY (#581).
• Use a lightweight Windows Node launcher for PowerShell/cmd setup instead of a PowerShell wrapper on every statusline refresh, reducing Windows render-time overhead while preserving update discovery (#555).
• Collapse whitespace in multiline Bash tool targets before truncation so the tools line stays single-line (#594).
• Harden advisor, Skills, and MCP labels against control characters, terminal escapes, bidi controls, and oversized activity names (#573, #595).
• Validate autoCompactWindow as an integer before using it in context calculations (#589).

Changed

• Clarify in release docs that .claude-plugin/plugin.json is the Claude Code update/cache version source (#591).

Dependencies

• Bump @types/node from 25.9.1 to 25.9.2 (#593).
• Refresh the lockfile to clear the transitive brace-expansion audit advisory.

Added

• Effort-level display in the model bracket (#471).
• Native stdin cost.total_cost_usd support, external usage snapshot fallback, prompt-cache countdown, and optional JSON snapshots for stdin rate_limits (#381, #477, #478, #570).
• Vertex AI provider detection with cost estimation disabled for Vertex sessions (#479).
• Usage display controls for reset labels, absolute/relative reset times, compact display, remaining mode, elapsed/percentage mode, and third-party balance labels (#415, #421, #433, #536, #541, #572).
• Layout and configuration controls for expanded merge groups, wrapped branch display, terminal width fallbacks, /add-dir workspace directories, progress bar colors, tool name wrapping/truncation, and custom line placement (#474, #476, #501, #502, #505, #571, #575).
• Session start date, last response timestamp, and Skill tool target display (#497, #537).

Changed

• Setup is more defensive around marketplace install paths, Windows runtime guidance, Git Bash/MSYS routing, existing statusline backups, and PowerShell wrapper generation (#399, #473, #532, #538, #546, #567).
• Rendering now handles narrow terminals, unknown terminal widths, CJK ambiguous-width glyphs, branch links, progress-label padding, OSC 8 hyperlinks, and tool wrapping more consistently (#427, #439, #443, #489, #509, #518, #561, #571).
• Chinese documentation was added and later synced with the English README (#435, #557).

Fixed

• Bounded stdin reads to prevent statusline hangs (#378).
• Context and cache behavior for initial zero-percent frames, post-compact resets, live zero-percent usage, nonzero token totals with zero usage, and fallback todo rendering (#430, #460, #492, #508, #579).
• Transcript and task state handling for default subagent labels, duplicate-content TodoWrite task IDs, background-agent timing, stale transcript agent caches, and adjacent session usage deduplication (#455, #456, #515, #560, #579).
• Git and render correctness for renamed files, quoted arrow filenames, Unicode paths, line diffs, and OSC link truncation (#451, #543, #561).
• Platform-specific behavior for Bedrock provider labels, Linux memory parsing, Windows console flashes, unsafe progress-bar code points, and PowerShell setup output (#468, #523, #567).
• Speed and cost display edge cases, including native cost fallback, speed cache scoping, short-window accumulation, Claude Haiku 4.x pricing, enterprise aliases, and effort schema changes (#440, #453, #486, #491, #496).
• Windows + PowerShell /claude-hud:setup now writes a statusline.ps1 wrapper with a guarded width fallback and corrected version-directory glob (#521).
• Added Windows PowerShell 5.1 guidance for writing settings.json without a UTF-8 BOM.

Dependencies

• Bumped TypeScript and @types/node development dependencies across the 0.1.0 cycle (#383, #426, #465, #533, #554, #565).

Added

• Chinese (zh) HUD labels as an explicit opt-in, while keeping English as the default.
• Guided language selection in /claude-hud:configure so users can choose English or Chinese without hand-editing JSON.
• Offline estimated session cost display via display.showCost for 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_limits fields. 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 gh compatibility 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 as Agent, 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.

Added

• Configurable HUD color overrides, including named presets, 256-color indices, and hex values.
• display.customLine support 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-file installs without inheriting project environment files.
• Usage display now prefers Claude Code stdin rate_limits data 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 429 or 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.

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 + bash environments (#121, #148).
• Bedrock startup model labels now normalize known model IDs when model.display_name is missing (#137).
• Usage API reliability improvements for proxy and OAuth token-refresh edge cases:
  • Respect HTTPS_PROXY/ALL_PROXY/HTTP_PROXY with NO_PROXY bypass.
  • Preserve usage and plan display when keychain tokens refresh without subscriptionType metadata.
  • Reduce false timeout/403 usage warnings in proxied and high-latency environments (#146, #161, #162).
• Render output now preserves regular spaces instead of non-breaking spaces to avoid vertical statusline rendering issues on startup (#142).