/ Verzeichnis / Playground / Claude HUD
● Community jarrodwatts ⚡ Sofort

Claude HUD

von jarrodwatts · jarrodwatts/claude-hud

Ein Echtzeit-HUD für Claude Code — Context-Budget, aktive Tools, laufende Subagents, Todo-Fortschritt. Schluss damit, im Blindflug zu sein.

claude-hud ist ein Claude Code-Plugin, das anzeigt, was während einer Session tatsächlich passiert: wie voll das Kontextfenster ist, welche Tools feuern, welche Subagents aktiv sind, Todo-Listen-Fortschritt. Gedacht für Devs, die lange Sessions oder Multi-Agent-Workflows betreiben, bei denen 'warum wird das gerade langsam?' eine echte Frage ist.

Warum nutzen

Hauptfunktionen

Live-Demo

In der Praxis

bereit

Installieren

Wählen Sie Ihren Client

~/Library/Application Support/Claude/claude_desktop_config.json  · Windows: %APPDATA%\Claude\claude_desktop_config.json
{
  "mcpServers": {
    "claude-hud-skill": {
      "command": "git",
      "args": [
        "clone",
        "https://github.com/jarrodwatts/claude-hud",
        "~/.claude/plugins/claude-hud"
      ],
      "_inferred": true
    }
  }
}

Öffne Claude Desktop → Settings → Developer → Edit Config. Nach dem Speichern neu starten.

~/.cursor/mcp.json · .cursor/mcp.json
{
  "mcpServers": {
    "claude-hud-skill": {
      "command": "git",
      "args": [
        "clone",
        "https://github.com/jarrodwatts/claude-hud",
        "~/.claude/plugins/claude-hud"
      ],
      "_inferred": true
    }
  }
}

Cursor nutzt das gleiche mcpServers-Schema wie Claude Desktop. Projektkonfiguration schlägt die globale.

VS Code → Cline → MCP Servers → Edit
{
  "mcpServers": {
    "claude-hud-skill": {
      "command": "git",
      "args": [
        "clone",
        "https://github.com/jarrodwatts/claude-hud",
        "~/.claude/plugins/claude-hud"
      ],
      "_inferred": true
    }
  }
}

Klicken Sie auf das MCP-Servers-Symbol in der Cline-Seitenleiste, dann "Edit Configuration".

~/.codeium/windsurf/mcp_config.json
{
  "mcpServers": {
    "claude-hud-skill": {
      "command": "git",
      "args": [
        "clone",
        "https://github.com/jarrodwatts/claude-hud",
        "~/.claude/plugins/claude-hud"
      ],
      "_inferred": true
    }
  }
}

Gleiche Struktur wie Claude Desktop. Windsurf neu starten zum Übernehmen.

~/.continue/config.json
{
  "mcpServers": [
    {
      "name": "claude-hud-skill",
      "command": "git",
      "args": [
        "clone",
        "https://github.com/jarrodwatts/claude-hud",
        "~/.claude/plugins/claude-hud"
      ]
    }
  ]
}

Continue nutzt ein Array von Serverobjekten statt einer Map.

~/.config/zed/settings.json
{
  "context_servers": {
    "claude-hud-skill": {
      "command": {
        "path": "git",
        "args": [
          "clone",
          "https://github.com/jarrodwatts/claude-hud",
          "~/.claude/plugins/claude-hud"
        ]
      }
    }
  }
}

In context_servers hinzufügen. Zed lädt beim Speichern neu.

claude mcp add claude-hud-skill -- git clone https://github.com/jarrodwatts/claude-hud ~/.claude/plugins/claude-hud

Einzeiler. Prüfen mit claude mcp list. Entfernen mit claude mcp remove.

Anwendungsfälle

Praxisnahe Nutzung: Claude HUD

Diagnostizieren, warum eine lange Session plötzlich langsam ist

👤 Devs, die mehrstündige Claude Code-Sessions betreiben ⏱ ~10 min beginner

Wann einsetzen: Antworten fühlen sich langsamer an als zu Beginn; du vermutest Context-Druck.

Voraussetzungen
  • Plugin installiert — Unter ~/.claude/plugins ablegen oder gemäß Claude Code-Plugin-Konvention
Ablauf
  1. HUD öffnen
    Open the HUD. What's my context usage right now?✓ Kopiert
    → Live-Prozentsatz mit Aufschlüsselung
  2. Fressende Tools identifizieren
    Which tool calls produced the largest results in the last 30 minutes?✓ Kopiert
    → Top-N-Liste fetter Tool-Ausgaben
  3. Komprimieren
    Compact the conversation to summary. Verify HUD shows context dropped.✓ Kopiert
    → Context-Balken fällt; Geschwindigkeit kehrt zurück

Ergebnis: Sessions, die den ganzen Tag laufen können ohne unerklärliche Verlangsamungen.

Fallstricke
  • Aggressive Komprimierung verliert wichtige Details — Selektiv komprimieren — letzten bedeutungsvollen Austausch behalten

Mehrere parallel arbeitende Subagents verfolgen

👤 Devs, die Subagents spawnen ⏱ ~15 min intermediate

Wann einsetzen: Du hast 3 Subagents gestartet und den Überblick verloren, wer was tut.

Ablauf
  1. Auflisten
    Show me all active subagents and their current tasks.✓ Kopiert
    → Kachel pro Subagent
  2. Einsteigen
    Show the recent tool calls and todo progress for subagent 'tester'.✓ Kopiert
    → Per-Subagent-Timeline

Ergebnis: Sichtbarkeit in ein Multi-Agent-Setup, das sonst eine Black Box wäre.

Fallstricke
  • Zu viele Subagents — HUD selbst wird unübersichtlich — Inaktive filtern / zusammenklappen
Kombinieren mit: mcp-agent-mail

Kombinationen

Mit anderen MCPs für 10-fache Wirkung

claude-hud-skill + mcp-agent-mail

Multi-Agent-Setups koordinieren + überwachen

Use mail for coordination, HUD for live status.✓ Kopiert
claude-hud-skill + claude-best-practice-skill

Disziplinierte Pläne + Live-Tracking

Plan with best-practice, watch progress in HUD.✓ Kopiert

Werkzeuge

Was dieses MCP bereitstellt

WerkzeugEingabenWann aufrufenKosten
show_context (none) Wann immer du Aufblähung vermutest free
tool_timeline since? Latenz / fette Ausgaben finden free
list_subagents (none) Multi-Agent-Läufe verfolgen free
todo_status (none) Session-Checkpoints free

Kosten & Limits

Was der Betrieb kostet

API-Kontingent
N/A
Tokens pro Aufruf
Minimal — HUD ist read-only Telemetrie
Kosten in €
Kostenlos
Tipp
HUD selbst ist günstig; damit teure Dinge zum Kürzen finden

Sicherheit

Rechte, Secrets, Reichweite

Minimale Scopes: Read access to Claude Code session state
Credential-Speicherung: Keine
Datenabfluss: Keine

Fehlerbehebung

Häufige Fehler und Lösungen

HUD shows nothing

Plugin nicht geladen; Installationspfad prüfen und Claude Code neu starten

Context numbers don't match settings

HUD liest den genauen Session-Status; die Abweichung betrifft normalerweise reservierte System-tokens

Alternativen

Claude HUD vs. andere

AlternativeWann stattdessenKompromiss
cc-lensEin separates Dashboard-Fenster gewünschtAndere UX; nicht inline
Claude Code's built-in /contextSchnelle Prüfung genügtKeine Timeline, keine Subagent-Ansicht

Mehr

Ressourcen

📖 Offizielle README auf GitHub lesen

🐙 Offene Issues ansehen

🔍 Alle 400+ MCP-Server und Skills durchsuchen