# Fichiers et chemins

> Où Tokenade range ses registres d'économies, ses caches, sa réserve et son modèle sous Linux, macOS et Windows, et quels fichiers d'agent il modifie.

Source: https://tokenade.net/fr/docs/files-and-paths · Updated: 2026-10-16

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](https://tokenade.net/fr/docs/environment-variables).

## 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** : `$HOME` sous Linux et macOS. Sous Windows, `%USERPROFILE%` passe en premier, car `HOME` y est rarement défini (seuls Git Bash et MSYS2 le posent).
- **Cache** : `$XDG_CACHE_HOME` s'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/`

Mises à jour :

| Fichier | Contenu |
|---|---|
| `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, en gardant les 30 derniers jours. |
| `gain_estimated.jsonl` | Économies estimées (intelligence de code, relectures évitées, regroupement), tenues à part des mesurées. |
| `gain.rollup.jsonl`, `gain_estimated.rollup.jsonl` | Une ligne par jour et par compacteur, jamais soumis à rotation : c'est ce qui conserve les totaux depuis l'origine après une rotation. |
| `mistakes.jsonl` | Mémoire des impasses. Voir [Mémoire des impasses](https://tokenade.net/fr/docs/mistakes). |
| `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](https://tokenade.net/fr/docs/custom-compactors). |
| `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` | Marqueur posé par `tokenade statusline 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`. |
| `sessions/` | Petits fichiers d'état par session, nettoyés automatiquement. |
| `style.json` | Le style de réponse choisi avec [`tokenade style`](https://tokenade.net/fr/docs/style-statusline). |
| `receipt-ed25519.key` | La clé propre à l'installation qui signe [`tokenade receipt`](https://tokenade.net/fr/docs/gain-dashboard-receipt). |
| `litellm-costs.json`, `llm-costs.json` | Listes de prix des modèles en cache (LiteLLM, Helicone), rafraîchies au plus une fois par jour, pour les montants en dollars. |

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ès `tokenade 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.

## Voir aussi

- [Variables d'environnement](https://tokenade.net/fr/docs/environment-variables)
- [Ce que Tokenade envoie et conserve](https://tokenade.net/fr/docs/privacy-telemetry)
- [Mettre à jour et désinstaller](https://tokenade.net/fr/docs/upgrade-uninstall)
- [Compaction des sorties et réserve](https://tokenade.net/fr/docs/compaction)
