Dépannage et FAQ.

Klyr se soigne tout seul. Au démarrage d’une session, il vérifie sa propre santé et répare ce qu’il peut réparer sans risque, donc la plupart des problèmes se règlent avant que tu les remarques. Quand quelque chose remonte quand même, voici l’ordre à suivre.

Premier diagnostic : /klyr:status

Tape /klyr:status dans Claude Code. Il affiche la santé générale de Klyr en quelques lignes : prérequis, services, mémoire, état du plugin. Quel que soit le problème, il te dit où il se trouve. La plupart des solutions ci-dessous partent de ce qu’il affiche.

Mettre à jour

Le service en arrière-plan de Klyr se met à jour tout seul, donc les changements t’arrivent sans commande. Quand quelque chose semble daté ou à moitié cassé, deux étapes, dans cet ordre :

Redémarre complètement Claude Code. Quitte-le entièrement et rouvre-le. C’est un redémarrage complet qui récupère une nouvelle version du plugin. Moins que ça ne suffit pas.
Lance /klyr:repair. Il vérifie ton installation et répare ce qui a dérivé. /klyr:update marche toujours et fait la même chose.

Solutions courantes

La ligne d’état affiche le nom du produit au lieu du nom de ton clone. Corrigé en 0.26.34. Mets à jour : redémarre complètement Claude Code, puis lance /klyr:update.

Le segment mémoire affiche ✦—. La mémoire n’est pas joignable en ce moment. Deux causes habituelles : le moteur de mémoire est encore en train de démarrer (laisse-lui une minute, surtout juste après le démarrage de la machine sur une installation locale), ou tu n’es pas connecté (mode hébergé : lance /klyr:login). /klyr:status te dit laquelle.

La mise en place a été interrompue. Relance /klyr:init. Il se souvient où tu en étais et reprend. Il ne refait ni n’efface jamais le travail terminé.

La synchro de la mémoire hébergée échouait sans arrêt avec une erreur de permission. Une ancienne famille de bugs : si le nom que ton clone avait déduit en local ne correspondait pas exactement à l’identité liée à ton compte, la synchro de la mémoire était refusée sans bruit. C’est corrigé côté serveur. Ton identité vient maintenant toujours de ton identifiant de connexion lui-même, donc une différence de nom affiché ne peut plus casser la synchro. Si tu avais ce problème, il s’arrête tout seul. Rien à configurer.

Rapports de plantage et d’erreur

Si tu as accepté pendant la mise en place, Klyr peut envoyer un rapport anonymisé quand il rencontre un problème qu’il ne sait pas réparer seul. Ce qu’il contient : la signature technique de l’erreur, rien d’autre. Ce qu’il ne contient jamais : tes notes, tes fichiers, tes chemins de fichiers, ni rien de ce que ton clone retient de toi. Anonyme veut dire anonyme. Tu peux l’activer ou le désactiver quand tu veux avec /klyr:config.

Toujours bloqué ?

Écris à [email protected] et dis où ça s’est arrêté. Un humain lit chaque message, et c’est en général celui qui a construit le produit. Des réponses franches, pas de file de tickets.