Agents Observe : Tableau de bord en temps réel pour la surveillance des équipes d'agents de code Claude

Ce que fait Agents Observe

Agents Observe est un tableau de bord d'observabilité en temps réel spécialement conçu pour les équipes d'agents Claude Code. Il comble le manque de visibilité lorsque Claude Code fonctionne de manière autonome – en générant des sous-agents, en appelant des outils, en lisant des fichiers et en exécutant des commandes – en capturant chaque événement de hook au moment où il se produit et en le diffusant vers un tableau de bord en direct.

Fonctionnalités principales et architecture

L'outil utilise les hooks de Claude Code au lieu d'OTEL (OpenTelemetry) pour capturer ce que le développeur décrit comme « l'image complète des actions des agents ». L'architecture suit ce flux :

• Hooks Claude Code → observe_cli.mjs → Serveur API (SQLite) → Tableau de bord React
• Le script de hook lit les événements bruts depuis stdin, ajoute le nom du projet et les envoie par POST au serveur
• Le serveur analyse les événements, stocke les métadonnées des agents (nom, type, parenté) et transmet les événements aux clients WebSocket
• Le tableau de bord React dérive tout l'état des agents du flux d'événements

Avec le tableau de bord, vous pouvez :

• Voir les appels d'outils s'afficher en temps réel (PreToolUse → PostToolUse avec résultats)
• Voir la hiérarchie complète des agents – quel sous-agent a été généré par quel parent
• Filtrer par agent, type d'outil ou rechercher dans tous les événements
• Développer n'importe quel événement pour voir la charge utile complète, la commande et le résultat
• Cliquer sur les icônes de la chronologie pour accéder à des événements spécifiques dans le flux
• Parcourir les sessions historiques avec des noms lisibles par l'homme (par exemple, « twinkly-hugging-dragon »)

Installation et configuration

Prérequis :

• Docker (requis – le serveur fonctionne comme un conteneur)
• Node.js (requis – les scripts de hook s'exécutent via node)

Étapes d'installation du plugin :

claude plugin marketplace add simple10/agents-observe
claude plugin install agents-observe

Après avoir redémarré Claude Code, le serveur démarre automatiquement comme un conteneur Docker lors de votre prochaine session, et les hooks commencent à capturer les événements. Le tableau de bord est disponible à l'adresse http://localhost:4981.

Compétences du plugin

• /observe – Ouvrir l'URL du tableau de bord et vérifier si le serveur fonctionne
• /observe status – Vérifier l'état du serveur et afficher l'URL du tableau de bord

Perspectives sur les performances du développement

Le développeur a partagé plusieurs apprentissages techniques lors de la construction et de l'utilisation de l'outil :

• Les hooks de Claude Code sont bloquants – les performances se dégradent rapidement avec de nombreux plugins qui utilisent des hooks
• Les hooks fournissent des informations plus utiles que les données OTEL
• Les fichiers jsonl de Claude fournissent l'image complète
• La gestion du cycle de vie des processus MCP lancés par les plugins est « un peu bancale au mieux »
• Passer à des hooks en arrière-plan (fire and forget) et supprimer d'autres plugins a considérablement amélioré les performances de Claude

Le développeur a mis en œuvre une solution de gestion des processus où le serveur suit les connexions actives et s'arrête automatiquement lorsqu'il n'est pas utilisé, puis le plugin le relance lorsqu'une nouvelle session commence. Cette approche basée sur Docker est notée comme un modèle qui pourrait améliorer la sécurité en isolant les services.