Mise en route
Du terminal à Claude Code : le wizard LIKYLY et ses commandes /likyly
Installer LIKYLY tient en une commande, npx @likyly/wizard, lancée dans le dossier de votre site. Le wizard ne s’arrête pas une fois le SDK installé : il prépare votre assistant IA, puis lui passe la main pour la partie qui demande de lire votre code. Et une fois dans Claude Code, des commandes /likyly répondent aux questions qui viennent ensuite : où sont mes blocs, qu’est-ce qu’ils rapportent, quel modèle tourne. Voici le parcours, de bout en bout.
1. Le wizard : ce qu’il fait dans votre projet
Le wizard enchaîne six étapes, et affiche ce qu’il va faire avant de le faire :
- Détection : votre framework et sa version (Next.js, Nuxt, Laravel, Django, un thème Shopify, une boutique Magento…), et le gestionnaire de paquets déjà utilisé.
- Plan : chaque commande et chaque fichier, avant d’agir. Rien d’existant n’est écrasé. Dans un dépôt Git, il propose une branche
likyly/setupet ne commite jamais. - SDK : installé avec votre gestionnaire de paquets.
- Compte : le navigateur s’ouvre sur likyly.com, vous vous connectez ou créez un compte, et deux clés reviennent seules dans le terminal. La clé publique va dans le fichier d’environnement de votre framework. La clé développeur, celle de votre assistant, va dans
.likyly/credentials.env, exclu de git. - Assistant : Claude Code, Cursor, VS Code, Codex et quatre autres, cochés d’office s’ils sont installés sur votre machine. Votre assistant peut alors agir sur votre compte LIKYLY, et Claude Code reçoit en plus les commandes
/likyly. - Vérification : SDK présent, versions compatibles, clés acceptées par l’API, assistant connecté.
2. Le passage de relais
Le wizard s’arrête là où il faudrait lire votre code : savoir quelle est votre page produit, quel composant affiche quoi, où placer le bloc. Son dernier écran récapitule ce qui a changé sur la branche, puis propose, sur Entrée, Launch Claude Code now.
Le dernier écran du wizard, reproduit à partir de ses libellés actuels.
Claude Code démarre alors dans le même terminal, dans le dossier du projet, avec une première demande déjà écrite : relier le catalogue, créer un emplacement « Vous aimerez aussi » sur la page produit, l’intégrer au code, puis vérifier l’intégration. Il code sur la branche likyly/setup, ne commite pas, et termine par un récapitulatif des fichiers touchés. La commande claude n’est pas installée ? Le wizard passe par npx @anthropic-ai/claude-code. Vous préférez relire d’abord ? « Review the changes first » montre le diff sans quitter le wizard.
3. Une fois dans Claude Code : les commandes /likyly
Tapez /likyly dans Claude Code : la skill et huit commandes s’affichent. /likyly seul relance l’intégration complète ; les autres font une chose précise.
| /likyly | Connect a catalog to LIKYLY, configure a recommendation placement, integrate it… (skill) |
| /likyly-help | List the LIKYLY commands and what each one does |
| /likyly-info | Which LIKYLY account is connected - account, workspace, key, plan (free or paid), and the Free and Pro limits side by side |
| /likyly-inventory | List what LIKYLY added to this site - each recommendation block and its page, tracking, setup |
| /likyly-pages | Where to see LIKYLY on the site - one link per kind of page with a recommendation block, local and live |
| /likyly-impact | What LIKYLY's recommendations bring - served, seen, clicked, purchases and revenue (Pro - longer history, daily trend, top products) |
| /likyly-model | Show the recommendation model - versions, which one is live, training date, performance |
| /likyly-clear-cache | Show fresh LIKYLY recommendations right away (empties the cache of one placement, or all) |
| /likyly-uninstall | Remove LIKYLY from this project (shows the plan, asks before removing) |
Les descriptions sont celles que Claude Code affiche, en anglais.
Pour savoir où vous en êtes. /likyly-info dit à quel compte et quel espace de travail le projet est relié, avec quelle clé (son nom et ses droits, jamais sa valeur), et met les limites des plans Free et Pro côte à côte avec ce que vous utilisez. /likyly-inventory fait l’état des lieux dans le code : chaque bloc de recommandations et la page qui l’affiche, les événements envoyés, les fichiers d’installation, et les écarts (un emplacement créé dans LIKYLY mais absent du code, ou l’inverse). /likyly-pages donne un lien par type de page qui porte un bloc, en local et en ligne, rempli avec un vrai produit de votre catalogue.
Pour mesurer. /likyly-impact compte les blocs servis, les produits vus et cliqués, puis les achats et le chiffre d’affaires qu’ils ont amenés, au total et par bloc, en disant ce que compte chaque chiffre : un bloc de quatre produits vu, c’est quatre produits vus. Sur le plan Free, les 7 derniers jours ; sur Pro, jusqu’à 90 jours, avec la courbe jour par jour et les produits qui marchent le mieux. /likyly-model montre la version du modèle en production, sa date d’entraînement et sa précision, les versions écartées et pourquoi, et ce que chaque moteur a servi sur le site.
Pour agir. /likyly-clear-cache vide le cache d’un emplacement, ou de tous, pour voir tout de suite l’effet d’un changement. /likyly-uninstall montre ce qu’il retirera, demande sur quelle branche le faire, puis propose d’enlever le code qui utilise encore LIKYLY. /likyly-help rappelle tout cela, et fonctionne même hors connexion.
4. Sans Claude Code
Les commandes /likyly-* sont propres à Claude Code. Cursor, VS Code, Codex et les autres reçoivent du wizard le même serveur MCP et la même skill : il suffit de leur demander en langage courant, « vérifie mon intégration LIKYLY » ou « combien m’ont rapporté les recommandations cette semaine ? ». Et la plupart des commandes existent aussi dans un terminal, sans assistant du tout : npx @likyly/wizard info, inventory, pages, impact, cache clear, uninstall.
Projet installé avec une version plus ancienne du wizard ? npx @likyly/wizard mcp add reconnecte votre assistant et réécrit les commandes avec la dernière version.
Pour aller plus loin
- La référence des commandes /likyly : arguments, équivalents en terminal, dépannage.
- Le guide d’installation, étape par étape, avec ou sans le wizard.
- Le serveur MCP et ses 34 outils, si vous voulez savoir ce que votre assistant peut faire.