Aller au contenu

claude-hud — monitoring temps reel de Claude Code via statusline native (19.1K stars)

Resume

claude-hud est un plugin Claude Code (19.1K stars, 848 forks, MIT) qui affiche en temps reel dans le terminal l'etat complet d'une session Claude : barre de contexte (vert → jaune → rouge), consommation rate limit, tools actifs (file reads, edits, searches), subAgents en execution avec duree, progression des taches todo, info git (branche, dirty, ahead/behind), cout de session, et memoire systeme. Mise a jour toutes les 300 ms via l'API statusline native de Claude Code (pas de scraping). Installation en 3 commandes via le marketplace plugins. Presets Full/Essential/Minimal + 16 toggles de configuration. Support Node.js 18+ et Bun.

Analyse critique

Ce qui est solide

Le projet est serieux (19.1K stars, 418 commits, contribution guidelines, security policy). Ce n'est pas un hack — c'est un plugin qui utilise l'API statusline officielle. Les donnees de contexte et de cout sont natives (pas des estimations), ce qui les rend fiables.

La barre de contexte vert → jaune → rouge est la fonctionnalite la plus impactante. Aujourd'hui, quand une session Claude Code approche de la saturation contexte, on ne le voit qu'au moment ou ca casse — l'agent commence a perdre des instructions, a oublier des contraintes, a produire des outputs degrades. Avec claude-hud, on voit le contexte monter en temps reel et on peut agir avant la saturation (compacter, deleguer, splitter).

Le suivi subAgents est egalement critique pour les workflows multi-agents : voir quel agent tourne depuis combien de temps permet de detecter les agents bloques avant qu'ils ne timeout.

Ce qui manque

  • Pas d'API exposee pour consommer les donnees depuis un script externe. Le HUD est un affichage terminal, pas une source de donnees interrogeable. Pour notre LOTR, il faudrait un bridge claude-hud → broker peers pour que le Lord voie le contexte des Ringbearers.
  • Pas de seuils d'alerte configurables (ex : notifier a 80 % de contexte). Le HUD montre, il ne decide pas. C'est au dev de regarder.
  • Pas de persistance des metriques de session. Le HUD est ephemere — quand la session se termine, les donnees disparaissent. Pour le compounding (#28), il faudrait exporter les metriques de contexte par story.

Le signal fort

En 2 mois, 19.1K stars — c'est une adoption massive pour un plugin Claude Code. Ca confirme que la visibilite sur l'etat runtime est un besoin non-satisfait par l'interface par defaut. Anthropic a ajoute la statusline API (native depuis v1.0.80+) mais n'a pas construit le HUD eux-memes — la communaute a rempli le vide.

Pertinence ProbatioVault

Impact fort — directement applicable a LOTR et a la gestion du contexte.

LOTR : visibilite sur les Ringbearers

Aujourd'hui, le Lord supervise les Ringbearers par scraping visuel du pane cmux (50 lignes toutes les 10 secondes). Il ne voit pas le niveau de contexte d'un Ringbearer. Un Ringbearer a 92 % de contexte qui produit des outputs degrades est indiscernable d'un Ringbearer a 30 % qui tourne normalement.

Avec claude-hud installe sur chaque Ringbearer : - Le Lord pourrait parser la statusline pour extraire le pourcentage de contexte - Si un Ringbearer depasse 80 %, le Lord pourrait declencher une compaction ou une escalade preventive - La duree des subAgents step 6b serait visible — detection des agents bloques

Alignement avec la matrice TODO : - [L1bis] Vues Signal par Ringbearer : claude-hud fournit les donnees a afficher - [#10] Compaction awareness : claude-hud donne la visibilite qui manque pour decider quand compacter - [L12] Notchi sprite MacBook : claude-hud fait un travail similaire mais dans le terminal

Installation immediate

L'installation est non-invasive (plugin marketplace, 3 commandes). On peut l'installer et tester aujourd'hui sans toucher au workflow existant. Si ca marche bien, on l'integre dans le setup des Ringbearers.

Action recommandee

  1. Installer claude-hud en preset Minimal sur la session principale et tester 1-2 jours
  2. Si la barre de contexte est fiable et lisible : installer sur les Ringbearers LOTR
  3. Explorer si la statusline API peut etre parsee par le Lord (via capture cmux du statusline) pour alimenter la supervision avec le % de contexte
  4. Ajouter un item TODO pour integrer claude-hud dans le setup LOTR standard

Le vrai gain sera quand le Lord pourra dire via Signal : "⚠️ PD-285 contexte a 87 % — compaction recommandee" au lieu de decouvrir apres coup que l'agent a deraille.