Documentation / Fonctionnement
Mémoire des impasses (mistakes)
Mis à jour le
tokenade mistake tient une courte liste des pistes qui n'ont pas fonctionné : une approche abandonnée, un changement annulé par un revert. À chaque début de session, votre agent se voit rappeler les plus récentes, pour ne pas passer un nouvel après-midi sur une idée déjà écartée.
Utilisation
tokenade mistake add <summary…> [--ref <commit>]
git show … | tokenade mistake from-revert
Alias : mistakes.
| Sous-commande | Effet |
|---|---|
list (défaut) | Affiche ce qui a été enregistré. --json affiche les enregistrements en JSON |
add <summary…> | Enregistre une impasse avec vos propres mots |
--ref <commit> | Avec add : rattache l'enregistrement au commit concerné |
from-revert | Lit une sortie git sur l'entrée standard et n'enregistre une impasse que si elle décrit un revert |
Enregistrer une impasse à la main
Gardez un résumé court et précis. L'agent en voit au plus 120 caractères.
Enregistrer un revert
from-revert cherche la première ligne contenant Revert. Avec le message standard Revert "<subject>", il enregistre reverted: <subject>. Si l'entrée n'est pas un revert, rien n'est enregistré et la commande affiche no revert detected : vous pouvez donc y envoyer n'importe quel commit sans risque, par exemple depuis l'un de vos propres hooks git.
Tokenade ne surveille pas votre dépôt : un revert n'est enregistré que si vous le lui transmettez.
Lister
tokenade mistake — 2 recorded
[manual] tried global mutable cache, caused races (deadbee)
[revert] reverted: add broken cache layer
[manual] vient de add, [revert] de from-revert.
Ce que voit votre agent
En début de session, dès qu'il existe au moins un enregistrement, le hook SessionStart ajoute une ligne au contexte de l'agent :
- Seuls les 3 enregistrements les plus récents sont montrés, chaque résumé coupé à 120 caractères.
- Rien n'est ajouté quand la liste est vide : une fonction inutilisée ne coûte aucun token.
- Les agents dotés d'un hook de début de session le reçoivent : Claude Code (CLI et onglet Code de l'app de bureau), Codex, Copilot CLI, Droid et les agents de la famille Gemini. Grok ignore la sortie de début de session et ne voit donc pas ce rappel.
Stockage
| Élément | Valeur |
|---|---|
| Fichier | ~/.tokenade/mistakes.jsonl |
| Champs | ts, kind (revert ou manual), summary, reference facultatif |
| Conservation | 30 jours, puis retiré par rotation |
| Portée | Par machine, partagé entre tous les projets |
Le fichier est local et n'est jamais envoyé. Pour retirer un enregistrement, modifiez ou supprimez le fichier ; c'est du JSON Lines ordinaire.