Episode 9: Advanced Features

Key Takeaway: HUD isn't just about the context bar — it can also show cache countdown, cost, speed, and much more.

---

9.1 Prompt Cache Countdown

With showPromptCache: true:

Cache TTL: 3m 42s

Helps you decide:

• How long before you need to pay again
• Whether to send a message to keep the cache alive

{
  "display": {
    "showPromptCache": true,
    "promptCacheTtlSeconds": 300
  }
}

Pro users: keep at 300 (5 minutes). Max users: set to 3600 (1 hour).

---

9.2 Session Cost Display

With showCost: true:

$0.42

Uses Claude Code's native cost.total_cost_usd field.

---

9.3 Output Speed

With showSpeed: true:

out: 42.1 tok/s

Real-time output token rate — judge model response speed.

---

9.4 Session Duration

With showDuration: true:

⏱️ 5m

---

9.5 Session Name

With showSessionName: true:

fix-auth-bug

Shows session slug or custom name set via /rename.

---

9.6 Other Optional Info

Feature	Config	Display
Claude Code version	showClaudeCodeVersion: true	CC v2.1.81
Memory usage	showMemoryUsage: true	RAM: 12.4 GB
Project path depth	pathLevels: 2	apps/my-project

---

9.7 Context Display Format

{ "display": { "contextValue": "percent" } }     // 45%
{ "display": { "contextValue": "tokens" } }      // 45K/200K
{ "display": { "contextValue": "remaining" } }   // 55% remaining
{ "display": { "contextValue": "both" } }         // 45% (45K/200K)

---

9.8 Custom Colors

Supports color names, 256-color codes (0-255), and hex (#FF6600):

{
  "colors": {
    "context": "cyan",
    "usage": "cyan",
    "warning": "yellow",
    "critical": "red",
    "model": "cyan",
    "project": "yellow",
    "git": "magenta",
    "gitBranch": "cyan",
    "label": "dim",
    "custom": "#FF6600"
  }
}

---

Next Episode: Episode 10 compiles best practices and FAQ — recommended configs, context management golden rules, and a one-stop troubleshooting guide.