/ Annuaire / Playground / Claude HUD
● Communauté jarrodwatts ⚡ Instantané

Claude HUD

par jarrodwatts · jarrodwatts/claude-hud

Un HUD en temps réel pour Claude Code — budget de contexte, outils actifs, sous-agents en cours, progression des tâches. Arrêtez de voler à l'aveugle.

claude-hud est un plugin Claude Code qui fait remonter ce qui se passe réellement pendant une session : le remplissage de la fenêtre de contexte, quels outils se déclenchent, quels sous-agents sont actifs, la progression de la liste de tâches. Destiné aux devs qui font tourner de longues sessions ou des workflows multi-agents où « pourquoi ça ralentit ? » devient une vraie question.

Pourquoi l'utiliser

Fonctionnalités clés

Démo en direct

Aperçu en pratique

prêt

Installation

Dépôt de l’auteur · Documentation officielle des Skills Claude

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
  1. Ouvrir le HUD
    Ouvre le HUD. Quel est mon usage de contexte en ce moment ?✓ Copié
    → Pourcentage en direct avec ventilation
  2. 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
  3. 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
  1. Lister
    Montre-moi tous les sous-agents actifs et leurs tâches en cours.✓ Copié
    → Une tuile par sous-agent
  2. 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

OutilEntréesQuand appelerCoû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

AlternativeQuand l'utiliserCompromis
cc-lensVous voulez une fenêtre de tableau de bord séparéeUX différent ; pas intégré
Le /context intégré de Claude CodeUne vérification rapide suffitPas 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