Documentation / Dépannage

Mettre à jour et désinstaller

Mis à jour le

TL;DR — Tokenade cherche une mise à jour signée au plus toutes les 24 heures et se remplace sur place ; `tokenade upgrade` la force, `tokenade upgrade --off` la coupe. `tokenade uninstall` défait chaque intégration d'agent, supprime ~/.tokenade et ~/.cache/tokenade, et retire le binaire ou vous dit comment le faire. Prévisualisez avec --dry-run.

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 télécharge le manifeste de version depuis downloads.tokenade.net, vérifie sa signature et, si une version plus récente existe, 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

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, à côté de votre licence. 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 :

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 :

npm update -g @tokenade/cli

Désinstaller

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, licence) 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é avecCe que fait uninstall
npmAffiche npm uninstall -g @tokenade/cli (le binaire appartient à npm).
cargoAffiche cargo uninstall tokenade-cli.
HomebrewAffiche 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

CommandeEffet
tokenade uninstall --keep-dataÉtapes 1 à 5 et 7, mais garde ~/.tokenade et ~/.cache/tokenade : votre historique d'économies et votre licence survivent à une réinstallation.
tokenade uninstall --headlessRetrait 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 aliasesRetire uniquement le proxy shell (étape 5). Hooks, branchements MCP, CLAUDE.md et données restent. Aussi accepté : alias, shell-proxy, shellproxy.
tokenade unwrap-mcpsN'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.

Votre compte et l'emplacement de la machine

Supprimer ~/.tokenade efface license.key : une réinstallation demandera de nouveau tokenade login. La machine reste listée dans votre compte jusqu'à ce que vous la retiriez de votre tableau de bord sur tokenade.net. Il n'existe pas de commande logout : désinstaller, ou retirer la machine du tableau de bord, est la façon de la détacher.

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

npm install -g @tokenade/cli
tokenade install
tokenade login

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.

Voir aussi