SuperCharged-Claude-Code-Upgrade/skills/plugins/claude-hud/CHANGELOG.md

Changelog

All notable changes to Claude HUD will be documented in this file.

[Unreleased]

---

[0.0.6] - 2026-01-14

Added

• Expanded multi-line layout mode - splits the overloaded session line into semantic lines (#76)
  • Identity line: model, plan, context bar, duration
  • Project line: path, git status
  • Environment line: config counts (CLAUDE.md, rules, MCPs, hooks)
  • Usage line: rate limits with reset times
• New config options:
  • lineLayout: 'compact' | 'expanded' (default: 'expanded' for new users)
  • showSeparators: boolean (orthogonal to layout)
  • display.usageThreshold: show usage line only when >= N%
  • display.environmentThreshold: show env line only when counts >= N

Changed

• Default layout is now expanded for new installations
• Threshold logic uses max(5h, 7d) to ensure high 7-day usage isn't hidden

Fixed

• Ghost installation detection and cleanup in setup command (#75)

Migration

• Existing configs with layout: "default" automatically migrate to lineLayout: "compact"
• Existing configs with layout: "separators" migrate to lineLayout: "compact" + showSeparators: true

---

[0.0.5] - 2026-01-14

Added

• Native context percentage support for Claude Code v2.1.6+
  • Uses used_percentage field from stdin when available (accurate, matches /context)
  • Automatic fallback to manual calculation for older versions
  • Handles edge cases: NaN, negative values, values >100
• display.autocompactBuffer config option ('enabled' | 'disabled', default: 'enabled')
  • 'enabled': Shows buffered % (matches /context when autocompact ON) - default
  • 'disabled': Shows raw % (matches /context when autocompact OFF)
• EXDEV cross-device error detection for Linux plugin installation (#53)

Changed

• Context percentage now uses percentage-based buffer (22.5%) instead of hardcoded 45k tokens (#55)
  • Scales correctly for enterprise context windows (>200k)
• Remove automatic PR review workflow (#67)

Fixed

• Git status: move --no-optional-locks to correct position as global git option (#65)
• Prevent stale index.lock files during git operations (#63)
• Exclude disabled MCP servers from count (#47)
• Reconvert Date objects when reading from usage API cache (#45)

Credits

• Ideas from #30 (@r-firpo), #43 (@yansircc), #49 (@StephenJoshii) informed the autocompact solution

Dependencies

• Bump @types/node from 25.0.3 to 25.0.6 (#61)

---

[0.0.4] - 2026-01-07

Added

• Configuration system via ~/.claude/plugins/claude-hud/config.json
• Interactive /claude-hud:configure skill for in-Claude configuration
• Usage API integration showing 5h/7d rate limits (Pro/Max/Team)
• Git status with dirty indicator and ahead/behind counts
• Configurable path levels (1-3 directory segments)
• Layout options: default and separators
• Display toggles for all HUD elements

Fixed

• Git status spacing: main*↑2↓1 → main* ↑2 ↓1
• Root path rendering: show / instead of empty
• Windows path normalization

Credits

• Config system, layouts, path levels, git toggle by @Tsopic (#32)
• Usage API, configure skill, bug fixes by @melon-hub (#34)

---

[0.0.3] - 2025-01-06

Added

• Display git branch name in session line (#23)
• Display project folder name in session line (#18)
• Dynamic platform and runtime detection in setup command (#24)

Changed

• Remove redundant COMPACT warning at high context usage (#27)

Fixed

• Skip auto-review for fork PRs to prevent CI failures (#25)

Dependencies

• Bump @types/node from 20.19.27 to 25.0.3 (#2)

---

[0.0.2] - 2025-01-04

Security

• Add CI workflow to build dist/ after merge - closes attack vector where malicious code could be injected via compiled output in PRs
• Remove dist/ from git tracking - PRs now contain source only, CI handles compilation

Fixed

• Add 45k token autocompact buffer to context percentage calculation - now matches /context output accurately by accounting for Claude Code's reserved autocompact space
• Fix CI caching with package-lock.json
• Use Opus 4.5 for GitHub Actions code review

Changed

• Setup command now auto-detects installed plugin version (no manual path updates needed)
• Setup prompts for optional GitHub star after successful configuration
• Remove husky pre-commit hook (CI now handles dist/ compilation)

Dependencies

• Bump c8 from 9.1.0 to 10.1.3

---

[0.0.1] - 2025-01-04

Initial release of Claude HUD as a Claude Code statusline plugin.

Features

• Real-time context usage monitoring with color-coded progress bar
• Active tool tracking with completion counts
• Running agent status with elapsed time
• Todo progress display
• Native token data from Claude Code stdin
• Transcript parsing for tool/agent/todo activity