Référence des commandes CLI

Retrouvez les commandes CLI pour configurer vos projets, traduire vos fichiers et maintenir vos catalogues.

Utilisez lingo --help pour explorer les commandes et lingo <command> --help pour consulter les options. lingo --version identifie la génération installée. Le paquet actuel est @lingo.dev/cli ; les projets i18n.json utilisent un manuel v0 distinct.

Pour un projet i18n.json existant, Migration présente les commandes actuelles correspondant aux anciens workflows.

Initialisation #

lingo init crée une configuration de départ pour les langues source et cibles et les motifs de fichiers. L’option de forçage remplace les entrées de fichiers existantes et peut supprimer des options avancées ; vérifiez la configuration obtenue avant de lancer la traduction.

Connexion #

lingo login enregistre une session de navigateur ou une clé API validée. Son option locale --api-key conserve la clé. L’option globale utilisée avec une autre commande ne s’applique qu’à cet appel.

Déconnexion #

lingo logout efface les identifiants enregistrés. Les clés fournies par l’environnement ou lors de l’appel restent actives.

Identité #

lingo whoami indique l’identité et le type d’authentification ; --json fournit une sortie exploitable par une machine. Le recours aux informations enregistrées en cas de problème de connexion ne constitue pas une vérification en ligne.

lingo link enregistre les identifiants de l’organisation et du moteur de localisation utilisés pour traduire les fichiers. Ces identifiants servent à sélectionner les ressources, sans accorder de droits d’accès.

lingo unlink supprime ces identifiants tout en conservant les fichiers, les paramètres de localisation et les ressources distantes.

Envoi #

lingo push envoie les fichiers source. Ses différents modes permettent le stockage de référence, la traduction incrémentale, le remplissage rétroactif des cibles manquantes, l’actualisation des clés et le remplacement forcé. --wait récupère également la sortie. Exécuter à nouveau la commande permet de retenter les opérations qui ont échoué.

Récupération #

lingo pull récupère la dernière exécution enregistrée localement et vérifie les empreintes des cibles avant l’écriture. --dry-run affiche un aperçu des décisions d’écriture, mais peut tout de même contacter le serveur.

Purge #

lingo purge affiche un aperçu des cibles dérivées ou les supprime. Avec des filtres de fichiers ou de langues, la commande ne supprime du Lockfile que les entrées cibles sélectionnées ; sans filtre, elle supprime le Lockfile entier. Les catalogues XCStrings partagés sont ignorés.

Extraction #

lingo extract transforme les appels statiques TypeScript/TSX pris en charge en fichiers JSONC source et en déclarations. Il s’agit d’une extraction locale, et non d’une réécriture ou d’une traduction automatique.

Vérification #

lingo check échoue lorsqu’un fichier cible manque et, si .lingo/lock.json est présent, lorsqu’une source a été modifiée depuis sa dernière traduction. Cette commande n’effectue aucun appel réseau et ne nécessite aucune clé API. Sans le Lockfile, elle vérifie uniquement que les fichiers cibles existent. Dans les projets React, elle vérifie aussi que les catalogues et les types sont à jour, ainsi que le contexte, les éléments orphelins et les traductions manquantes. Elle ne vérifie pas les clés dans les cibles hors React et n’évalue pas la qualité des traductions.

Nettoyage #

lingo clean supprime immédiatement les entrées source orphelines et les entrées cibles obsolètes des catalogues JSONC. La commande ne propose aucune option de simulation et ne régénère pas les déclarations.

Guide #

lingo guide [name] affiche les conseils React fournis avec le paquet et consultables hors ligne. Les noms disponibles sont index, setup-react, api et migrate ; sans nom, l’index est sélectionné. Si le nom est inconnu, les choix disponibles s’affichent. Le guide correspond à la version du paquet installé.

Guide des agents #

lingo agent-guide [name] s’adresse aux agents IA. Sans nom, il affiche le guide des agents, qui explique la configuration, la connexion et le MCP server, et répertorie les guides destinés aux agents et aux utilisateurs. Avec un nom, il affiche le guide demandé, y compris les guides des piles technologiques qui ne figurent pas dans la liste. Les guides correspondent à la version du paquet installé.

Agent #

lingo agent setup vérifie si les agents de programmation détectés (Claude Code, Codex et Cursor, ainsi que l’agent dans lequel la commande s’exécute) disposent du MCP server de Lingo.dev et renvoie vers la configuration MCP pour ceux qui n’en disposent pas ; la commande ne modifie jamais leur configuration. --client permet de préciser les agents à vérifier à la place, y compris ceux qui n’ont pas été détectés. S’il n’y a aucun agent à vérifier, la commande échoue sans rien écrire. Dans un projet, elle écrit aussi le bloc Lingo.dev dans AGENTS.md et dans un fichier CLAUDE.md existant, sauf si ce dernier importe un AGENTS.md qui reçoit le bloc ; elle ne crée jamais de CLAUDE.md. Elle laisse le fichier inchangé et en indique la raison si celui-ci est illisible, pointe vers un emplacement hors du projet ou contient des marqueurs de bloc qui ne vont pas par paire ; corrigez le fichier, puis relancez la configuration. --dry-run affiche le plan, -y écrit sans demander de confirmation et --status affiche la configuration en place pour les agents détectés, en ignorant --client. Configurer avec un agent de programmation propose des consignes à transmettre à votre agent.

Mise à jour #

lingo update utilise la méthode d’installation détectée. Utilisez votre gestionnaire de paquets pour installer une version précise. Les vérifications de mises à jour sont mises en cache et ignorées lorsqu’un environnement CI est détecté ou qu’une désactivation via l’environnement est définie.

Score #

La commande lingo score est enregistrée, mais n’apparaît pas dans l’aide standard. Elle exécute des combinaisons locales d’évaluateurs et de modèles via OpenRouter et écrit les résultats en local, sans ajouter d’entrées à l’historique Radar.