# Mettre à jour et désinstaller

> Comment Tokenade se met à jour toutes les 24 heures, comment forcer ou couper les mises à jour, et comment tokenade uninstall retire hooks, données et binaire.

Source: https://tokenade.net/fr/docs/upgrade-uninstall · Updated: 2026-10-16

Tokenade se tient à jour tout seul : en temps normal, vous ne lancez jamais de mise à jour à la main. Et si vous voulez partir, une seule commande défait tout ce qu'il a mis en place. Cette page couvre les deux.

## Mises à jour automatiques

Au plus une fois toutes les 24 heures, n'importe quel appel à `tokenade` (un hook, un `wrap`, la barre d'état) lance une vérification en arrière-plan. Elle cherche la dernière version sur [GitHub Releases](https://github.com/pi-infected/tokenade/releases) et, si elle est plus récente, la télécharge, la vérifie et remplace le binaire de façon atomique. Votre agent continue de tourner ; l'appel suivant utilise la nouvelle version.

Après le remplacement, c'est le binaire fraîchement installé qui termine le travail : il redémarre les proxys LLM locaux qui tournaient sur l'ancienne version et réécrit les fichiers de règles que Tokenade tient pour vos agents. Les options passées à `tokenade install` (`--no-hook`, `--only`, `--no-debug-log`…) sont conservées d'une version à l'autre.

## Forcer ou piloter les mises à jour

```bash
tokenade upgrade            # vérifie maintenant et installe si plus récent
tokenade upgrade --check    # affiche seulement ce qui est disponible, sans remplacement
tokenade upgrade --off      # coupe la vérification en arrière-plan (durablement)
tokenade upgrade --on       # la réactive
```

`self-update` est un alias d'`upgrade`. `--off` écrit un fichier marqueur, `auto-update-off`, dans `~/.tokenade/`. Pour sauter la vérification le temps d'une session seulement, posez `TOKENADE_NO_AUTO_UPDATE=1` dans l'environnement.

Sous Windows, un `.exe` en cours d'exécution ne peut pas être écrasé : l'ancien binaire est renommé en `.old` et remplacé au démarrage suivant.

### Installations gérées par un gestionnaire de paquets

Si le dossier du binaire n'est pas inscriptible par vous (npm installé globalement en root, Homebrew, paquet système), le remplacement est refusé avec :

```text
binary parent dir … is not writable — likely a system-managed install (npm -g as root, Homebrew, apt, etc.). Update through that package manager instead (e.g. `npm update -g` / `brew upgrade tokenade`).
```

Pour une installation npm, mettez à jour avec :

```bash
npm update -g @tokenade/cli
```

## Désinstaller

```bash
tokenade uninstall --dry-run   # liste tout ce qui serait retiré, ne change rien
tokenade uninstall             # retrait complet
```

La commande complète enchaîne sept étapes, dans cet ordre :

1. Rend à chaque serveur MCP enveloppé par `tokenade mcp-wrap` sa `command` et ses `args` d'origine. Cette étape passe en premier : même une désinstallation interrompue laisse vos serveurs MCP fonctionnels.
2. Retire le bloc délimité `<!-- tokenade:start -->` … `<!-- tokenade:end -->` de `~/.claude/CLAUDE.md`, après en avoir fait une copie.
3. Retire l'entrée `tokenade` des `mcpServers` / `mcp` de chaque configuration d'agent détectée.
4. Retire chaque groupe de hooks marqué `tokenade` de `~/.claude/settings.json`, et fait de même pour les autres agents (hooks Codex et leurs approbations, Cursor, Copilot, plugins OpenCode et Kilo Code…).
5. Retire le proxy shell de chaque fichier de démarrage (`.bashrc`, `.zshenv`, `.zshrc`, `config.fish`, PowerShell, `.cshrc`…) et supprime les fragments `~/.tokenade/shellproxy.*`.
6. Supprime les données de Tokenade : `~/.tokenade/` (registre d'économies, bases, journal de débogage) et `~/.cache/tokenade/` (réserve, modèle). Seules ces deux arborescences sont supprimées, et les liens symboliques ne sont jamais suivis hors de celles-ci.
7. S'occupe du binaire selon la façon dont il a été installé :

| Installé avec | Ce que fait uninstall |
|---|---|
| npm | Affiche `npm uninstall -g @tokenade/cli` (le binaire appartient à npm). |
| cargo | Affiche `cargo uninstall tokenade-cli`. |
| Homebrew | Affiche `brew uninstall tokenade`. |
| Autonome (`~/.local/bin`, `/usr/local/bin`) | Supprime le binaire sous Linux et macOS. Sous Windows, un `.exe` en cours d'exécution ne peut pas se supprimer : la commande `del` est affichée. |

La commande est idempotente : la relancer après une désinstallation propre ne fait rien. Si vous aviez installé le proxy LLM, la désinstallation remet aussi chaque agent sur l'adresse d'origine de son fournisseur et retire les entrées de démarrage automatique du proxy.

### Options et retrait partiel

| Commande | Effet |
|---|---|
| `tokenade uninstall --keep-data` | Étapes 1 à 5 et 7, mais garde `~/.tokenade` et `~/.cache/tokenade` : votre historique d'économies survit à une réinstallation. |
| `tokenade uninstall --headless` | Retrait des intégrations et des données sans bannière ni conseils, sans jamais toucher au binaire. Utilisé par le hook `preuninstall` de npm. |
| `tokenade uninstall aliases` | Retire **uniquement** le proxy shell (étape 5). Hooks, branchements MCP, `CLAUDE.md` et données restent. Aussi accepté : `alias`, `shell-proxy`, `shellproxy`. |
| `tokenade unwrap-mcps` | N'exécute que l'étape 1. |

Si vous désinstallez par npm (`npm uninstall -g @tokenade/cli`), le hook `preuninstall` de npm lance d'abord `tokenade uninstall --headless` : les intégrations d'agent et les dossiers de données partent avec le paquet.

### Secrets dans les caches

Si des identifiants ont pu être capturés dans les caches de Tokenade, lancez `tokenade scrub-cache` avant de désinstaller, ou `tokenade scrub-secret <substring>` pour une chaîne précise qui a fuité. Avec une désinstallation complète, les deux arborescences sont de toute façon supprimées.

## Réinstaller

```bash
npm install -g @tokenade/cli
tokenade install
```

`tokenade install` reprend les options mémorisées dans `~/.tokenade/install-options.json` si vous avez gardé vos données ; passez `--defaults` pour repartir de zéro. Voir [Installer Tokenade](https://tokenade.net/fr/docs/install).

## Voir aussi

- [Installer Tokenade](https://tokenade.net/fr/docs/install)
- [Fichiers et chemins](https://tokenade.net/fr/docs/files-and-paths)
- [Journal des versions](https://tokenade.net/fr/docs/changelog)
- [Dépannage](https://tokenade.net/fr/docs/troubleshooting)
