Episode 3: Default Display β€” What You See

⏱ Est. reading time: 3 min Updated on 5/7/2026

Key Takeaway: Your first impression after installing HUD β€” two lines of information represent your entire session's health.


3.1 Default Two-Line Layout

[Opus | Max] β”‚ my-project git:(main*)
Context β–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ–‘β–‘β–‘β–‘β–‘ 45% β”‚ Usage β–ˆβ–ˆβ–‘β–‘β–‘β–‘β–‘β–‘β–‘β–‘ 25% (1h 30m / 5h)

Line 1: Model name + plan | Project path | Git branch

Info Meaning
[Opus] Current model
Max Subscription type (Pro/Max/Team)
my-project Project directory name
git:(main*) Current branch, * indicates uncommitted changes

Line 2: Context bar + usage limit

Info Meaning
Context β–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ–‘β–‘β–‘β–‘β–‘ 45% Context window 45% used
Usage β–ˆβ–ˆβ–‘β–‘β–‘β–‘β–‘β–‘β–‘β–‘ 25% 5-hour usage window 25% used
(1h 30m / 5h) 1.5 hours used, 5-hour window total

3.2 Context Bar Color Changes

Colors change automatically with usage:

Color Meaning
🟒 Green Healthy (< 60%)
🟑 Yellow Warning (60-85%)
πŸ”΄ Red Critical (> 85%)

3.3 Optional Lines (Must Be Manually Enabled)

Enable via /claude-hud:configure:

◐ Edit: auth.ts | βœ“ Read Γ—3 | βœ“ Grep Γ—2        ← Tool activity
◐ explore [haiku]: Finding auth code (2m 15s)    ← Agent status
β–Έ Fix authentication bug (2/5)                   ← Todo progress

These let you see in real-time what Claude is doing and how things are progressing.


Next Episode: Episode 4 covers configuration and presets β€” how to customize your dashboard with /claude-hud:configure.