Documentation / Configuration
Fichiers et chemins
Mis à jour le
Tokenade range tout ce qui lui appartient dans deux dossiers de votre répertoire personnel : un dossier d'état, ~/.tokenade/, et un dossier de cache, ~/.cache/tokenade/. En dehors de ceux-ci, il écrit ses hooks et ses règles dans les fichiers de configuration de vos agents. Rien n'est stocké ailleurs, sauf si vous le demandez par une variable d'environnement.
Les deux arborescences, par système
| Linux | macOS | Windows | |
|---|---|---|---|
| État | ~/.tokenade/ | ~/.tokenade/ | %USERPROFILE%\.tokenade\ |
| Cache | ~/.cache/tokenade/ | ~/.cache/tokenade/ | %LOCALAPPDATA%\tokenade\ |
Comment elles sont déterminées :
- Répertoire personnel :
$HOMEsous Linux et macOS. Sous Windows,%USERPROFILE%passe en premier, carHOMEy est rarement défini (seuls Git Bash et MSYS2 le posent). - Cache :
$XDG_CACHE_HOMEs'il est défini, sinon%LOCALAPPDATA%, sinon$HOME/.cache, sinon%USERPROFILE%\AppData\Local. Une variable vide compte comme non définie. macOS utilise~/.cache, pas~/Library/Caches.
Sous Linux et macOS, Tokenade restreint ces dossiers à leur propriétaire (0700 pour les dossiers, 0600 pour les fichiers sensibles), parce que les caches peuvent contenir des lignes de commande capturées avant masquage.
Dans ~/.tokenade/
Compte et licence (déplacés ensemble par TOKENADE_CONFIG_DIR) :
| Fichier | Contenu |
|---|---|
license.key | Licence signée de cette machine, écrite par tokenade login. |
machine-id | Identifiant stable de la machine. |
quota.json | Dernier état du plan et du quota reçu de tokenade.net. |
reporter-offset, reporter-offset-estimated, report-health.json | Jusqu'où les registres d'usage ont été envoyés, et quand tokenade.net a répondu pour la dernière fois. |
update-check.json, auto-update-off | Dernière vérification de mise à jour ; le marqueur posé par tokenade upgrade --off. |
Économies et mémoire :
| Fichier | Contenu |
|---|---|
gain.jsonl | Registre des économies mesurées, une ligne par compaction. Rotation à 10 Mio. |
gain_estimated.jsonl | Économies estimées (concision, regroupement), tenues à part des mesurées. |
mistakes.jsonl | Mémoire des impasses. Voir Mémoire des impasses. |
redact.jsonl | Quelle règle de masquage a mordu, et quand. |
Index et caches (SQLite) :
| Fichier | Contenu |
|---|---|
index.db | Index des symboles pour map, query, impact, par chemin de projet. |
semantic.db | Embeddings pour semantic et --prompt. |
dedup.db | Sorties vues récemment, pour ne pas renvoyer deux fois les mêmes octets. |
fold_store.db, file_search.db | Magasin des sorties repliées et cache de recherche de fichiers. |
Chacune de ces cinq bases peut être déplacée avec TOKENADE_DEDUP_DB, TOKENADE_INDEX_DB, TOKENADE_SEMANTIC_DB, TOKENADE_FOLD_STORE_DB et TOKENADE_FILE_SEARCH_DB.
Configuration et journaux :
| Fichier | Contenu |
|---|---|
filters/ | Vos propres compacteurs, installés par tokenade add-compactor. Voir Compacteurs personnalisés. |
trusted-filters.json | Empreintes des filtres de projet que vous avez approuvés. |
install-options.json | Les options passées à tokenade install, reprises par les installations, mises à jour et réparations suivantes. tokenade install --defaults les oublie. |
statusline-off, statusline-promos-off | Marqueurs posés par tokenade statusline off et tokenade statusline promos off. |
shellproxy.sh, .csh, .nu, .cmd | Fragments du proxy shell, chargés par vos fichiers de démarrage du shell. |
debug.log, debug.log.1 | Journal de débogage, rotation à 16 Mio. Lisez-le avec tokenade hooks tail. |
dashboard.html | La page du tableau de bord local écrite par tokenade dashboard. |
last-report.zip | L'archive construite par tokenade report (y compris avec --dry-run). |
sessions/ | Petits fichiers d'état par session, nettoyés automatiquement. |
Vous verrez aussi des verrous, des horodatages et des marqueurs ponctuels. Ils sont internes, vous pouvez les ignorer.
Dans ~/.cache/tokenade/
| Chemin | Contenu |
|---|---|
stash/ | Sorties complètes remplacées par un résumé, récupérables avec tokenade expand-ref <hash>. Les entrées expirent après 7 jours ; le dossier est plafonné à 2 Gio (TOKENADE_STASH_MAX_DIR_BYTES). Déplacez-le avec TOKENADE_STASH_DIR. |
stash-keep/ | Marqueurs des entrées de réserve qui sont l'unique copie de quelque chose. |
model/ | Le modèle de recherche local, environ 132 Mo, téléchargé une fois au premier usage de semantic ou --prompt. Fournissez-le ailleurs avec TOKENADE_MODEL_DIR. |
Pour connaître la place occupée, lancez tokenade healthcheck : la ligne disk-footprint liste les plus gros éléments.
Dans un projet
Un dossier de projet peut contenir un dossier .tokenade/ :
.tokenade/filters/*.toml: compacteurs livrés avec le dépôt. Ils ne s'appliquent qu'aprèstokenade trust-filters..tokenade/reads/: copies PNG des images que votre agent ne sait pas afficher (.tiff,.bmp,.ico…), converties pour qu'il puisse les lire.
Tokenade ajoute .tokenade/ à votre fichier d'exclusion git global, ~/.config/git/ignore, pour que ce dossier ne soit jamais commité par erreur.
Fichiers d'agent modifiés par Tokenade
tokenade install ne touche qu'à ce dont chaque agent détecté a besoin. Les principaux fichiers :
| Agent | Fichiers |
|---|---|
| Claude Code | ~/.claude/settings.json (hooks marqués tokenade, statusLine, env), ~/.claude/CLAUDE.md (un bloc délimité par <!-- tokenade:start -->) |
| Codex | ~/.codex/hooks.json, entrées d'approbation des hooks dans ~/.codex/config.toml, ~/.codex/AGENTS.md |
| Cursor | ~/.cursor/hooks.json, ~/.cursor/rules/tokenade.mdc |
| Antigravity | ~/.gemini/GEMINI.md |
| GitHub Copilot CLI | ~/.copilot/hooks/tokenade.json, ~/.copilot/copilot-instructions.md |
| OpenCode / Kilo Code | ~/.config/opencode/plugin/tokenade.ts, ~/.config/kilo/plugins/tokenade.ts |
Si vous avez déplacé la configuration de Claude Code avec CLAUDE_CONFIG_DIR, Tokenade la suit. Avec tokenade install --per-project, les fichiers d'agent sont écrits dans ./.<agent>/ du projet courant plutôt que dans votre répertoire personnel. Les pages par agent détaillent chaque fichier ; tokenade uninstall --dry-run affiche la liste exacte sur votre machine.