Intensif Gratuit 21–22/11Intensif gratuit de 2 jours en Vibecoding (21–22 nov, 16h00 MSK) · Cohorte 3 le 23/11S'inscrire gratuitement →Cohorte 3 (23/11)
SortieAnalyse · Sur le radarHabr AI→ original

Un mod pour Claude Code qui dessine la carte du travail de l'agent récolte 1000 étoiles en 10 jours

L'auteur a demandé à un agent Claude Code de dessiner son propre travail, puis a transformé l'image en mod : au centre, le modèle ; autour, dix stations — fichiers, terminal, réseau, mémoire. En dix jours, le dépôt a récolté 1000 étoiles. Le 11 novembre, à la demande des utilisateurs, 14 versions sont sorties en une seule journée. Le mod se contente d'observer et ne modifie rien ; l'auteur a donc refusé les boutons d'interdiction et les skins. La leçon pour les auteurs d'extensions : un périmètre étroit et des principes écrits inspirent plus confiance qu'une accumulation de fonctions.

Traité par IA depuis Habr AI ; édité par Hamidun News
Un mod pour Claude Code qui dessine la carte du travail de l'agent récolte 1000 étoiles en 10 jours
Source : Habr AI. Collage: Hamidun News.
Écouter l'article
Fiche synthèse et chiffres clés
ParamètreDonnées
Source primaireHabr AI ↗
Rédacteur en chef
Chiffre clé #1iTerm2 est passé de 286 Mo à 17 Go en cinq minutes — l'affichage de l'image a été désactivé
Chiffre clé #2D'un curl avec jeton, il ne reste sur la carte que le mot curl ; d'une adresse, que l'hôte
Au Japon, un test sur 40 appelstous sont tombés sur la bonne station

Quand un agent travaille dans un terminal, on ne voit qu'un flux de lignes. Que fait-il à cet instant : lit-il des fichiers, accède-t-il au réseau, lance-t-il un sous-agent ? On peut le deviner, mais il faut scruter le journal. L'auteur du mod lot-map a réglé le problème de façon simple. Il a demandé à son agent Claude Code de dessiner comment il perçoit lui-même son processus de travail, puis a tiré une extension de ce dessin. En dix jours, le dépôt a obtenu 1000 étoiles. Pour un petit projet open source, c'est un bon résultat, et la façon dont il a été mené est plus remarquable encore.

Comment ça fonctionne et comment le projet a grandi

Sur la carte, le modèle occupe le centre, entouré de dix stations : fichiers, terminal, réseau, mémoire, sous-agents, hooks et d'autres. Quand l'agent appelle un outil, une impulsion file vers la station concernée, et les derniers appels s'affichent sous la carte. La première version est sortie le 9 novembre, et l'auteur l'a présentée sur r/ClaudeAI avec une vidéo. Dans la nuit du 11 novembre, le dépôt comptait 100 étoiles, 500 le 12 novembre, 1000 le 18 novembre.

La croissance a suivi les retours des utilisateurs. Rien que le 11 novembre, quatorze versions sont sorties : presque chaque demande en commentaire s'est transformée en release. C'est ainsi que sont apparus le retournement de la carte, les couleurs personnalisées, le fond transparent, la correction des chemins Windows et les libellés en italien et en portugais. La version actuelle est la 0.12.0. Ce que les utilisateurs saluent le plus, c'est l'anneau autour du centre, qui indique le taux de remplissage du contexte. Il existe aussi un compteur de tokens, qui montre combien chaque appel a ajouté au contexte.

Le terminal, iTerm2 et le catalogue d'Anthropic

Dans Claude Code, les images ne s'affichent que dans l'application et dans VS Code ; dans le terminal, il ne reste que des lignes. L'auteur a essayé de dessiner la carte avec des caractères et reconnaît que le résultat était mauvais : sept lignes sans mouvement. Des passionnés sont alors intervenus. L'un a envoyé une pull request de 2000 lignes, où le mod dessine lui-même un PNG et le transmet au terminal image par image (version 0.6.0). Un autre a réalisé la carte en braille pour les terminaux sans prise en charge des images, comme Windows Terminal.

Puis un bug désagréable est apparu. Un utilisateur a manqué de mémoire : iTerm2 est passé de 286 Mo à 17 Go en cinq minutes, car il conservait chaque image jusqu'à la fermeture de l'onglet. Le mod ne peut pas contourner ce problème de son côté, et la version 0.9.0 a désactivé l'image dans iTerm2. L'auteur a envoyé un rapport au développeur d'iTerm2, qui a corrigé l'erreur le lendemain. Dans la 0.12.0, l'image est revenue pour iTerm2 à partir de la version 3.7.8.

L'épisode du catalogue d'Anthropic s'est moins bien passé. Pour passer la validation, le hook de vérification des autorisations a été retiré du mod (version 0.4.0), et deux lignes ont disparu de la carte. Résultat : un refus, car le catalogue n'accepte des mods que d'organisations vérifiées. Le hook est revenu dans la 0.5.0. La leçon est simple : n'adaptez pas votre produit à une plateforme avant d'en avoir clarifié les conditions.

Ce qui a été refusé et pourquoi le mod inspire confiance

L'auteur a refusé les skins steampunk et comètes : la carte sert à comprendre d'un coup d'œil ce que fait l'agent, et une comète n'est que de la décoration. Il a refusé les boutons qui permettraient d'interdire à l'agent le réseau ou le terminal : le mod ne fait que regarder et ne modifie rien, et c'est ce qui fonde la confiance. Il a aussi refusé une couche pour d'autres agents, car personne n'a lancé la carte avec autre chose que Claude Code. Les ports vivent dans des dépôts séparés.

Le cinquième jour, six principes ont été formulés : le mod ne modifie rien ; dans l'étiquette, seul le nom apparaît, sans le contenu ; il ne coûte presque rien ; une panne de la carte n'empêche pas l'agent de travailler ; la carte reste calme ; les réglages de l'utilisateur restent intacts. Chaque principe est assorti d'un test qui le protège. Pour le premier, on vérifie que l'événement repart exactement tel qu'il est arrivé.

Pour le troisième, des mesures s'appuient sur un budget de temps. Le dépôt contient la liste de tout ce que le mod demande à Claude Code, et un contrôle sur chaque pull request compare le code à cette liste. Le réseau, la lecture de fichiers et le lancement de processus n'y figurent pas.

Le deuxième principe s'est imposé avant d'être écrit. Le mod voit chaque appel en entier : commandes, chemins, adresses avec paramètres, et l'écran se retrouve dans des captures d'écran. C'est pourquoi, d'un curl avec jeton, il ne reste que le mot curl, et d'une adresse, que l'hôte. Le troisième jour, un lecteur du code a trouvé une façon d'écrire une adresse telle que le mot de passe finissait quand même dans l'étiquette. Le correctif est sorti le jour même.

Vérifications externes

Un blogueur japonais a exécuté cinq tâches et quarante appels, en comparant la carte toutes les demi-secondes. Les quarante sont tombés sur la bonne station, et le nom de la cible s'est affiché dans trente cas. Sa conclusion : la carte donne une vue d'ensemble, mais ne remplace pas le journal. En Espagne, le mod a été passé dans un scanner de sécurité, et dix alertes ont été examinées à la main : toutes étaient de faux positifs, le scanner réagissant à curl et sudo dans les tests. Quelqu'un a réalisé un overlay pour Codex à partir des mêmes fichiers, un autre a ajouté un ruban indiquant la durée de chaque tour.

Pour ceux qui écrivent des extensions pour agents, la leçon est pratique. Un rôle étroit, « je ne fais que regarder », a permis de formuler des garanties vérifiables. Une liste de principes assortis de tests a aidé à refuser les idées des autres sans débat. Les limites sont aussi assumées : il s'agit d'une vue d'ensemble, pas d'un remplacement du journal, et dans les terminaux sans prise en charge des images, la carte est plus pauvre. Le mod est consultable dans le navigateur sur alexeyw.github.io/lot-map, et le code se trouve dans le dépôt alexeyw/lot-map.

Dossier

Questions clés sur cet article

Comment ça fonctionne et comment le projet a grandi?

Sur la carte, le modèle occupe le centre, entouré de dix stations : fichiers, terminal, réseau, mémoire, sous-agents, hooks et d'autres. Quand l'agent appelle un outil, une impulsion file vers la station concernée, et les derniers appels s'affichent sous la carte. La première version est sortie le 9 novembre, et l'auteur l'a présentée sur r/ClaudeAI avec une vidéo. Dans la nuit du 11 novembre, le dépôt comptait 100 étoiles, 500 le 12 novembre, 1000 le 18 novembre.

Que sait-on sur Le terminal, iTerm2 et le catalogue d'Anthropic ?

Dans Claude Code, les images ne s'affichent que dans l'application et dans VS Code ; dans le terminal, il ne reste que des lignes. L'auteur a essayé de dessiner la carte avec des caractères et reconnaît que le résultat était mauvais : sept lignes sans mouvement. Des passionnés sont alors intervenus. L'un a envoyé une pull request de 2000 lignes, où le mod dessine lui-même un PNG et le transmet au terminal image par image (version 0.6.0).

Que sait-on sur Ce qui a été refusé et pourquoi le mod inspire confiance ?

L'auteur a refusé les skins steampunk et comètes : la carte sert à comprendre d'un coup d'œil ce que fait l'agent, et une comète n'est que de la décoration. Il a refusé les boutons qui permettraient d'interdire à l'agent le réseau ou le terminal : le mod ne fait que regarder et ne modifie rien, et c'est ce qui fonde la confiance. Il a aussi refusé une couche pour d'autres agents, car personne n'a lancé la carte avec autre chose que Claude Code. Les ports vivent dans des dépôts séparés.

ZK
Zhemal Khamidun — CPO d'Alpina Digital, product manager d'AlpinaGPT. Conçoit des produits IA depuis 2019. Hamidun News est un projet personnel devenu un agrégateur en production avec plus de 6 000 lecteurs.
✦ Hands-On AI Engineering · Hamidun Academy

Build & Ship Production AI Agents Without Boilerplate Code

Start your free 72-hour trial at Hamidun Academy (academy.hamidun.com) — interactive lessons on Claude Code & Cursor, live Tech Radar, and production agent templates.

Start 72h Free Trial →Vibe-Coding Intensive
Qu'en pensez-vous ?
Chargement des commentaires…