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.

La commande d’installation s’est terminée sans installer Klyr

Une installation terminée finit toujours par une dernière ligne qui commence par Klyr is installed (sur Windows, elle peut aussi dire Klyr installed and ready), suivie de ta prochaine étape. Si la commande est revenue au curseur clignotant sans cette ligne, Klyr n’est pas installé, même si rien à l’écran n’a l’air anormal. Les commandes /klyr: plus bas sur cette page arrivent avec Klyr, donc elles ne peuvent pas encore t’aider. Voici quoi faire à la place, selon ce que tu vois :

« Klyr was NOT installed. Nothing was changed on this computer. » (suivi de « Klyr n'a PAS ete installe »). L’installateur n’a pas pu être téléchargé à ce moment-là, et le problème vient de chez nous. Attends quelques minutes, puis colle de nouveau la même commande d’installation.
Une ligne qui commence par curl:, ou un texte d’erreur rouge sur Windows. Le téléchargement lui-même n’est pas passé, souvent parce que la connexion a coupé. Vérifie que tu es connecté à internet, puis colle de nouveau la même commande d’installation.
Un message de l’installateur lui-même (par exemple, Git manquant sur Windows, ou une fenêtre ouverte en administrateur). Fais ce que dit ce message, puis colle de nouveau la même commande d’installation.

Relancer la commande d’installation est toujours sans risque : elle reprend là où elle s’était arrêtée. Si elle se termine encore sans cette dernière ligne, écris à hello@getklyr.ai et colle les dernières lignes affichées dans la fenêtre.

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. 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 : ta 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 connexion affiche une page « Reconnecte Klyr ». L’application d’où tu te connectes utilise une ancienne connexion Klyr qui a expiré. La plupart du temps, Klyr la reprend maintenant tout seul et la connexion continue simplement. Quand cette page s’affiche quand même, donne à l’application une nouvelle connexion. Dans un terminal, lance claude mcp logout klyr, puis tape /mcp, choisis klyr puis Authenticate. Dans une application web ou de bureau, retire le connecteur Klyr, ajoute-le de nouveau et connecte-toi. Ton compte et ta mémoire ne sont pas touchés.

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 à hello@getklyr.ai 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.