Configure claude-hud as your statusline (plugin:claude-hud@claude-hud)
Installs and configures the claude-hud statusline plugin with optional Nerd Font support for enhanced icons. Use this to add a real-time status bar showing context usage, active tools, and running agents to your Claude Code terminal.
/plugin marketplace add brnbtt/bruno-hud/plugin install claude-hud@claude-hudThis setup configures the Claude HUD statusline with optional Nerd Font installation for enhanced icons.
First, determine the platform:
Ask the user: "Would you like to install JetBrainsMono Nerd Font for enhanced icons? (Recommended)"
Windows (PowerShell):
$fontUrl = "https://github.com/ryanoasis/nerd-fonts/releases/download/v3.3.0/JetBrainsMono.zip"
$tempDir = Join-Path $env:TEMP "nerd-font-install-$(Get-Random)"
$fontDir = Join-Path $env:LOCALAPPDATA "Microsoft\Windows\Fonts"
New-Item -ItemType Directory -Force -Path $tempDir | Out-Null
[Net.ServicePointManager]::SecurityProtocol = [Net.SecurityProtocolType]::Tls12
Invoke-WebRequest -Uri $fontUrl -OutFile "$tempDir\JetBrainsMono.zip" -UseBasicParsing
Expand-Archive -Path "$tempDir\JetBrainsMono.zip" -DestinationPath "$tempDir\fonts" -Force
if (-not (Test-Path $fontDir)) { New-Item -ItemType Directory -Force -Path $fontDir | Out-Null }
$regPath = "HKCU:\SOFTWARE\Microsoft\Windows NT\CurrentVersion\Fonts"
Get-ChildItem "$tempDir\fonts\*.ttf" | ForEach-Object {
Copy-Item $_.FullName -Destination (Join-Path $fontDir $_.Name) -Force
New-ItemProperty -Path $regPath -Name "$($_.BaseName) (TrueType)" -Value (Join-Path $fontDir $_.Name) -PropertyType String -Force | Out-Null
}
Remove-Item -Recurse -Force $tempDir
Write-Host "JetBrainsMono Nerd Font installed!"
macOS (Homebrew):
brew install --cask font-jetbrains-mono-nerd-font
Linux:
mkdir -p ~/.local/share/fonts
curl -fsSL "https://github.com/ryanoasis/nerd-fonts/releases/download/v3.3.0/JetBrainsMono.zip" -o /tmp/font.zip
unzip -o /tmp/font.zip -d /tmp/fonts
cp /tmp/fonts/*.ttf ~/.local/share/fonts/
fc-cache -fv
rm -rf /tmp/font.zip /tmp/fonts
Create ~/.claude/claude-hud.json with:
{
"iconMode": "nerd",
"colorMode": "256",
"animationsEnabled": true,
"spinnerStyle": "braille"
}
If user declined Nerd Font, use "iconMode": "unicode" instead.
Add to ~/.claude/settings.json:
Windows:
{
"statusLine": {
"type": "command",
"command": "node C:/DEV/claude-hud/dist/index.js"
}
}
macOS/Linux (using plugin cache):
{
"statusLine": {
"type": "command",
"command": "node \"$(ls -td ~/.claude/plugins/cache/claude-hud/claude-hud/*/ 2>/dev/null | head -1)dist/index.js\""
}
}
Merge with existing settings. Do not overwrite other fields.
If Nerd Font was installed, inform the user:
Windows Terminal:
Add
"font": { "face": "JetBrainsMono Nerd Font" }to your Windows Terminal profile, or go to Settings > Profiles > Defaults > Appearance > Font face.
iTerm2 (macOS):
Go to Preferences > Profiles > Text > Font and select "JetBrainsMono Nerd Font"
Other terminals:
Configure your terminal to use "JetBrainsMono Nerd Font"
The HUD appears immediately - no restart needed (except for font changes).
Tell the user:
Ask the user: "Would you like to ⭐ star the repository to support the project?"
Only if they explicitly agree, run:
gh api -X PUT /user/starred/jarrodwatts/claude-hud
Never run this automatically without user consent.