claude-hud

Real-time statusline HUD for Claude Code - context health, tool activity, agent tracking, and todo progress

CLEARED_STATICclaude-onlyv0.7.0

Pipeline results

Coverage

CLEARED_STATIC

Tests run

7 / 8

Portability

Claude-only

Type

Commands

Tests & results

What the pipeline checked

TestStateResult or reason

eligibilityranall eligibility checks passed

dedupranunique -- no near-duplicate found

clocran34641 code lines / 248 files

secretsranno secret patterns matched

egressran20 lexical match(es) — FLAG-INFO (C-01: semantic analysis deferred to v2)

injectionranno patterns matched (confidence: STANDARD)

required-fieldsranrequired fields present: name, version, description

behaviouraldeferredbehavioural assessment deferred (v1): 15 JS/TS entry point(s)

What's inside

Components found

commands/configure.md

componentmedium

commands/setup.md

componentlow

Coverage

Not assessed

behavioural execution not run
egress patterns logged (FLAG-INFO): 20 lexical match(es)

README

From the repository

# Claude HUD

A Claude Code plugin that shows what's happening — context usage, active tools, running agents, and todo progress. Always visible below your input.

[![License](https://img.shields.io/github/license/jarrodwatts/claude-hud?v=2)](LICENSE)
[![Stars](https://img.shields.io/github/stars/jarrodwatts/claude-hud)](https://github.com/jarrodwatts/claude-hud/stargazers)

![Claude HUD in action](claude-hud-preview-5-2.png)

> 🌐 English | [中文文档](README.zh.md)

## Install

Inside a Claude Code instance, run the following commands:

**Step 1: Add the marketplace**
```
/plugin marketplace add jarrodwatts/claude-hud
```

**Step 2: Install the plugin**


⚠️ Linux users: Click here if install fails with an EXDEV error

On older Claude Code versions, `/tmp` being a separate filesystem (tmpfs) caused plugin installation to fail with:
```
EXDEV: cross-device link not permitted
```

This [Claude Code bug](https://github.com/anthropics/claude-code/issues/14799) has since been fixed — if you hit it, update Claude Code first. If you can't update, set TMPDIR before installing:
```bash
mkdir -p ~/.cache/tmp && TMPDIR=~/.cache/tmp claude
```

Then run the install command below in that session.

…

← Back to Commands