Atlas
Tout ce que le graphe Atlas dessine est observé : le CPU lu par le collecteur, les octets émis par le PTY, les phases rapportées par les hooks de Claude Code. ht atlas est le seul canal en sens inverse — celui où ce qui fait le travail dit quelque chose qu’aucune observation ne révélerait.
Quatre verbes, délibérément peu nombreux :
| Verbe | Dit |
|---|---|
pin | ce nœud compte en ce moment ; garde-le visible |
note | une ligne de contexte — ce qui le bloque réellement |
meter | une mesure nommée 0…1 — où il en est dans un travail |
mark | un jalon horodaté sur la rivière d’activité |
Chaque verbe sauf mark agit sur un nœud, c’est-à-dire une surface ou un espace de travail — les identifiants que le graphe utilise déjà :
ht atlas pin # ce panneau (HT_SURFACE), ou le panneau focaliséht atlas pin --surface surface:3ht atlas pin --workspace ws:2Dans un panneau τ-mux, HT_SURFACE est déjà exporté : un agent annote donc son propre nœud sans le moindre argument.
pin / unpin
Section intitulée « pin / unpin »ht atlas pinht atlas unpinUn nœud épinglé gagne un badge pinned et le graphe déplie le chemin qui y mène — une épingle laissant le nœud replié dans un espace de travail fermé n’aurait rien fait. À utiliser quand vous allez travailler là où l’utilisateur ne regarde pas.
ht atlas note "en attente de la CI"ht atlas note "conflit de rebase dans pane-layout.ts" --tone errLa note devient le sous-titre du nœud et la première ligne de son inspecteur. Elle prime sur le sous-titre dérivé : ce que l’agent dit faire l’emporte sur ce que τ-mux a déduit d’argv.
--tone info|ok|warn|err colore la ligne d’inspecteur. Plafonné à 200 caractères — une ligne, pas un journal.
ht atlas meter build 0.62ht atlas meter build 62 # 0–100 est lu comme un pourcentageht atlas meter tests 0.4 --label "142/350 fichiers"Une mesure nommée 0…1, affichée en badge et en arc extérieur du nœud. La première mesure publiée prend l’arc ; les suivantes restent des badges. Quatre par nœud, la plus ancienne étant évincée.
Les valeurs hors de 0…1 sont bornées plutôt que refusées : un appelant qui rapporte 1.4 veut dire « terminé ».
ht atlas clear --surface surface:3 # supprimer les annotations de ce nœudht atlas mark "migration appliquée"ht atlas mark "déploiement échoué" --tone errUn repère horodaté sur la rivière d’activité. La rivière montre déjà à quel point chaque espace de travail a été bruyant ; un repère dit et voilà quand la chose qui vous intéressait s’est produite.
Les repères expirent après 10 minutes et sont plafonnés à 50 — ils annotent le passé récent, pas un historique.
clear / state
Section intitulée « clear / state »ht atlas clear # ce nœudht atlas clear --all # tout, repères comprisht atlas state # relire ce qui est annotéDurée de vie
Section intitulée « Durée de vie »Les annotations vivent en mémoire et ne sont pas persistées. Elles décrivent un travail en cours : une note sur ce qui bloquait une session il y a une heure serait pire que pas de note, car elle survivrait à sa vérité sans moyen de le savoir.
Pour aller plus loin
Section intitulée « Pour aller plus loin »- Variantes de disposition → Atlas — ce que le graphe dessine et comment le lire
- JSON-RPC
atlas.* ht plan— pour les plans par étapes, que le graphe affiche également