claude-hud-real-time-context-panel

id	skill-claude-hud
name	Claude HUD - Real-time Context Panel
version	1.0.0
description	实时头部显示器：展示上下文窗口用量、运行中的工具、Agent进度、token消耗统计
category	prompt
tags	["monitoring","context","tokens","debugging"]
author	Community
repositoryUrl	https://github.com/anthropics/claude-code
parameters	{"transport":"stdio","configTemplate":"{\"transport\": \"stdio\", \"command\": \"npx\", \"args\": [\"-y\", \"claude-hud\"]}"}

claude-hud

A custom status line for Claude Code that shows model, git info, context usage, cost, and time until rate limit reset.

🤖 Opus 4.6   🌿 main +12/-3   💭 ████████░░░░░░░░░░░░ 40%
💰 $1.08 spent   ⏱️  2h 30m until reset

Install

npx claude-hud

Restart Claude Code after installing.

What it does

• Copies the statusline script to ~/.claude/statusline-command.sh
• Adds the statusLine config to ~/.claude/settings.json
• Installs ccusage globally (for cost tracking)

Requirements

• jq — brew install jq (macOS) or sudo apt install jq (Linux)
• Node.js 18+

Features

Element	Description
🤖 Model	Current Claude model
🌿 Git	Branch name + insertions/deletions
💭 Context bar	Color-coded usage (green/yellow/red)
💰 Cost	Spending in current 5-hour block (via ccusage)
⏱️ Timer	Time until rate limit resets

Cost data is cached and refreshed every 5 minutes to minimize overhead.

Uninstall

npx claude-hud --uninstall

License

MIT