Claude Hud Statusline
Install a Claude Code statusline plugin that shows context window usage, live tool calls, subagents, todos, rate limits, and git state while you code with agents.
Overview
claude-hud-statusline is a journey-wide agent skill that installs and configures the Claude HUD statusline plugin—usable whenever a solo builder needs live context, tool, and agent visibility before committing to long Cl
Install
npx skills add https://github.com/aradotso/trending-skills --skill claude-hud-statuslineWhat is this skill?
- Context health bar (green → yellow → red) for context window fill
- Live tool activity for reads, edits, and searches
- Subagent and todo progress tracking in the statusline
- Claude subscriber usage limits plus git branch/dirty/ahead-behind
- Requires Claude Code v1.0.80+ and Node.js 18+ or Bun; marketplace install via in-session commands
- Claude Code v1.0.80+ required
- Node.js 18+ or Bun runtime
Adoption & trust: 2k installs on skills.sh; 31 GitHub stars; 2/3 security scanners passed (skills.sh audits); trending (+100% hot-view momentum).
What problem does it solve?
You cannot see how full the context window is or what tools and subagents are doing until something fails or the session truncates.
Who is it for?
Claude Code power users who run long tasks, parallel subagents, or tight context budgets and want terminal-native feedback.
Skip if: Developers on Cursor-only or Codex-only workflows without Claude Code, or anyone who does not want a persistent statusline modifying terminal layout.
When should I use this skill?
User asks to install Claude HUD, show context usage, add a statusline, track tools/agents/todos in Claude Code, or configure the HUD display.
What do I get? / Deliverables
After marketplace install and configuration, your terminal shows real-time HUD metrics so you can throttle prompts, watch todos, and monitor git state during agent work.
- Configured Claude HUD statusline in terminal
- Ongoing live metrics for context, tools, agents, todos, git
Recommended Skills
Journey fit
Useful at every journey phase - explore requirements and options before committing to a direction.
Where it fits
Add the marketplace plugin so new feature work always shows context bar color before you paste a huge spec.
Watch live file edits during a code-review agent pass to see which paths changed without scrolling chat.
During incident debugging, monitor subagent fan-out and todo completion so parallel fixes do not duplicate work.
Spike prototypes with visibility into rate limits so you do not burn subscription quota on throwaway experiments.
How it compares
Claude Code terminal plugin skill—not a project APM dashboard or generic log tailer.
Common Questions / FAQ
Who is claude-hud-statusline for?
Solo builders using Claude Code who want a real-time HUD for context usage, tools, subagents, todos, rate limits, and git status without leaving the terminal.
When should I use claude-hud-statusline?
Install during Build agent-tooling setup, keep it on during Ship reviews and long refactors, and during Operate hotfixes when you need context-window warnings; also when onboarding to Claude Code or tuning display options.
Is claude-hud-statusline safe to install?
It is a display plugin for Claude Code; review the Security Audits panel on this Prism page and only add marketplaces you trust before running in-session install commands.
SKILL.md
READMESKILL.md - Claude Hud Statusline
# Claude HUD > Skill by [ara.so](https://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** ``` /plugin marketplace add jarrodwatts/claude-hud ``` **Step 2: Install the plugin** ``` /plugin install claude-hud ``` > **Linux users**: If you get `EXDEV: cross-device link not permitted`, set TMPDIR first: > ```bash > mkdir -p ~/.cache/tmp && TMPDIR=~/.cache/tmp claude > ``` **Step 3: Configure the statusline** ``` /claude-hud:setup ``` > **Windows users**: If setup reports no JavaScript runtime, install Node.js LTS first: > ```powershell > winget install OpenJS.NodeJS.LTS > ``` **Step 4: Restart Claude Code** to load the new `statusLine` config. ## What You See ### Default 2-line layout ``` [Opus] │ my-project git:(main*) Context █████░░░░░ 45% │ Usage ██░░░░░░░░ 25% (1h 30m / 5h) ``` ### With optional lines enabled ``` [Opus] │ my-project git:(main*) Context █████░░░░░ 45% │ Usage ██░░░░░░░░ 25% (1h 30m / 5h) ◐ Edit: auth.ts | ✓ Read ×3 | ✓ Grep ×2 ◐ explore [haiku]: Finding auth code (2m 15s) ▸ Fix authentication bug (2/5) ``` ## Configuration ### Interactive configuration (recommended) ``` /claude-hud:configure ``` 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: ```json { "lineLayout": "expanded", "pathLevels": 2, "elementOrder": ["project", "context", "usage", "tools", "agents", "todos"], "gitStatus": { "enabled": true, "showDirty": true, "showAheadBehind": true, "showFileStats": false }, "display": { "showModel": true, "showContextBar": true, "contextValue": "percent", "showUsage": true, "usageBarEnabled": true, "showTools": true, "showAgents": true, "showTodos": true, "showDuration": false, "showSpeed": false, "showConfigCounts": false, "showMemoryUsage": false, "showSessionName": false, "showClaudeCodeVersion": false, "sevenDayThreshold": 80, "showTokenBreakdown": true }, "colors": { "context": "green", "usage": "brightBlue", "warning": "yellow", "usageWarning": "brightMagenta", "critical": "red", "model": "cyan", "project": "yellow", "git": "magenta", "gitBranch": "cyan", "label": "dim", "custom": "208" } } ``` ## Key Configuration Options ### Layout ```json { "lineLayout": "expanded", // "expande