| 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