configure

Configure Claude HUD

FIRST: Ensure the HUD data dir is plugins/claude-hud-enhanced (not legacy plugins/claude-hud).

If ${CLAUDE_CONFIG_DIR:-$HOME/.claude}/plugins/claude-hud exists and .../claude-hud-enhanced does not, rename it:

CLAUDE_DIR="${CLAUDE_CONFIG_DIR:-$HOME/.claude}"
if [ -d "$CLAUDE_DIR/plugins/claude-hud" ] && [ ! -e "$CLAUDE_DIR/plugins/claude-hud-enhanced" ]; then
  mv "$CLAUDE_DIR/plugins/claude-hud" "$CLAUDE_DIR/plugins/claude-hud-enhanced"
fi

Then use the Read tool to load ~/.claude/plugins/claude-hud-enhanced/config.json (or $CLAUDE_CONFIG_DIR/plugins/claude-hud-enhanced/config.json) if it exists.

FIRST: Resolve the active config directory ($CLAUDE_CONFIG_DIR when set, otherwise ~/.claude). Use the Read tool to load both of these files when they exist:

1. plugins/claude-hud/config.json inside the active config directory (the writable base).
2. claude-hud.json directly inside the active config directory (the manual override).

Store the base and override separately. The base file alone determines which flow to use. For current values and previews, compute the effective config by layering the override over the base with nested objects merged key by key and arrays/scalars replaced. Track every key defined by the override so the guided flow can identify settings that it cannot change.

Core Features (on by default)

These default to ON and are what most users keep. They ARE configurable (display.showModel, display.showContextBar), but the guided flow keeps them enabled — toggle them by editing config.json directly if needed:

• Model name [Opus]
• Context bar ████░░░░░░ 45%

Advanced settings such as colors.*, pathLevels, maxWidth, forceMaxWidth, elementOrder, projectLineOrder, display.mergeGroups, display.timeFormat, display.contextValue, display.modelFormat, display.modelOverride, display.modelSource, display.effortFormat, display.showProvider, display.providerName, display.autocompactBuffer, display.autoCompactWindow, display.usageThreshold, display.sevenDayThreshold, display.environmentThreshold, display.contextWarningThreshold, display.contextCriticalThreshold, display.advisorOverride, display.showAuth, display.showAuthUser, display.authUserLength, and the display.externalUsage* keys are preserved when saving but are not edited by this guided flow.