Documentation / Dépannage
Mettre à jour et désinstaller
Mis à jour le
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 --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 :
Pour une installation npm, mettez à jour avec :
Désinstaller
tokenade uninstall # retrait complet
La commande complète enchaîne sept étapes, dans cet ordre :
- Rend à chaque serveur MCP enveloppé par
tokenade mcp-wrapsacommandet sesargsd'origine. Cette étape passe en premier : même une désinstallation interrompue laisse vos serveurs MCP fonctionnels. - Retire le bloc délimité
<!-- tokenade:start -->…<!-- tokenade:end -->de~/.claude/CLAUDE.md, après en avoir fait une copie. - Retire l'entrée
tokenadedesmcpServers/mcpde chaque configuration d'agent détectée. - Retire chaque groupe de hooks marqué
tokenadede~/.claude/settings.json, et fait de même pour les autres agents (hooks Codex et leurs approbations, Cursor, Copilot, plugins OpenCode et Kilo Code…). - Retire le proxy shell de chaque fichier de démarrage (
.bashrc,.zshenv,.zshrc,config.fish, PowerShell,.cshrc…) et supprime les fragments~/.tokenade/shellproxy.*. - 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. - 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 et votre licence survivent à 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.
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
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.