Episode 3: Default Display β What You See
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.