# Commandes de maintenance

> Vérifier l'installation, inspecter les hooks, repérer les outils en conflit, libérer de l'espace disque et effacer un secret divulgué.

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

Ces commandes gardent une installation de Tokenade en bon état : vérifier qu'elle est bien branchée, voir ce que font les hooks, repérer les outils qui entrent en conflit, libérer de l'espace disque et nettoyer un secret divulgué. À part `upgrade`, aucune ne contacte le réseau d'elle-même (comme tout appel à `tokenade`, elles peuvent lancer la [vérification quotidienne des mises à jour](https://tokenade.net/fr/docs/upgrade-uninstall) en arrière-plan, que `TOKENADE_NO_AUTO_UPDATE=1` désactive).

## Diagnostiquer

### healthcheck

```text
tokenade healthcheck [--json]
```

Alias : `health`, `doctor`. Exécute une vérification par ligne et indique le correctif quand quelque chose ne va pas.

| Identifiant | Ce qui est vérifié |
| --- | --- |
| `binary` | Quel binaire `tokenade` s'exécute et sa version ; avertit quand plusieurs copies sont dans votre `PATH` |
| `gain_ledger` | `~/.tokenade/gain.jsonl` est accessible en écriture |
| `agent_detect` | Quel agent est configuré pour ce répertoire |
| `hook_installed` | Les entrées de hooks de Tokenade sont présentes dans `~/.claude/settings.json` |
| `mcp_entry` | Aucune entrée `tokenade` obsolète ne reste dans les `mcpServers` d'un agent (Tokenade passe d'abord par les hooks) |
| `wrapped_mcps` | Les entrées MCP tierces enveloppées pointent vers le binaire actuel |
| `semantic_model` | Le modèle d'embeddings est en cache |
| `stale_mcp_procs` | Aucun ancien processus MCP de Tokenade ne tourne sur un binaire supprimé |

Il signale aussi l'espace disque utilisé, les plugins passerelles qui ne se sont jamais déclenchés, l'approbation des hooks Codex et, depuis la 1.2.1, les dossiers où Claude Code n'a pas reçu votre accord de confiance (Claude Code n'y exécute aucun hook).

```text
$ tokenade healthcheck
─── tokenade healthcheck ───
  OK  gain ledger writable at ~/.tokenade/gain.jsonl
  OK  every hook runs the same tokenade binary
  OK  Codex hooks trusted — compaction active (6 hook(s))
  OK  agent detected: claude-code
  --  semantic model NOT cached (fetched once, ~30 MB, on first `semantic` use)
  …
  all checks passed
```

`--json` affiche `version`, `failures`, `ok` et `checks[]`, chacun avec un `id` stable exploitable en CI. Code de sortie `0` quand toutes les vérifications passent (les lignes `--` sont informatives), `1` quand au moins une échoue.

### hooks

```text
tokenade hooks <status|tail [N]> [--json]
```

| Sous-commande | Effet |
| --- | --- |
| `status` (défaut) | Chaque hook Claude Code installé, avec son événement, puis l'activité récente des hooks |
| `tail [N]` | Les N derniers déclenchements de hooks lus dans `~/.tokenade/debug.log` (20 par défaut) |

### detect

```text
tokenade detect [--json]
```

Affiche l'agent en cours (d'après l'environnement, puis d'après les fichiers du projet comme `.claude/`, `.cursor/`, `AGENTS.md`), le canal qu'utilise ce type d'agent, et l'emplacement de sa configuration MCP.

```text
$ tokenade detect
claude-code
coverage: hooks (PostToolUse) — command output is compacted and the saving is measured
mcp config hint: .mcp.json (third-party servers only)
```

La ligne `coverage:` décrit le type d'agent, pas votre machine. Pour savoir si Tokenade est réellement installé, lancez `tokenade health`.

### incompatibilities

```text
tokenade incompatibilities [--json]
```

Alias : `incompat`, `competitors`, `detect-competitors`, `scan`. Cherche d'autres outils de réduction de tokens (fichiers de configuration, binaires, démons en cours) et classe chacun :

| Classe | Signification |
| --- | --- |
| `[redundant]` | Tokenade fait déjà ce travail ; vous pouvez le retirer |
| `[overlapping]` | Tokenade le remplace ; migrez vos données, puis retirez-le |
| `[wasteful]` | Connu pour gonfler la consommation de tokens ; désactivation recommandée |
| `[compatible]` | Complémentaire ; gardez-le |

Lecture seule. Le nettoyage lui-même a lieu pendant `tokenade install` (à éviter avec `--no-cleanup`).

### discover et measure

```text
tokenade discover [--days N] [--json]
tokenade measure [--json]
```

`discover` parcourt vos sessions Claude Code des N derniers jours (30 par défaut) et liste les 15 outils les plus lourds en octets, si le hook Bash est en place, et jusqu'à 5 outils que les hooks compresseraient. `measure` additionne les tokens de chaque fichier que votre agent charge au démarrage d'une session (`CLAUDE.md`, `AGENTS.md`, `GEMINI.md`, `.cursorrules`, `.windsurfrules`, `.clinerules`, `.github/copilot-instructions.md`, `.claude/*.md`) et les compare à un objectif de 800 tokens. Les deux sont en lecture seule.

### audit-claude-md

```text
tokenade audit-claude-md [DIR] [--json]
```

Alias : `claudemd`, `audit-claudemd`, `claude-md-audit`. Parcourt la cascade de `CLAUDE.md` (le fichier global plus un par répertoire, de la racine du dépôt jusqu'à `DIR`), indique le coût en tokens de chaque fichier et les lignes dupliquées d'un fichier à l'autre, avec les tokens récupérables en les gardant à un seul endroit. Déterministe, sans LLM.

### read-mode

```text
tokenade read-mode [--json]
```

Montre avec quelle agressivité les longues listes et lectures sont repliées. Réglez-le avec `TOKENADE_READ_MODE` :

| Mode | Garde en clair | Pour |
| --- | --- | --- |
| `aggressive` | Moins | Modèles bon marché, contexte serré |
| `task` | Par défaut | Par défaut |
| `reference` | Davantage | Configurations, schémas, diffs complets |
| `entropy` | Les lignes les plus informatives, dans l'ordre | Sorties mixtes |

Alias acceptés par la variable : `aggro`/`terse`, `balanced`/`default`, `ref`/`full`, `dense`.

## Nettoyer

### evict-stale

```text
tokenade evict-stale [--models]
```

Supprime tout ce que Tokenade stocke et qui n'a pas servi depuis 7 jours : caches, index de code par projet, sorties rangées dans le stash, état des sessions et copies d'images réduites. Il retire aussi de `gain.jsonl` les lignes sans économie, oublie les projets qui n'existent plus, puis compacte ses bases locales.

`--models` supprime aussi les poids des modèles locaux, qui n'ont pas de durée de vie et peuvent être ce que Tokenade stocke de plus gros ; ils se retéléchargent à la demande. Sans cette option, `evict-stale` se contente d'indiquer leur taille.

Sans risque, à tout moment. Une fois une entrée du stash supprimée, son hash ne peut plus être déplié et la commande doit être relancée.

### scrub-secret

```text
tokenade scrub-secret <substring> [--dry-run] [--yes]
```

Outil d'urgence quand un identifiant a fuité. Remplace chaque occurrence de `<substring>` par `<redacted>` dans chaque fichier `.jsonl` et `.log` de `~/.tokenade/` (`debug.log`, `gain.jsonl`…), dans `~/.tokenade/dedup.db` et le stash ; les entrées concernées de `semantic.db` et `file_search.db` sont supprimées plutôt que corrigées.

Les fichiers sont modifiés sur place, sans sauvegarde, puisqu'une sauvegarde conserverait le secret. Un vrai passage montre ce qu'il a trouvé et demande confirmation avant d'écrire ; `--yes` répond d'avance et est obligatoire quand l'entrée standard n'est pas un terminal. **Le nettoyage n'annule pas une exposition antérieure : changez l'identifiant.**

### scrub-cache et redact

```text
tokenade scrub-cache [--dry-run]
tokenade redact <file…> [--in-place] [--dry-run]
```

`scrub-cache` réapplique les motifs de masquage intégrés (AWS, GitHub, Stripe, Twilio, SendGrid et d'autres) à chaque ligne de `dedup.db` et à chaque fichier texte du stash. À lancer après une mise à jour ou après avoir changé des identifiants. Idempotent.

```text
$ tokenade scrub-cache --dry-run
[tokenade scrub-cache --dry-run] reporting what WOULD change; no writes
  ◐  dedup.db — 123 row(s) WOULD be redacted; …
  ◐  stash — 2 file(s) WOULD be redacted; …
  --  file_search.db — nothing to redact
```

`redact` applique les mêmes motifs au fichier de votre choix. Par défaut, il écrit `<file>.redacted` et laisse l'original intact ; `--in-place` écrase de façon atomique ; `--dry-run` se contente de compter. Il traite ligne par ligne, donc les fichiers de plusieurs Go ne posent pas de problème.

## Autres utilitaires

| Commande | Effet |
| --- | --- |
| `tokenade pack [PATH] [--budget N] [--diff \| --base <ref>] [--out FILE] [--json]` | Exporte un dépôt (ou seulement les fichiers modifiés) en un seul paquet markdown sous un budget de tokens ; les fichiers hors budget sont listés, pas ignorés en silence |
| `tokenade turn-summary [--max N] [<file>\|-]` | Court résumé d'un tour de conversation, en N phrases (5 par défaut) |
| `tokenade add-compactor`, `tokenade trust-filters` | Ajouter vos propres compacteurs et approuver les filtres d'un dépôt ; voir [compacteurs personnalisés](https://tokenade.net/fr/docs/custom-compactors) |
| `tokenade upgrade [--check \| --on \| --off]` | Mise à jour sur place depuis le manifeste de version signé ; voir [mettre à jour et désinstaller](https://tokenade.net/fr/docs/upgrade-uninstall) |

## Voir aussi

- [Dépannage](https://tokenade.net/fr/docs/troubleshooting)
- [Mettre à jour et désinstaller](https://tokenade.net/fr/docs/upgrade-uninstall)
- [Fichiers et chemins](https://tokenade.net/fr/docs/files-and-paths)
- [Ce que Tokenade envoie et stocke](https://tokenade.net/fr/docs/privacy-telemetry)
