↓ Aller au contenu
Garder un œil sur plusieurs sessions Claude Code à la fois
L’accueil : le nœud « Toi » en haut, les sessions ouvertes groupées par machine, les outils qu’elles utilisent en bas
  1. Articles/

Garder un œil sur plusieurs sessions Claude Code à la fois

··1354 mots·7 mins· ·
Sommaire
Une session Claude Code dans un terminal, ça se suit facilement. Trois sessions sur deux machines, chacune qui lance ses sous-agents, c’est une autre histoire. L’une restructure du code, l’autre fait tourner les tests, la troisième attend depuis vingt minutes que j’autorise une commande psql, et je ne m’en rends compte qu’en tombant par hasard sur le bon onglet.

C’est ce dernier cas, le vrai problème. Pas les agents qui travaillent : ceux qui attendent.

claude-agents-board est le tableau de bord que je me suis écrit pour ça. Il tourne dans mon homelab, chaque session Claude Code du réseau local lui envoie ce qu’elle fait, et un seul onglet du navigateur montre qui travaille, qui est au repos et qui a besoin de moi. Je n’ai pas cherché d’outil existant avant de l’écrire : je suis parti directement des hooks de Claude Code.

Comment il est branché
#

Les hooks de Claude Code se déclenchent sur à peu près tout ce que fait une session : un prompt, un appel d’outil, un sous-agent qui démarre ou s’arrête, une demande de permission, la fin d’un tour. Chaque machine envoie ces événements à un petit serveur Node, qui tient l’état et pousse les changements vers l’interface web. Il n’y a pas d’agent à installer, et rien ne change dans la façon d’utiliser Claude Code.

L’application sert elle-même son script d’installation. Brancher une machine tient en une ligne :

curl -fsSL http://agents.10.0.0.10.sslip.io/install-hooks.sh | sh -s -- --host portable

Le script ajoute les hooks à ~/.claude/settings.json sans toucher à ceux qui existent déjà, active la télémétrie et s’intercale devant la status line existante. Une version PowerShell existe pour Windows.

Un détail à connaître : Claude Code sait appeler des hooks HTTP, mais dans mes tests il refusait de joindre une adresse privée comme 10.0.0.10 : seule l’adresse de bouclage passait. Les hooks sont donc des hooks command qui transmettent l’événement à curl. Ils sont synchrones, pour que les événements arrivent dans l’ordre, et abandonnent au bout de deux secondes si le tableau de bord ne répond pas. Un tableau de bord en panne ne bloque jamais un agent.

Quand une session vous attend
#

La page d’accueil est un arbre : le nœud « Toi » en haut (c’est le libellé de l’interface), toutes les sessions ouvertes au milieu, groupées par machine, et en bas les outils qu’elles utilisent. Une session qui travaille respire en orange. Une session qui attend une réponse ou une permission passe en ambre, et le lien entre elle et vous se met à défiler.

Cet état ambre est la raison d’être de tout le reste. Un bandeau en haut de la page liste chaque session en attente, et un carillon, optionnel, sonne quand l’une d’elles demande une permission. Je ne découvre plus un agent bloqué par hasard.

Les boîtes des sessions : activité en cours et son chrono, barre de contexte, compactages et coût estimé
Chaque boîte dit ce que fait la session et depuis combien de temps : un outil, « réfléchit », « t’attend » ou « inactive ».

Chaque boîte indique aussi la barre de contexte, le nombre de compactages et le coût estimé. Les sous-agents en cours apparaissent en pastilles sur son bord. Une session inactive s’estompe progressivement entre cinq minutes et une heure, pour que celles que j’ai oubliées ne fassent pas concurrence à celles qui comptent.

Quand un agent met trop de temps
#

Timeline d'une session : le fil principal, deux sous-agents et la liste de tâches
La timeline d’une session : une ligne par tour du fil principal, par sous-agent et par tâche ; les pointillés donnent la fin estimée d’un agent en cours.

Un clic sur une session ouvre son détail, et la timeline est la vue que j’utilise le plus. Pour un sous-agent en cours, des pointillés indiquent quand il devrait finir : c’est la durée médiane des agents du même type déjà terminés, sur le même projet quand il en compte au moins trois. Rien de malin, mais assez pour distinguer un agent qui travaille d’un agent qui coince. L’en-tête copie aussi claude --resume <id> d’un clic, pour reprendre la session depuis un autre terminal.

Quand le contexte se remplit
#

Quand une session devient lente et un peu vague, la première question est toujours « elle va compacter ? », et la réponse est dans un terminal que je ne regarde pas.

Les hooks ne donnent pas la taille du contexte, mais la télémétrie OpenTelemetry de Claude Code permet de la calculer : chaque requête au modèle indique ses tokens d’entrée et de cache. Encore faut-il écarter les requêtes qui n’appartiennent pas à la conversation (titres de session, résumés de compactage) et séparer celles des sous-agents, identifiables depuis Claude Code 2.1.310. Le tableau de bord suit donc un contexte par fil ; le README détaille le calcul.

Carte d'une session : la jauge de contexte entoure l'agent principal
Dans la carte d’une session, la jauge de contexte entoure l’agent principal ; elle passe à l’orange à 60 % et au rouge à 85 %.

Combien il reste de la semaine
#

Avec un abonnement, le chiffre qui compte, c’est ce qu’il reste de la semaine. Ni les hooks ni la télémétrie ne le transmettent : seule la status line le reçoit, pour les abonnements Pro, Max et Ultra. C’est pour ça que le script d’installation s’intercale devant elle. Il envoie ces valeurs au tableau de bord, puis lance la status line d’origine, sans rien changer dans le terminal.

Les limites de l'abonnement dans la barre d'état : semaine et fenêtre de 5 h avec leurs dates de remise à zéro
Les deux limites de l’abonnement, la semaine et la fenêtre de 5 h, dans la barre du bas ; la date de remise à zéro s’affiche au survol.

La télémétrie donne aussi les tokens et un coût estimé, par session et sur sept jours par modèle. Ce coût est celui du tarif public de l’API : avec un abonnement, ce n’est pas ce qui est facturé. Je le lis comme un ordre de grandeur, et comme un moyen de repérer la session qui consomme de l’Opus depuis tout l’après-midi.

Et pour le plaisir
#

Le bureau : l'agent principal à l'accueil, un sous-agent à sa table
La vue bureau : l’agent principal à l’accueil, chaque sous-agent à sa table.

Chaque session a aussi son bureau en pixel art. Les sous-agents entrent par la porte, s’installent à une table, tapent ou lisent selon l’outil qu’ils utilisent, puis repartent. C’est utile ? Pas vraiment, la timeline dit la même chose en plus précis. Mais c’est la vue la plus amusante à regarder. Les personnages viennent des packs MetroCity et MetroCity Interior de JIK-A-4, sous licence CC0.

Ce qu’il ne fait pas
#

Il est pensé pour un réseau local, et ça se voit. L’interface n’a pas d’authentification : n’importe quel appareil du réseau peut lire les prompts, les commandes et les fichiers lus par les agents. Un jeton optionnel protège les routes qui reçoivent les données, pas la page ni son API, qui permet aussi de renommer ou d’effacer des sessions. Je ne l’exposerais pas en dehors de la maison.

Les hooks ne remontent pas tout non plus. Les messages intermédiaires du modèle ne sortent jamais de Claude Code, et les sous-agents lancés par un workflow arrivent sans leur consigne. Les tokens et le coût sont comptés par session, sans répartition par sous-agent. Sous Windows, le script PowerShell ne s’intercale pas encore devant la status line : il faut la brancher à la main. Et une session dont le terminal a été fermé brutalement reste affichée jusqu’au nettoyage automatique, au bout d’un jour par défaut.

L’essayer
#

Il vous servira si vous faites tourner plusieurs sessions Claude Code en parallèle, sur une ou plusieurs machines d’un même réseau local. Il faut Docker sur la machine qui l’héberge, puis :

git clone https://github.com/guillaumedelre/claude-agents-board.git && cd claude-agents-board
cp .env.example .env    # IP et DOMAIN de la machine, jeton optionnel
docker compose up -d --build

Chaque machine se branche ensuite avec la commande curl donnée plus haut. Chez moi, il tourne comme une stack de plus dans le homelab, derrière Traefik, sur un nom en sslip.io. Les captures de cet article viennent d’une instance de démonstration alimentée par des sessions fictives.

Si quelque chose ne marche pas chez vous, ou s’il vous manque quelque chose, les issues et les pull requests sont ouvertes.

Guillaume Delré
Auteur
Guillaume Delré

Articles connexes

Concevoir un homelab qui survit à ses services

··1771 mots·9 mins
Dans la première version de cet article, je présentais dix services. La plupart n’étaient là que pour l’exemple. Aujourd’hui, dix-huit stacks tournent sur ma machine : une IA locale, Home Assistant, un serveur de musique, des applis que j’ai écrites moi-même. Aucune n’a demandé de toucher à l’architecture. Ce qui compte dans un homelab, c’est la structure qui accueille les services, bien plus que leur liste. Une bonne structure rend l’ajout d’un service banal et sa suppression sans conséquence. Cet article décrit les huit principes qui tiennent la mienne, avec à chaque fois la manière dont je les applique.

HTTPS local avec Traefik : traefik.me est mort, vive sslip.io

··1198 mots·6 mins
Le dossier qui contient mon homelab s’appelle toujours traefik.me. C’est le dernier vestige d’une époque où chacun de mes services avait une adresse en HTTPS sans que j’aie rien à faire. Depuis mars 2025, ils sont tous en HTTP, et mon Traefik publie un port 443 que plus personne n’écoute. Cet article raconte ce qui a cassé, ce que j’ai remplacé tout de suite, et ce qu’il faut pour remettre le HTTPS, testé de bout en bout pour l’occasion.

Contrôler un lance-missiles USB en HTTP avec FastAPI et Docker

··880 mots·5 mins
La règle était simple : celui qui casse le build de la CI offre le café à l’équipe. Ça a marché un moment. Puis quelqu’un a trouvé qu’il nous fallait un retour plus immédiat, quelque chose de physique, qui tire. Un Dream Cheeky Thunder a atterri sur un bureau peu après. Quatre missiles en mousse, un câble USB, et un consensus très clair dans l’équipe : le brancher au cluster, le relier au pipeline de build, et laisser la CI décider qui mérite une salve.