Presets are starting configurations that set a group of display options at once. Choose one when first running /claude-hud:configure, or reset to a preset at any time from the interactive flow.
The three presets
| Preset | What’s shown |
|---|
| Full | Everything enabled — tools, agents, todos, git, usage, duration, session name |
| Essential | Activity lines and git status, minimal info clutter |
| Minimal | Core only — model name and context bar (this is the default) |
The Full preset enables every display element. Use this when you want maximum visibility into your session.[Opus | Max] │ my-project git:(main*)
Context █████░░░░░ 45% │ Usage ██░░░░░░░░ 25% (1h 30m / 5h) ⏱️ 5m
◐ Edit: auth.ts | ✓ Read ×3 | ✓ Grep ×2
◐ explore [haiku]: Finding auth code (2m 15s)
▸ Fix authentication bug (2/5)
- Tools activity
- Agents status
- Todo progress
- Config counts
- Token breakdown
- Usage limits
- Session duration
- Session name
- Git (with dirty indicator)
The Essential preset shows activity lines and git status, but hides usage limits and config counts.[Opus | Max] │ my-project git:(main*)
Context █████░░░░░ 45% ⏱️ 5m
◐ Edit: auth.ts | ✓ Read ×3
◐ explore [haiku]: Finding auth code
▸ Fix authentication bug (2/5)
- Tools activity
- Agents status
- Todo progress
- Session duration
- Git (with dirty indicator)
What’s off:
- Config counts
- Token breakdown
- Usage limits
- Session name
The Minimal preset is the default. It shows only the model name and context bar — no extra lines.[Opus | Max] │ my-project git:(main*)
Context █████░░░░░ 45%
- Model name (always on)
- Context bar (always on)
- Git (with dirty indicator)
What’s off:
- Tools activity
- Agents status
- Todo progress
- Config counts
- Token breakdown
- Usage limits
- Session duration
- Session name
Applying a preset
Run the configure command and follow the prompts:
For new users, the flow asks you to choose a preset first, then lets you turn individual elements on or off.
For returning users, you can reset to a preset from the Layout/Reset step.
Equivalent config.json
{
"lineLayout": "expanded",
"gitStatus": {
"enabled": true,
"showDirty": true,
"showAheadBehind": false,
"showFileStats": false
},
"display": {
"showTools": true,
"showAgents": true,
"showTodos": true,
"showConfigCounts": true,
"showTokenBreakdown": true,
"showUsage": true,
"usageBarEnabled": true,
"showDuration": true,
"showSessionName": true
}
}
{
"lineLayout": "expanded",
"gitStatus": {
"enabled": true,
"showDirty": true,
"showAheadBehind": false,
"showFileStats": false
},
"display": {
"showTools": true,
"showAgents": true,
"showTodos": true,
"showConfigCounts": false,
"showTokenBreakdown": false,
"showUsage": false,
"showDuration": true,
"showSessionName": false
}
}
{
"lineLayout": "expanded",
"gitStatus": {
"enabled": true,
"showDirty": true,
"showAheadBehind": false,
"showFileStats": false
},
"display": {
"showTools": false,
"showAgents": false,
"showTodos": false,
"showConfigCounts": false,
"showTokenBreakdown": false,
"showUsage": false,
"showDuration": false,
"showSessionName": false
}
}
After applying a preset, you can fine-tune individual options by editing ~/.claude/plugins/claude-hud/config.json directly. The interactive flow preserves any advanced settings you have set manually.