Claude HUD : un plugin de barre d'état pour l'activité des sessions Claude Code

Une barre d'état qui répond à ce qui se passe maintenant

Claude HUD est un plugin Claude Code qui affiche une barre d'état persistante sous la saisie. La disposition par défaut sur deux lignes montre le nom du modèle, le libellé du fournisseur lorsqu'il est identifié positivement, le chemin du projet et la branche git sur la première ligne ; la deuxième ligne montre une barre de contexte et les limites d'utilisation. Des lignes optionnelles peuvent être activées pour afficher l'activité des outils, les agents en cours et la progression des tâches. Le README inclut des exemples de sortie pour chaque option, comme `> Edit: auth.ts | OK Read x3 | OK Grep x2` pour les outils, une ligne d'agent avec le temps écoulé et une ligne de tâches avec des compteurs de progression.

Installation via le marketplace de plugins

L'installation se fait dans Claude Code. Le README liste trois étapes : ajouter le marketplace avec `/plugin marketplace add jarrodwatts/claude-hud`, installer le plugin avec `/plugin install claude-hud`, puis exécuter `/claude-hud:setup` pour configurer la barre d'état. Ensuite, `/reload-plugins` prend en compte le changement sans redémarrage. Pour les utilisateurs de terminal, les mêmes commandes peuvent être exécutées avec la CLI : `claude plugin marketplace add` et `claude plugin install`. Le README documente également deux avertissements spécifiques à la plateforme : les utilisateurs Linux avec d'anciennes versions de Claude Code peuvent rencontrer une erreur EXDEV due à `/tmp` étant un système de fichiers séparé, et les utilisateurs Windows peuvent avoir besoin d'installer Node.js LTS si l'installation signale aucun runtime JavaScript. Les deux solutions sont décrites en détail.

Comment le plugin rend et actualise

Claude HUD utilise l'API native de barre d'état de Claude Code, donc aucune fenêtre séparée ni tmux n'est nécessaire. Il lit le JSON de stdin pour les données de tokens et de limites, analyse le transcript JSONL pour l'activité des outils, des agents et des tâches, et écrit une chaîne rendue sur stdout. Le README indique que l'affichage est re-rendu après chaque interaction (nouveau message de l'assistant, `/compact`, changements de permissions, bascules du mode vim) avec un débounce de 300 ms. Les pourcentages de contexte sont basés sur les données de tokens natives de Claude Code, non estimées, et le plugin s'adapte à la taille de la fenêtre de contexte signalée, y compris les sessions de contexte 1M plus récentes.

Préréglages, configuration guidée et remplacements manuels

La commande `/claude-hud:configure` propose un flux guidé pour la disposition, la langue des libellés et les bascules d'affichage courantes, avec un aperçu avant l'enregistrement. Trois préréglages sont disponibles : Full active tout, Essential affiche les lignes d'activité plus le statut git, et Minimal affiche uniquement le nom du modèle et la barre de contexte. Après avoir choisi un préréglage, les éléments individuels peuvent être activés ou désactivés. Les paramètres avancés sont modifiés directement dans `~/.claude/plugins/claude-hud/config.json`, notamment `colors.*`, `pathLevels`, `maxWidth`, les remplacements de seuils, `display.timeFormat` et `display.promptCacheTtlSeconds`. Le README indique que la configuration guidée conserve ces paramètres manuels tout en vous permettant de changer la langue, la disposition et les bascules courantes. Les libellés en chinois simplifié et traditionnel sont facultatifs, `zh` correspondant au simplifié et `zh-TW` au traditionnel ; la configuration guidée écrit `zh-Hans` ou `zh-Hant`.

Limites d'utilisation, coût et cache de prompt

L'affichage de l'utilisation est activé par défaut lorsque Claude Code fournit les données `rate_limits` de l'abonné sur stdin. Il montre la consommation des limites sur la deuxième ligne, avec un pourcentage sur 7 jours apparaissant lorsqu'il dépasse un seuil configurable (80% par défaut). Les utilisateurs avec uniquement une clé API ne voient aucun affichage d'utilisation car ils ne sont pas soumis aux limites de débit. Les modèles Bedrock et Vertex AI masquent l'utilisation et le coût par défaut, car la facturation est gérée par le fournisseur cloud ; `display.showRoutedCost` réactive le coût pour ces fournisseurs. L'affichage du coût préfère le champ natif `cost.total_cost_usd`, avec une estimation basée sur les tokens si ce champ est absent. L'élément de cache de prompt est entièrement facultatif et repose sur l'horodatage de la dernière réponse de l'assistant dans le transcript, avec un TTL par défaut de 300 secondes.

Conception locale uniquement et verrou extra-cmd

Le README décrit Claude HUD comme étant local par conception : il ne fait aucune requête réseau, ne récupère pas d'identifiants et n'appelle pas d'API Claude non documentées. Il lit le JSON de barre d'état depuis stdin, le chemin du transcript de session, certains fichiers de configuration Claude sous `~/.claude` et les métadonnées git. Les fichiers de cache sont écrits sous `~/.claude/plugins/claude-hud` avec des permissions privées sur les systèmes de fichiers POSIX. La fonctionnalité `--extra-cmd` est désactivée sauf si la variable d'environnement `CLAUDE_HUD_ALLOW_EXTRA_CMD=1` (ou true/yes/on) est présente ; le README avertit de traiter cette option comme une exécution de code arbitraire et de ne pas utiliser de commandes provenant de sources non fiables. Une variable d'environnement `CLAUDE_HUD_DISABLE` peut supprimer le HUD pour une session.

Prérequis, développement et licence

Le README liste Claude Code v1.0.80+ comme prérequis, Node.js 18+ ou Bun sur macOS/Linux, et Node.js 18+ sur Windows. Pour le développement, le dépôt utilise `npm ci && npm run build` et `npm test` après le clonage. Le projet est sous licence MIT, qui accorde la permission d'utiliser, copier, modifier, fusionner, publier, distribuer, sous-licencier et vendre des copies du logiciel, à condition que l'avis de droit d'auteur et l'avis de permission soient inclus. Le texte de licence fournit explicitement le logiciel "tel quel" sans garantie d'aucune sorte, et le README ne fait aucune déclaration sur le support, les garanties de sécurité ou l'état de préparation à la production au-delà de ce qui est décrit dans les notes de sécurité.

Conclusion éditoriale

Claude HUD est un plugin de barre d'état configurable qui repose sur l'API native de barre d'état de Claude Code et le transcript JSONL, sans requêtes réseau et sous licence MIT.

Sources officielles

1. Official README
2. Project repository
3. Release notes