Configure Claude HUD

---

description: Configure HUD display options (layout, presets, display elements) while preserving advanced manual overrides allowed-tools: Read, Write, AskUserQuestion

Configure Claude HUD

**FIRST**: Use the Read tool to load `~/.claude/plugins/claude-hud/config.json` if it exists.

Store current values and note whether config exists (determines which flow to use).

Always On (Core Features)

These are always enabled and NOT configurable:

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

Advanced settings such as `colors.*`, `pathLevels`, `display.usageThreshold`, and `display.environmentThreshold` are preserved when saving but are not edited by this guided flow.

---

Two Flows Based on Config State

Flow A: New User (no config)

Questions: **Layout → Preset → Turn Off → Turn On**

Flow B: Update Config (config exists)

Questions: **Turn Off → Turn On → Git Style → Layout/Reset → Custom Line** (5 questions max)

---

Flow A: New User (5 Questions)

Q1: Layout

• header: "Layout"
• question: "Choose your HUD layout:"
• multiSelect: false
• options:
  • "Expanded (Recommended)" - Split into semantic lines (identity, project, environment, usage)
  • "Compact" - Everything on one line
  • "Compact + Separators" - One line with separator before activity

Q2: Preset

• header: "Preset"
• question: "Choose a starting configuration:"
• multiSelect: false
• options:
  • "Full" - Everything enabled (Recommended)
  • "Essential" - Activity + git, minimal info
  • "Minimal" - Core only (model, context bar)

Q3: Turn Off (based on chosen preset)

• header: "Turn Off"
• question: "Disable any of these? (enabled by your preset)"
• multiSelect: true
• options: ONLY items that are ON in the chosen preset (max 4)
  • "Tools activity" - ◐ Edit: file.ts | ✓ Read ×3
  • "Agents status" - ◐ explore [haiku]: Finding code
  • "Todo progress" - ▸ Fix bug (2/5 tasks)
  • "Project name" - my-project path display
  • "Git status" - git:(main*) branch indicator
  • "Config counts" - 2 CLAUDE.md | 4 rules
  • "Token breakdown" - (in: 45k, cache: 12k)
  • "Output speed" - out: 42.1 tok/s
  • "Usage limits" - 5h: 25% | 7d: 10%
  • "Session duration" - ⏱️ 5m
  • "Session name" - fix-auth-bug (session slug or custom title)

Q4: Turn On (based on chosen preset)

• header: "Turn On"
• question: "Enable any of these? (disabled by your preset)"
• multiSelect: true
• options: ONLY items that are OFF in the chosen preset (max 4)
  • (same list as above, filtered to OFF items)

**Note:** If preset has all items ON (Full), Q4 shows "Nothing to enable - Full preset has everything!" If preset has all items OFF (Minimal), Q3 shows "Nothing to disable - Minimal preset is already minimal!"

Q5: Custom Line (optional)

• header: "Custom Line"
• question: "Add a custom phrase to display in the HUD? (e.g. a motto, max 80 chars)"
• multiSelect: false
• options:
  • "Skip" - No custom line
  • "Enter custom text" - Ask user for their phrase via