Skip to content

brycewang-stanford/Auto-Empirical-Research-Skills / skills/25-HosungYou-Diverga/skills/hud

Diverga HUD (Heads-Up Display) management skill. Configure and manage the research project statusline display. Supports multiple presets: research, checkpoint, memory, minimal. Triggers: "hud", "statusline", "display settings"

Diverga HUD Skill

Configure and manage the Diverga HUD (Heads-Up Display) statusline.

Overview

The Diverga HUD provides a real-time statusline in your terminal showing:

  • Current research project name
  • Research stage progress
  • Checkpoint completion status
  • Memory/context health

The HUD is independent of oh-my-claudecode and works as a standalone component.

Commands

Status

/diverga-hud status

Show current HUD configuration and status:

  • Whether HUD is enabled
  • Current preset
  • Project name and stage
  • Checkpoint progress
  • Memory health

Presets

/diverga-hud preset <preset_name>

Change HUD display preset:

PresetDescriptionExample Output
researchStandard view (default)πŸ”¬ AI-Ethics β”‚ Stage: foundation β”‚ ●●○○○ (2/11) β”‚ 🧠 95%
checkpointDetailed checkpointsMulti-line with checkpoint details
memoryMemory focusShows context and memory health
minimalStage onlyπŸ”¬ foundation

Enable/Disable

/diverga-hud enable
/diverga-hud disable

Turn HUD display on or off.

Setup

/diverga-hud setup

Install or repair HUD statusline integration:

  1. Creates ~/.claude/hud/diverga-hud.mjs
  2. Updates ~/.claude/settings.json with statusLine command
  3. Initializes .research/hud-state.json in current project

Installation

Automatic (Recommended)

Run /diverga-hud setup to automatically configure HUD.

Manual

  1. Ensure the HUD script exists at ~/.claude/hud/diverga-hud.mjs

  2. Add to ~/.claude/settings.json:

{
  "statusLine": {
    "type": "command",
    "command": "node ~/.claude/hud/diverga-hud.mjs"
  }
}
  1. Restart Claude Code for changes to take effect.

State Files

HUD State

Location: .research/hud-state.json

{
  "version": "1.0.0",
  "enabled": true,
  "preset": "research",
  "last_updated": "2026-02-04T18:45:00Z",
  "cache": {
    "project_name": "AI-Ethics-HR",
    "current_stage": "foundation",
    "checkpoints_completed": 2,
    "checkpoints_total": 11,
    "memory_health": 95
  }
}

Project State

HUD reads from:

  • .research/project-state.yaml - Project metadata
  • .research/checkpoints.yaml - Checkpoint completion status

Protocol

When /diverga-hud is invoked:

  1. status command:

    • Read .research/hud-state.json
    • Display current configuration
    • Show live project status
  2. preset command:

    • Validate preset name (research, checkpoint, memory, minimal)
    • Update .research/hud-state.json
    • Confirm change
  3. enable/disable command:

    • Update .research/hud-state.json enabled flag
    • Confirm change
  4. setup command:

    • Check if ~/.claude/hud/ exists, create if not
    • Copy/update diverga-hud.mjs script
    • Update ~/.claude/settings.json statusLine
    • Initialize .research/hud-state.json
    • Display success message

Error Handling

ErrorResponse
No project found"No Diverga project detected. Initialize with /diverga-setup"
Invalid preset"Invalid preset. Available: research, checkpoint, memory, minimal"
Settings write fail"Could not update settings.json. Check file permissions."

HUD Components

Progress Bar

●●○○○○○○○○○ (2/11)
  • ● = Completed checkpoint (green)
  • β—‹ = Pending checkpoint (dim)
  • (X/Y) = Completed/Total count

Memory Health

🧠 95%

Color coding:

  • Green: 70%+ (healthy)
  • Yellow: 40-70% (moderate)
  • Red: <40% (needs attention)

Stage Indicator

Available stages:

  • foundation - Research question, paradigm
  • theory - Theoretical framework
  • methodology - Research design
  • design - Database, sampling
  • execution - Data collection, screening
  • analysis - Data analysis
  • validation - Quality, peer review

Examples

Check Status

User: /diverga-hud status

Claude: πŸ“Š **Diverga HUD Status**

| Setting | Value |
|---------|-------|
| Enabled | βœ… Yes |
| Preset | research |
| Project | AI-Ethics-HR |
| Stage | foundation |
| Checkpoints | 2/11 (18%) |
| Memory Health | 95% |

HUD is active and displaying in statusline.

Change Preset

User: /diverga-hud preset minimal

Claude: βœ… HUD preset changed to **minimal**.

New display: `πŸ”¬ foundation`

To switch back: `/diverga-hud preset research`

Setup HUD

User: /diverga-hud setup

Claude: πŸ”§ **Setting up Diverga HUD...**

1. βœ… Created ~/.claude/hud/diverga-hud.mjs
2. βœ… Updated ~/.claude/settings.json
3. βœ… Initialized .research/hud-state.json

πŸŽ‰ HUD setup complete!

**Please restart Claude Code** to activate the statusline.

Your HUD will display:
`πŸ”¬ AI-Ethics-HR β”‚ Stage: foundation β”‚ ●●○○○○○○○○○ (2/11) β”‚ 🧠 95%`

Troubleshooting

HUD Not Showing

  1. Check if script exists:

    ls -la ~/.claude/hud/diverga-hud.mjs
    
  2. Check settings.json:

    cat ~/.claude/settings.json | grep statusLine
    
  3. Test script manually:

    node ~/.claude/hud/diverga-hud.mjs
    
  4. Ensure you're in a Diverga project directory (has .research/ folder)

Stale Data

Run refresh to update cache:

/diverga-hud status

Or manually trigger cache rebuild by editing .research/hud-state.json.

Integration with Diverga

The HUD automatically updates when:

  • Checkpoints are completed
  • Stage advances
  • Project state changes

For manual sync, use /diverga-memory sync.

reverse-engineer-anythingmorluto/reaReverse engineer native, managed, Electron/JavaScript, packaged, firmware, and browser targets with REA, and build agent environments (AgentEnv bundles) of web applications from a live instance or a capture, and of Linux desktop apps with a task from a request. Use shipped-artifact or requested runtime evidence to explain features, compare versions, decompile code, or guide a reconstruction. Skip REA for ordinary source-repository architecture analysis.Stars: 472kUpdated Claude CodeCodexVerifiedInstall
diagnosing-superpowersobra/superpowersUse when a superpowers session went wrong and your human partner wants to know why β€” repeated work, ignored plans, stumbles, poor results, a skill that didn't fire, "it took too long", "why is it so expensive", "what is it doing" β€” or wants to build a bug report for the superpowers maintainers, for the current session or a past one identified by id or path, on any harness.Stars: 322kUpdated Claude CodeCodexVerifiedInstall
dispatching-parallel-agentsobra/superpowersUse when facing 2+ independent tasks that can be worked on without shared state or sequential dependenciesStars: 322kUpdated Claude CodeCodexVerifiedInstall
executing-plansobra/superpowersUse when executing an implementation plan in the current session as the implementer yourself β€” your human partner chose inline execution, or no subagent tool is availableStars: 322kUpdated Claude CodeCodexVerifiedInstall