by jarrodwatts
A Claude Code plugin that shows what's happening - context usage, active tools, running agents, and todo progress
# Add to your Claude Code skills
git clone https://github.com/jarrodwatts/claude-hudA Claude Code plugin that shows what's happening — context usage, active tools, running agents, and todo progress. Always visible below your input.

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
<details> <summary><strong>⚠️ Linux users: Click here first</strong></summary>On Linux, /tmp is often a separate filesystem (tmpfs), which causes plugin installation to fail with:
EXDEV: cross-device link not permitted
Fix: Set TMPDIR before installing:
mkdir -p ~/.cache/tmp && TMPDIR=~/.cache/tmp claude
Then run the install command below in that session. This is a Claude Code platform limitation.
</details>/plugin install claude-hud
Step 3: Configure the statusline
/claude-hud:setup
Done! The HUD appears immediately — no restart needed.
Claude HUD gives you better insights into what's happening in your Claude Code session.
| What You See | Why It Matters | |--------------|----------------| | | Know which project you're in (configurable 1-3 directory levels) | | | Know exactly how full your context window is before it's too late | | | Watch Claude read, edit, and search files as it happens | | | See which subagents are running and what they're doing | | | Track task completion in real-time |
No comments yet. Be the first to share your thoughts!
[Opus | Max] │ my-project git:(main*)
Context █████░░░░░ 45% │ Usage ██░░░░░░░░ 25% (1h 30m / 5h)
Bedrock), project path, git branch/claude-hud:configure)◐ Edit: auth.ts | ✓ Read ×3 | ✓ Grep ×2 ← Tools activity
◐ explore [haiku]: Finding auth code (2m 15s) ← Agent status
▸ Fix authentication bug (2/5) ← Todo progress
Claude HUD uses Claude Code's native statusline API — no separate window, no tmux required, works in any terminal.
Claude Code → stdin JSON → claude-hud → stdout → displayed in your terminal
↘ transcript JSONL (tools, agents, todos)
Key features:
Customize your HUD anytime:
/claude-hud:configure
The guided flow walks you through customization — no manual editing needed: