jarrodwatts/claude-hud
49.4
Weak · 13 November 2026
8k
lines of production code
TypeScript
with JavaScript
7
measurements over time
What this system is
Features
Add i18n support for Simplified and Traditional Chinese
The application now supports Simplified Chinese (zh-Hans) and Traditional Chinese (zh-Hant) in addition to English. This change introduces a new internationalization layer in src/i18n that maps language tags (including aliases like 'zh' and 'zh-TW') to canonical locales, provides translated strings for UI labels, status messages, and time formats, and includes a helper for placeholder interpolation to handle layout differences between languages.
src/i18n · high confidence
Introduce Claude HUD v2 status line with comprehensive configuration and security hardening
This change introduces the core source files for the Claude HUD v2 status line, replacing the previous implementation with a modular architecture. It adds a robust configuration system (src/config.ts) supporting extensive customization of the HUD layout, colors, and display modes (e.g., model format, effort level, time format). The update includes new modules for authentication derivation (src/auth.ts), cost estimation with native stdin support (src/cost.ts), daily cumulative cost tracking (src/daily-cost.ts), and context caching (src/context-cache.ts). Security is significantly hardened through input sanitization for display text, strict validation of config keys, secure file permissions for cache/ledger files, and opt-in requirements for potentially risky features like extra commands. The diff also adds support for Git status display, MCP server counting, and improved handling of Claude Code stdin data, including effort levels and model pricing.
src · high confidence
Introduce auth info display and config directory resolution
The HUD now displays the current authentication method and user account in the status line, with the auth segment formatted according to configurable display settings (showAuth, showAuthUser, authUserLength). To support this, the system resolves the Claude config directory path, supporting the CLAUDE\_CONFIG\_DIR environment variable and tilde expansion, and caches the derived auth info against the config file's identity (mtime, size, etc.) to minimize read overhead on every interaction tick. Also in this area: 1 commit (0 fixes) modifying (repo-wide); Add agent effort display and formatting options; Clarifies Claude Code config file location and path resolution.
dist · medium confidence · unverified
New terminal formatting and security utilities
Added a suite of utility functions in src/utils to improve terminal output and security. format.ts provides human-readable token counts and context-window display formatting. hyperlinks.ts and sanitize.ts introduce safe hyperlink generation with strict protocol validation (allowing only https: and file:) and text sanitization to strip dangerous control characters, ANSI escapes, and bidirectional overrides, preventing escape injection and layout corruption. terminal.ts adds robust terminal width detection (prioritizing the COLUMNS environment variable) and adaptive progress bar sizing. truncate.ts offers a simple string truncation helper with ellipsis support. Also in this area: 1 commit (0 fixes) modifying (repo-wide); Preserve grapheme boundaries when truncating activity labels; New labels and formatting for usage metrics.
src/utils · medium confidence · unverified
Redesigned statusline with configurable layouts and elements
The HUD statusline has been completely redesigned to support two distinct display modes: a compact single-line layout and an expanded multi-line layout where each element (such as context usage, token counts, git status, and agent activity) can be individually toggled, reordered, and merged. Users can now customize the appearance with configurable colors (including 256-color and hex values), adjust element ordering via \projectLineOrder\ and \elementOrder\, and control visibility of specific components like skills, MCPs, and todos. The new rendering engine also improves terminal width handling, CJK character support, and hyperlink truncation to prevent layout breakage.
src/render · high confidence
Removals
Removal of legacy TUI entry point
The main TUI entry point file (tui/src/index.tsx) has been deleted. This removes the previous implementation of the Claude HUD interface, including its event processing logic for tools, agents, and context, as well as the command-line argument handling for session and FIFO paths.
tui/src · high confidence
Removal of legacy TUI event reading and type definitions
The \event-reader.ts\ module, which previously handled reading HUD events from a named pipe (FIFO) and emitting them, has been removed. Additionally, the \types.ts\ file containing the \HudEvent\, \ToolEntry\, \TodoItem\, \ModifiedFile\, \AgentEntry\, \ContextState\, and \AppState\ interfaces has been deleted. This change eliminates the underlying data structures and the file-based event ingestion mechanism used by the TUI component.
tui/src/lib · high confidence
Removal of legacy TUI status components
The AgentList, ContextMeter, McpStatus, ModifiedFiles, TodoList, and ToolStream components have been removed from the TUI. These components previously displayed real-time status information such as agent states, context token usage, MCP server connections, modified files, todo items, and tool execution streams. Their removal indicates a shift away from this specific inline status display approach in the terminal user interface.
tui/src/components · high confidence
Behavioural changes
236 commits (41 fixes) modifying (repo-wide)
A change to existing behaviour in (repo-wide) — 236 commits (41 fixs), 18 files: “feat(git): add opt-in gitStatus.showWorktree indicator (\#781)”; “refactor: trust Claude Code stdin and gather data before rendering (\#788)”; “fix(setup): harden Windows runtime guidance (\#473)”; and 231 more (refs \#781, \#788, \#473, \#674, \#663, …).
(repo-wide) · low confidence · unverified
3 commits (0 fixes) modifying verify
A change to existing behaviour in verify — 3 commits, 14 files: “Agent-native claude-hud (\#850)”; “collector: git never reaches the network, and skips repo filters it can't name (\#854)”; “gate: the owner may edit a fixture; the bot and contributors still can't (\#853)” (refs \#850, \#854, \#853).
maintainer, verify · medium confidence · unverified
Refactored session management and build cleanup scripts
The build process now includes a dedicated script to safely clean the distribution directory, ensuring no stale artifacts remain. Concurrently, the legacy shell-based session management scripts (session-start, capture-event, cleanup) have been removed, indicating a shift away from the previous FIFO-based event capture and terminal-splitting logic implemented in these files.
scripts · high confidence
Test coverage
Added comprehensive test coverage for core HUD modules
Added new test suites for the ANSI rendering engine (handling wide characters, OSC 8 links, and wrapping), authentication info derivation and caching, config validation and merging, daily cost ledger management, external usage snapshot I/O, extra-command execution, and reset time formatting. These tests verify correct behavior for edge cases such as CJK character width, link truncation, config sanitization, and ledger recovery.
tests · high confidence
Dependencies
Initial release of Claude HUD with updated dev dependencies
This change introduces the initial version (0.8.0) of the 'claude-hud' package, a real-time statusline HUD for Claude Code. It establishes the project's dependency tree, specifying a Node.js engine requirement of \>=18.0.0 and updating development dependencies to @types/node ^26.2.0, c8 ^11.0.0, and TypeScript ^7.0.2. Additionally, the legacy 'tui' sub-package (claude-hud-tui) and its associated dependencies (ink, react, minimist) have been removed from the repository.
(dependencies) · high confidence
Written by cca.canine.dev from the codebase's own history, inside the signed delivery this page is composed from.
How this codebase got here
This is the PUBLIC form of this artifact. Findings are listed in full, but the details of SECURITY findings — which rule fired, in which file, on which line, and how to fix it — are deliberately withheld, and any secret-scanner results are excluded entirely. Where detail is absent here it was REMOVED FOR PUBLICATION; it is not missing from the analysis. The complete artifact is available from the repository owner.
Score
- CAI 68 → 49 (-18.8)
- Rubric changed (rubric-2026.10.5 → rubric-2026.11.3) — scores are not directly comparable.
Lenses
- Code Health 70 → 59 (-11.2)
- Architecture 96 → 97 (+0.6)
- Maturity 63 → 75 (+12.4)
- Readiness 67 → 37 (-29.6)
- Security 78 → 48 (-29.2)
- Performance 100 → 85 (-15.0)
Resolved (25)
- High CVE: [GHSA redacted] (package-lock.json)
- High: security finding (details withheld)
- High: security finding (details withheld)
- High: security finding (details withheld)
- High: security finding (details withheld)
- High: security finding (details withheld)
- High: security finding (details withheld)
- High: security finding (details withheld)
- High: security finding (details withheld)
- High: security finding (details withheld)
- High: security finding (details withheld)
- Hotspot: src/index.ts (src/index.ts)
- Medium: security finding (details withheld)
- Medium: security finding (details withheld)
- Medium: security finding (details withheld)
- No SBOM
- No artifact signing
- No build provenance
- Off-boarding risk: anonymized user #1
- PR-triggered workflow without a permissions block (.github/workflows/ci.yml)
- …and 5 more
New (54)
- Change coupling: en.ts ↔ zh-Hans.ts (src/i18n/en.ts)
- FileTooLong: src/config.ts (src/config.ts)
- High: security finding (details withheld)
- High: security finding (details withheld)
- High: security finding (details withheld)
- High: security finding (details withheld)
- High: security finding (details withheld)
- High: security finding (details withheld)
- High: security finding (details withheld)
- High: security finding (details withheld)
- High: security finding (details withheld)
- High: security finding (details withheld)
- High: security finding (details withheld)
- High: security finding (details withheld)
- High: security finding (details withheld)
- High: security finding (details withheld)
- High: security finding (details withheld)
- High: security finding (details withheld)
- High: security finding (details withheld)
- High: security finding (details withheld)
- …and 34 more
Changes since last survey
- 28 commits — 25 feature/other, 3 fixes
By area
- (root) — 17 commits
- dist/render — 3 commits
- (repo) — 1 commit
- .github/workflows — 1 commit
- commands/setup.md — 1 commit
- dist/utils — 1 commit
- src/config-reader.ts — 1 commit
- src/render — 1 commit
- src/utils — 1 commit
- tests/golden — 1 commit
Notable commits
- fix: fix(setup): find installs under CLAUDE_CODE_PLUGIN_CACHE_DIR (#838)
- fix: fix: cut every untrusted label on a grapheme boundary (#830)
- fix: fix: open file links to non-ASCII paths on Windows (#840)
- change: Agent-native claude-hud (#850)
- change: Changed files: list them in git's order (#857)
- change: Release v0.13.1 (#831)
- change: Release v0.14.0 (#837)
- change: Release v0.14.1 (#841)
- change: Release v0.14.2 (#843)
- change: Release v0.15.0 (#855)
- change: Release v0.15.1
- change: Release v0.15.2
- change: Release v0.15.3
- change: Rules count: a link that can't be read skips only itself (#857)
- change: build(deps-dev): bump @types/node from 26.6.5 to 26.6.6 (#842)
- change: build: compile dist/ [auto]
- change: build: compile dist/ [auto]
- change: build: compile dist/ [auto]
- change: ci: push dist/ with a deploy key and build read-only (#845)
- change: collector: git never reaches the network, and skips repo filters it can't name (#854)
- …and 8 more
Written by cca.canine.dev from the codebase's own history, inside the signed delivery this page is composed from.
Survey your own repository
jarrodwatts/claude-hud was measured the same way every project in this corpus was: the same rubric, at a pinned commit, with the result published in full. Point a surveyor at a repository you know and see whether you agree with it.
About this page
- The score is its most recent published measurement, taken on 13 November 2026 at a pinned commit. It is not a live figure and does not change until the project is measured again.
- Measured at commit 9d2b6fa4df43c8ced61c0c23956fd291551726ac — the exact code this score is about.
- Scored under rubric-2026.11.3 — the same rubric and the same method as every other entry in this index.
- Measured by Canine Code Analyzer (cca.canine.dev) using cca measure-2026.11.63+preprod-4a8cc97a9484.