Référence CLI

L'interface de ligne de commande i1n est l'interface principale pour la gestion de la localisation. Installez-la globalement avec npm i -g i1n.

Toutes les commandes s'exécutent dans le contexte du répertoire de projet actuel, en utilisant la configuration de i1n.config.json.

Initialisez i1n dans un projet. Lance une configuration interactive qui détecte le framework de votre projet, définit le format et le répertoire des fichiers de locale, configure la langue source et crée i1n.config.json.

Cette commande ne doit être exécutée qu'une seule fois par projet. Réexécutez-la pour reconfigurer les paramètres.

Poussez les fichiers de traduction locaux vers i1n. L'interface de ligne de commande analyse vos fichiers de langue (par exemple, locales/**/*.json) et synchronise toutes les clés avec le projet.

Utilisez --translate [langues] pour déclencher la traduction par IA après la poussée. Exemple : i1n push --translate es,fr,de,ja traduit vers l'espagnol, le français, l'allemand et le japonais.

Si une clé et une langue ont été modifiées des deux côtés depuis la dernière synchronisation (un vrai conflit), l'interface CLI vous invite à choisir de manière interactive : conserver la valeur locale, accepter la valeur du serveur ou abandonner l'envoi. Les modifications effectuées uniquement sur le serveur (par un autre utilisateur ou dans le tableau de bord pendant que vous travailliez) sont automatiquement écrites dans vos fichiers locaux lors de l'envoi, et i1n.d.ts est régénéré si nécessaire.

Drapeaux disponibles : --translate [langs] déclenche la traduction par IA après l'envoi (exemple : i1n push --translate es,fr,de,ja) ; --strategy <mode> définit la politique de conflit sur interactive (par défaut dans un terminal), ours (la version locale l'emporte), theirs (la version serveur l'emporte), ou abort (quitte en cas de conflit). --force est un raccourci pour --strategy ours et écrase les valeurs du serveur, ce qui est destructeur et annule toute modification effectuée côté serveur par d'autres contributeurs.

Récupère les traductions depuis i1n et écrit les fichiers locaux. Récupère toutes les traductions, écrit les fichiers de locale dans votre format configuré et génère les définitions de types TypeScript i1n.d.ts.

Exécutez ceci une fois les traductions terminées, ou dans le cadre de votre pipeline CI/CD pour garantir que les fichiers sont toujours synchronisés.

Ajoutez de nouvelles langues cibles à votre projet de manière interactive. La commande vérifie les emplacements de langue disponibles dans votre forfait et permet la réactivation des langues précédemment utilisées sans consommer de nouveaux emplacements.

La disponibilité des langues dépend de votre forfait : Starter prend en charge 2 langues, Pro 5, Business 12 et Enterprise les 182 langues.

Affiche les limites du projet et l'utilisation actuelle. Indique les clés utilisées par rapport à la limite, les crédits de traduction IA utilisés par rapport à la limite, les emplacements linguistiques utilisés par rapport aux disponibles, et une liste des langues actives.

Utilisez cette commande pour surveiller la consommation et déterminer quand une mise à niveau de votre forfait peut être nécessaire.

Génère les règles de contexte de l'agent IA pour le projet. Crée des fichiers de règles pour Cursor (.cursor/rules/i1n.mdc), Claude Code (CLAUDE.md), Windsurf (.windsurfrules), GitHub Copilot (.github/copilot-instructions.md), Codex (AGENTS.md) et Antigravity (.antigravity/rules.md).

Ces fichiers apprennent aux agents IA à utiliser des clés de traduction au lieu de chaînes codées en dur, à placer les clés dans les fichiers de l'espace de noms approprié, à préserver les variables d'interpolation et à exécuter i1n push après les modifications.

Démarrez un serveur Model Context Protocol (MCP) qui expose les outils i1n aux assistants de codage IA. Cela permet à Cursor, Claude Code, Windsurf et d'autres agents compatibles MCP d'exécuter des commandes i1n directement — push, pull, translate, add languages, and more — without leaving the IDE.

Le serveur MCP expose 7 outils : i1n_status, i1n_push, i1n_pull, i1n_translate, i1n_add_language, i1n_extract_and_translate et i1n_search. La fonctionnalité phare est i1n_extract_and_translate — votre agent IA extrait les chaînes codées en dur d'un composant, les transmet à i1n, et elles sont instantanément poussées, traduites dans toutes les langues actives, et les définitions de type sont régénérées. Configurez-le avec : claude mcp add i1n -- npx i1n mcp.