Documentation / Commandes
Commandes de maintenance
Mis à jour le
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é. Aucune n'envoie quoi que ce soit sur le réseau, à l'exception d'upgrade.
Diagnostiquer
healthcheck
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é, l'état de la licence, 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).
─── 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
| 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
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.
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
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
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
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
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, ref/full, dense.
Nettoyer
evict-stale
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
Outil d'urgence quand un identifiant a fuité. Remplace chaque occurrence de <substring> par <redacted> dans ~/.tokenade/debug.log, ~/.tokenade/gain.jsonl, ~/.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
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.
[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 |
tokenade upgrade [--check | --on | --off] | Mise à jour sur place depuis le manifeste de version signé ; voir mettre à jour et désinstaller |