Accueil / Articles

Skipper : Un tableau de bord local pour exécuter plusieurs sessions de Claude Code en même temps.

Un tableau de bord gratuit et open source qui suit les sessions de Claude Code, les sous-agents et les boucles, vous alerte pour les demandes d’autorisation et vous permet de diriger les agents depuis un navigateur ou un téléphone.

Éditeur : REACTAPP.TOP6 min de lecture1433 mots

Sources: Claude Code Dashboard: How I Track Multiple Claude Code Sessions, Subagents and Permission Prompts in One Place

La disposition de la terminal change dès que Claude Code cesse d’être une habitude réservée à une seule session. Quatre ou cinq sessions s’exécutent en parallèle : l’une refactore le backend, une autre écrit des tests dans un worktree Git, une /loop reste inactive en attendant que le CI se termine, et une dernière a généré trois sous-agents en arrière-plan qu’elle attend. Tout semble productif jusqu’à ce qu’un schéma se répète : en revenant à la terminal après vingt minutes, on constate que la session était restée inactive tout ce temps, se demandant si elle devait exécuter une commande. Cela représente vingt minutes d’un agent de codage IA inactif, simplement parce qu’il avait besoin d’une touche enfoncée tandis que l’attention était portée sur une autre fenêtre.

Exécuter plusieurs agents en parallèle est puissant, mais les terminaux n’ont jamais été conçus pour en gérer le suivi. La question importante est de savoir quelle session a besoin d’une personne en ce moment. Aucun outil existant ne répondait à cette question, c’est pourquoi Skipper a été créé.

Qu’est-ce que Skipper ?

Skipper est le centre de contrôle des missions pour Claude Code. Il s’agit d’un tableau de bord gratuit, local et open source qui affiche en temps réel toutes les sessions, sous-agents, /loop et listes de tâches présentes sur la machine, et vous permet de les gérer sans avoir à passer d’un terminal à l’autre. Une seule commande suffit pour le lancer :

npx github:bilol-makhmudov/skipper

Ouvrez http://localhost:4317 : chaque session s’affiche avec un état clair :

  • Nécessite une autorisation : Claude attend l’approbation pour utiliser un outil.
  • A besoin de vous : le tour est terminé et c’est à vous d’envoyer un message.
  • En cours : la session est en exécution, l’outil est utilisé et le temps écoulé depuis le début du tour est indiqué.
  • En veille : un /loop attend son prochain réveil, affiché avec un compte à rebours ainsi que la raison de sa pause.

Les sessions nécessitant une attention immédiate remontent en haut de la liste. Le titre de l’onglet indique le nombre de sessions en attente, et le favicon passe au jaune ou au rouge, de sorte qu’un onglet fixé continue de signaler l’état.

Surveillance des sous-agents, listes de tâches et boucles

En plus des états des sessions, le tableau de bord montre ce que fait chaque agent :

  • Listes de tâches en temps réel, ainsi que les listes de tâches des équipes d’agents avec leurs responsables et les éléments qui bloquent leur progression.
  • Sous-agents en arrière-plan avec leur nom, leur modèle, la branche du worktree et l’heure de leur dernière action.
  • Chronomètres /loop affichant le prochain réveil ainsi que la raison de la pause.
  • Flux de travail, demandes de pull et artefacts, à un clic de distance.
  • Un flux d’informations sur tout ce qui s’est produit pendant votre absence, sur toutes les sessions.
  • Utilisation des tokens par jour, par projet et par modèle, y compris les sous-agents, avec possibilité d’export en CSV.

Notifications pour les demandes de permission

C’est pour cette fonctionnalité que Skipper existe. Une seule commande suffit pour l’activer :

skipper hooks install

Cela ajoute deux points d’ancrage officiels de Claude Code, Notification et Stop, aux paramètres. Dès qu’une session demande une autorisation, un son retentit ainsi qu’une notification sur le bureau qui reste affichée jusqu’à ce qu’on y clique, indiquant précisément la commande en attente d’approbation. Une manche terminée déclenche un son plus doux.

Ces points d’ancrage ne font pratiquement rien : ils ajoutent une ligne dans un fichier d’événements local puis s’arrêtent, de sorte qu’ils ne peuvent ni ralentir une session ni la perturber, ce qui était plus important que n’importe quelle autre fonctionnalité. Ceux qui ne souhaitent pas garder une fenêtre du navigateur ouverte peuvent exécuter skipper hooks native on pour envoyer directement des notifications système.

Gérer, pas seulement observer

  • Envoyer un message à une session. Pour une session ouverte dans une terminal, le texte est ajouté directement à cette conversation. Une session terminée est relancée en arrière-plan, depuis son répertoire de travail initial.
  • Modifier les tâches. Il est possible d’en ajouter, de renommer, de les terminer ou de les supprimer, bien qu’une tâche qui bloque encore une autre ne puisse pas être retirée.
  • Notes privées. Chaque session peut contenir des notes, et l’on peut en transmettre une à Claude au moment opportun.
  • Mode lecture seule. Le flag --read-only désactive toute écriture.
  • Claude Code sur un téléphone, avec un assistant vocal

    Lorsque le tableau de bord a commencé à fonctionner, le souhait suivant était de l’utiliser en dehors du bureau, par exemple en préparant du thé tout en se demandant si une migration était terminée. Pour cela, Skipper dispose d’une application iPhone développée avec Flutter. La connexion s’effectue en scannant un code QR provenant du tableau de bord, et l’application affiche les mêmes sessions, activités et conversations. L’assistant vocal est la fonctionnalité la plus utilisée.

    Un simple clic sur le micro permet à la question « Qu’est-ce qui a besoin de moi ? » d’obtenir une réponse orale : quelle session attend l’autorisation, laquelle est terminée et laquelle est encore en cours. Une suite de commandes peut être exécutée sans avoir à répéter le nom de la session. En disant « Dites à la session de paiement d’arrêter après ce test », l’assistant lit le message à haute voix et attend, sans rien envoyer tant qu’on ne répond pas par oui. Il comprend l’anglais et l’ouzbek. En mode mains libres, il continue d’écouter et cesse de parler dès que l’utilisateur parle.

    Au fond, l’assistant n’est autre que Claude Code lui-même, exécuté sans interface graphique avec un petit ensemble d’outils Skipper en lecture seule accessibles via MCP, ainsi qu’un outil permettant de proposer un message. Il voit tout ce que voit Skipper et ne modifie rien sans confirmation.

    Comment Claude Code stocke les sessions sur disque

    La surprise agréable a été de constater que Claude Code écrit déjà tout ce dont un tableau de bord a besoin dans ~/.claude :

    • ~/.claude/projects/*/<session>.jsonl contient les transcriptions des sessions : demandes, réponses, listes de tâches à faire, sous-agents, boucles et demandes de fusion.
    • ~/.claude/sessions/*.json enregistre quelles sessions sont actives et si chacune est occupée ou inactive.
    • ~/.claude/tasks et ~/.claude/teams stockent les listes de tâches et les équipes d’agents.

    Les transcriptions sont lues de manière progressive à partir de la dernière position déjà traitée, ce qui permet au système de rester réactif même avec des historiques très volumineux. Les modifications sont transmises au navigateur via des Server-Sent Events dès que les détecteurs de fichiers sont activés, il n’y a donc ni requêtes périodiques ni bouton de mise à jour. Le backend est un simple Node.js sans dépendances en temps d’exécution, et le frontend se compose de HTML, CSS et JavaScript ordinaires, sans étape de compilation ni framework.

    Privilégier le local et la confidentialité

    Les sessions contiennent du code et des instructions, donc un outil qui les lit doit faire preuve de rigueur en matière de sécurité.

    • Aucune communication sortante. L’outil est fourni sans télémesure, sans CDN ni appel externe. Seules les réponses vocales optionnelles par téléphone sont envoyées en ligne, via les services de voix de Microsoft, tandis que l’étape de reconnaissance vocale est gérée localement par Whisper.
  • Lié par défaut au loopback. La validation de l’en-tête Host empêche le rebinding DNS.
  • Un jeton contrôle l’accès au téléphone. Sur un réseau local, la sortie de démarrage inclut un lien contenant un jeton aléatoire, et les demandes sans ce jeton ne reçoivent rien.
  • Les chemins d’écriture sont renforcés. Chacun exige un en-tête personnalisé, une charge utile JSON, une demande du même origine et des IDs qui passent la validation. La CLI claude reçoit les messages sous forme de liste d’arguments et jamais via une shell.
  • Politique de sécurité du contenu stricte. Tout le contenu est affiché sous forme de texte et jamais en HTML brut.
  • Installation

    npm install -g github:bilol-makhmudov/skipper
    skipper hooks install      # chime and notify on permission prompts
    skipper service install    # run in the background, start at login
    

    L’ajout des paramètres --demo --open ouvre une visite avec des sessions d’exemple. Node.js 20 ou une version ultérieure est requis, et macOS, Linux ainsi que Windows sont pris en charge.

    Questions fréquentes

    • Y a-t-il une vue pour chaque session ? Skipper découvre automatiquement les sessions situées dans ~/.claude, et une nouvelle session apparaît dès son démarrage.
    • Sont pris en compte les sous-agents, les équipes d’agents et les worktrees ? Oui. Les sous-agents en arrière-plan, les listes de tâches par équipe avec leurs responsables ainsi que les branches des worktrees sont tous affichés.
    • Y a-t-il un signal sonore lorsque des permissions sont nécessaires ? Après l’exécution de skipper hooks install, les demandes de permission, les questions posées et les tours terminés déclenchent tous un son et une alerte sur le bureau.
  • Un message peut-il atteindre un terminal déjà en cours d’exécution ? Il est ajouté à la conversation propre à ce terminal. Une session qui a été fermée est reprise discrètement en arrière-plan.
  • Qu’en est-il des coûts et du statut ? L’outil est gratuit et est licencié sous MIT. Il s’agit d’un projet indépendant qui n’a aucun lien avec Anthropic.
  • Le plan de développement prévoit des connexions téléphoniques chiffrées, une version pour Android ainsi que davantage de fonctionnalités permettant de gérer les sessions depuis n’importe où.