Claude HUD : le plugin qui rend les agents IA observables

“Impossible de savoir si Claude travaille ou s’il est dans les nuages.”

Si vous avez deja lance une tache complexe avec Claude Code, vous connaissez la sensation. Le terminal reste silencieux pendant une longue operation, sans aucun moyen de savoir si le contexte est sur le point de deborder, si l’agent tourne en boucle, ou s’il se passe quoi que ce soit.

Un plugin open source s’est attaque frontalement a ce probleme. Apres l’avoir utilise moi-meme, je voulais le partager.

Ce que Claude HUD affiche

Claude HUD place une barre de statut inspiree du jeu video en bas de votre terminal. Elle suit quatre informations en temps reel :

• Utilisation du contexte - Une barre de progression visuelle avec pourcentage indiquant la consommation de la fenetre de contexte de la session
• Outils actifs - Quels outils (Read, Edit, Bash, etc.) sont en cours d’execution
• Statut des sous-agents - Suivi des agents enfants crees via les appels Task (Opus 4.5, Sonnet, etc.)
• Progression des todos - Visualisation de l’etat d’avancement de la liste de taches interne de Claude

Comment ca fonctionne en coulisses

Pour les curieux, voici un apercu de ce qui se passe derriere la barre de statut.

Traitement de l’entree stdin

Claude Code transmet l’etat de session directement sous forme de payload JSON. Le plugin calcule l’utilisation du contexte en additionnant input_tokens, cache_creation_input_tokens et cache_read_input_tokens, puis en divisant par context_window_size.

Analyse des transcriptions

Les logs de session sont traites en flux ligne par ligne. Le plugin detecte les blocs tool_use et les fait correspondre aux entrees tool_result pour suivre le statut de chaque outil : running, completed ou error.

Affichage des chemins de fichiers

L’affichage des chemins de fichiers est gere avec soin :

• Extraction du file_path depuis les appels Read, Write et Edit pour afficher le fichier en cours de traitement
• Troncature automatique des chemins longs au format .../filename.ts
• Rafraichissement toutes les 300ms environ pour un retour quasi temps reel

Pourquoi les developpeurs sont enthousiastes

La reponse de la communaute est forte, et la raison est simple : ce plugin cible un point de douleur central du travail avec les agents IA.

• Resout le probleme d’opacite - Les taches longues ne vous laissent plus deviner si l’agent est bloque, en boucle ou sur le point d’atteindre la limite de contexte
• Installation en trois lignes - Aucune configuration complexe requise, on installe et ca marche
• Efficacite du debogage - Dans les workflows multi-etapes, vous voyez immediatement ou ca a deraille
• Feedback visuel - La barre de statut gaming s’integre naturellement dans la culture du vibe-coding, rendant le developpement assiste par IA plus interactif

Un commentaire populaire dans la communaute resume bien le sentiment : “Enfin, je peux savoir si Claude travaille ou s’il reve eveille.”

Installation

Trois commandes suffisent :

/plugin marketplace add jarrodwatts/claude-hud
/plugin install claude-hud
/claude-hud:setup

GitHub : jarrodwatts/claude-hud

Pourquoi c’est important

Si vous utilisez Claude Code regulierement, ca vaut le coup d’essayer. Travailler sans l’anxiete du contexte - savoir exactement quand une session risque de s’epuiser - apporte plus de serenite qu’on ne le pense. Mais la vraie valeur est plus simple : pouvoir voir ce que Claude fait a tout moment change la facon dont on travaille avec lui.

L’observabilite n’est pas reservee aux serveurs et aux pipelines. Les agents IA en ont besoin aussi.