Agent skill · software engineering · aradotso
claude-hud-statusline
A Claude Code plugin that displays a real-time HUD showing context usage, active tools, running agents, and todo progress in your terminal statusline.
Why this skill is useful
Adds real-time monitoring capabilities for context usage and tool activity that the AI wouldn't generate on its own.
What it needs
Requires bun, node installed locally. About 5k tokens when loaded. Last updated 2026-07-09. 70 stars on the source repository.
What this skill does
Claude HUD Skill by ara.so — Daily 2026 Skills collection. Claude HUD is a Claude Code plugin that adds a persistent statusline to your terminal showing real-time context window usage, active tool calls, running subagents, and todo progress — always visible below your input prompt. What It Does Feature Description --------- ------------- Context health Visual bar showing how full your context window is (green → yellow → red) Tool activity Live display of file reads, edits, and searches as they happen Agent tracking Shows which subagents are running and what they're doing Todo progress Real-time task completion tracking Usage limits Claude subscriber rate limit consumption Git status Current branch, dirty state, ahead/behind remote Requirements Claude Code v1.0.80+ Node.js 18+ or Bun Installation Run these commands inside a Claude Code session: Step 1: Add the marketplace Step 2: Install the plugin Linux users: If you get EXDEV: cross-device link not permitted, set TMPDIR first: Step 3: Configure the statusline Windows users: If setup reports no JavaScript runtime, install Node.js LTS first: Step 4: Restart Claude Code to load the new statusLine config. What You See Default 2-line layout With optional lines enabled Configuration Interactive configuration (recommended) This opens a guided flow with preset options: Preset Shows -------- ------- Full Everything — tools, agents, todos, git, usage, duration Essential Activity lines + git, minimal clutter Minimal Model name and context bar only Manual configuration Edit ~/.claude/plugins/claude-hud/config.json directly: Key Configuration Options Layout Path level examples: 1 → [Opus] │ my-project git:(main) 2 → [Opus] │ apps/my-project git:(main) 3 → [Opus] │ dev/apps/my-project git:(main) Context display formats Element ordering (expanded layout) Omit any entry from the array to hide it entirely. …
How to use it
Reference it in AdaL, Claude Code, Cursor or any coding agent — nothing to install:
@skills aradotso/claude-hud-statusline