configure

# 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).

## 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`, `display.mergeGroups`, `display.timeFormat`, `display.contextValue`,
`display.modelFormat`, `display.modelOverride`, `display.showProvider`,
`display.providerName`, `display.autocompactBuffer`,
`display.autoCompactWindow`, `display.promptCacheTtlSeconds`,
`display.usageThreshold`, `display.sevenDayThreshold`,
`display.environmentThreshold`, `display.contextWarningThreshold`,
`display.contextCriticalThreshold`, `display.advisorOverride`, and the
`display.externalUsage*` keys 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 → Language → Turn Off → Turn On → Custom Line**

### Flow B: Update Config (config exists)
Questions: **Turn Off → Turn On → Git Style → Layout/Reset → Language → Custom Line** (6 questions max)

---

## Flow A: New User (6 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: Language
- header: "Language"
- question: "Choose your HUD label language:"
- multiSelect: false
- options:
  - "English (Recommended)" - Default, simplest onboarding path
  - "中文" - Show HUD labels and status text in Chinese

Save as `language: "en"` or `language: "zh-Hans"`.

### Q4: 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
  - "Added directories" - +repo +shared workspace directories from /add-dir
  - "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%
  - "Usage reset label" - show or hide the `resets in` prefix
  - "Compact usage" - 5h: 25% (1h 30m) shorter format
  - "Session duration" - ⏱️ 5m
  - "Session name" - fix-auth-bug (session slug or custom title)
  - "Session tokens" - Tokens 12.8M (in: 7k, out: 28k, cache: 12.8M)
  - "Reasoning level" - ◑ high (low/medium/high/xhigh/max effort)
  - "Output style" - style: explanatory (current output style name)
  - "Session cost" - 💰 $0.42
  - "Skills activity" - active skills count
  - "MCP status" - MCP server status
  - "Memory usage" - process memory footprint
  - "Prompt cache" - cache TTL countdown
  - "Claude Code version" - the running CC version
  - "Compaction count" - Compactions: 2 after /compact or auto-compaction
  - "Advisor model" - Advisor: Opus 4.7 (when /advisor is configured)

### Q5: 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), Q5 shows "Nothing to enable - Full preset has everything!"
If preset has all items OFF (Minimal), Q4 shows "Nothing to disable - Minimal preset is already minimal!"

### Q6: 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 AskUserQuestion (free text input)

If user chooses "Enter custom text", use AskUserQuestion to get their text. Save as `display.customLine` in config.

---

## Flow B: Update Config (6 Questions)

### Q1: Turn Off
- header: "Turn Off"
- question: "What do you want to DISABLE? (currently enabled)"
- multiSelect: true
- options: **ONLY items currently ON** (max 4, prioritize Activity first)
  - "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
  - "Added directories" - +repo +shared workspace directories from /add-dir
  - "Git status" - git:(main*) branch indicator
  - "Session name" - fix-auth-bug (session slug or custom title)
  - "Session tokens" - Tokens 12.8M (in: 7k, out: 28k, cache: 12.8M)
  - "Reasoning level" - ◑ high (low/medium/high/xhigh/max effort)
  - "Output style" - style: explanatory (current output style name)
  - "Session cost" - 💰 $0.42
  - "Skills activity" - active skills count
  - "MCP status" - MCP server status
  - "Memory usage" - process memory footprint
  - "Prompt cache" - cache TTL countdown
  - "Claude Code version" - the running CC version
  - "Compaction count" - Compactions: 2 after /compact or auto-compaction
  - "Advisor model" - Advisor: Opus 4.7 (when /advisor is configured)
  - "Usage bar style" - ██░░ 25% visual bar (only if