Skip to content
CAI
Software that uses CAICheck a score

jarrodwatts/claude-hud

49.4

Weak · 13 November 2026

8k

lines of production code

TypeScript

with JavaScript

7

measurements over time

CAI band scale
CAI trend line
CAI lens gauges

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.