Claude HUD (Claude Skill) — Cas d'usage, Installer & Démo en direct

Pourquoi l'utiliser

Fonctionnalités clés

Jauge d'utilisation de la fenêtre de contexte
Timeline des appels d'outils (quels outils MCP, quand, latence)
Liste des sous-agents actifs
Suivi de progression des tâches / todo
Léger — plugin pur, aucun service supplémentaire

Démo en direct

Aperçu en pratique

prêt

Installer

Choisissez votre 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
    }
  }
}

Ouvrez Claude Desktop → Settings → Developer → Edit Config. Redémarrez après avoir enregistré.

~/.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 utilise le même schéma mcpServers que Claude Desktop. La config projet l'emporte sur la 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
    }
  }
}

Cliquez sur l'icône MCP Servers dans la barre latérale Cline, puis "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
    }
  }
}

Même format que Claude Desktop. Redémarrez Windsurf pour appliquer.

~/.continue/config.json

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

Continue utilise un tableau d'objets serveur plutôt qu'une 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"
        ]
      }
    }
  }
}

Ajoutez dans context_servers. Zed recharge à chaud à la sauvegarde.

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

Une seule ligne. Vérifiez avec claude mcp list. Supprimez avec claude mcp remove.

Cas d'usage

Usages concrets : Claude HUD

Diagnostiquer pourquoi une longue session ralentit soudainement

👤 Devs faisant tourner des sessions Claude Code de plusieurs heures ⏱ ~10 min beginner

Quand l'utiliser : Les réponses semblent plus lentes qu'au début ; vous suspectez une pression sur le contexte.

Prérequis

Plugin installé — Placez sous ~/.claude/plugins ou selon la convention de plugins Claude Code

Déroulement

Ouvrir le HUD

Ouvre le HUD. Quel est mon usage de contexte en ce moment ?✓ Copié

→ Pourcentage en direct avec ventilation
Identifier les gourmands

Quels appels d'outils ont produit les plus grands résultats dans les 30 dernières minutes ?✓ Copié

→ Top-N des sorties d'outils volumineuses
Compacter

Compacte la conversation en résumé. Vérifie que le HUD montre une baisse du contexte.✓ Copié

→ La barre de contexte baisse ; la vitesse revient

Résultat : Des sessions que vous pouvez faire tourner toute la journée sans ralentissements inexpliqués.

Pièges

Une compaction agressive perd des détails importants — Compactez sélectivement — gardez le dernier échange significatif

Suivre plusieurs sous-agents travaillant en parallèle

👤 Devs qui spawne des sous-agents ⏱ ~15 min intermediate

Quand l'utiliser : Vous avez lancé 3 sous-agents et perdu la trace de qui fait quoi.

Déroulement

Lister

Montre-moi tous les sous-agents actifs et leurs tâches en cours.✓ Copié

→ Une tuile par sous-agent
Zoomer

Montre les appels d'outils récents et la progression des tâches du sous-agent 'tester'.✓ Copié

→ Timeline par sous-agent

Résultat : Visibilité sur une configuration multi-agents qui serait autrement une boîte noire.

Pièges

Trop de sous-agents — le HUD lui-même devient encombré — Filtrez / réduisez les inactifs

Combiner avec : mcp-agent-mail

Combinaisons

Associez-le à d'autres MCPs pour un effet X10

claude-hud-skill + mcp-agent-mail

Coordonner + surveiller les configurations multi-agents

Utilise mail pour la coordination, HUD pour le statut en direct.✓ Copié

claude-hud-skill + claude-best-practice-skill

Plans disciplinés + suivi en direct

Planifie avec best-practice, observe la progression dans le HUD.✓ Copié

Outils

Ce que ce MCP expose

Outil	Entrées	Quand appeler	Coût
show_context	(aucun)	À tout moment quand vous suspectez du gonflement	gratuit
tool_timeline	since?	Trouver la latence / les sorties volumineuses	gratuit
list_subagents	(aucun)	Suivre les exécutions multi-agents	gratuit
todo_status	(aucun)	Points de contrôle de session	gratuit

Coût et limites

Coût d'exécution

Quota d'API: N/A
Tokens par appel: Minime — le HUD est de la télémétrie en lecture seule
Monétaire: Gratuit
Astuce: Le HUD lui-même est peu coûteux ; utilisez-le pour trouver les choses coûteuses à couper

Sécurité

Permissions, secrets, portée

Portées minimales : Accès en lecture à l'état de session Claude Code

Stockage des identifiants : Aucun

Sortie de données : Aucune

Dépannage

Erreurs courantes et correctifs

Le HUD ne montre rien

Plugin non chargé ; vérifiez le chemin d'installation et redémarrez Claude Code

Les chiffres de contexte ne correspondent pas aux paramètres

Le HUD lit l'état de session exact ; la divergence est généralement due aux tokens système réservés

Alternatives

Claude HUD vs autres

Alternative	Quand l'utiliser	Compromis
cc-lens	Vous voulez une fenêtre de tableau de bord séparée	UX différent ; pas intégré
Le /context intégré de Claude Code	Une vérification rapide suffit	Pas de timeline, pas de vue sous-agent

Plus

Ressources

📖 Lire le README officiel sur GitHub

🐙 Voir les issues ouvertes

🔍 Parcourir les 400+ serveurs MCP et Skills