# Mémoire des impasses (mistakes)

> tokenade mistake enregistre les approches qui n'ont pas marché, pour que votre agent se les voie rappeler à chaque début de session et ne les retente pas.

Source: https://tokenade.net/fr/docs/mistakes · Updated: 2026-10-07

`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

```text
tokenade mistake [list]
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é. `tokenade mistake list --json` affiche les enregistrements en JSON (`--json` exige le `list` explicite) |
| `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

```bash
tokenade mistake add "tried a global mutable cache, caused races" --ref deadbee
```

Gardez un résumé court et précis. L'agent en voit au plus 120 caractères.

## Enregistrer un revert

```bash
git show HEAD | tokenade mistake from-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

```text
$ tokenade mistake
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 :

```text
[tokenade:mistakes] N dead ends recorded on this machine (3 shown; …) — do not re-propose: "…"
```

- 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.

## Voir aussi

- [Comment les hooks interceptent les appels d'outils](https://tokenade.net/fr/docs/hooks)
- [Fichiers et chemins](https://tokenade.net/fr/docs/files-and-paths)
- [Claude Code (CLI et desktop)](https://tokenade.net/fr/docs/claude-code)
