claude-hud
v1.1.0
Published
Custom status line for Claude Code CLI with model, git, context, cost, and usage timer
Maintainers
Readme
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 resetInstall
npx claude-hudRestart Claude Code after installing.
What it does
- Copies the statusline script to
~/.claude/statusline-command.sh - Adds the
statusLineconfig to~/.claude/settings.json - Installs ccusage globally (for cost tracking)
Requirements
- jq —
brew install jq(macOS) orsudo 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 --uninstallLicense
MIT
