PlateformeCréer un compte

Autres commandes

Max PrilutskiyPDG et cofondateur3 min de lecture

Commandes de configuration et d’identité. Aucune ne modifie le contenu source — elles gèrent uniquement les identifiants et les associations au projet.

lingo login#

Authentifiez-vous sur Lingo.dev. Deux options :

bash
lingo login

Ouvre Lingo.dev dans votre navigateur pour vous permettre de vous connecter et d'autoriser la CLI. La CLI enregistre la session dans ~/.lingo/credentials.json et la maintient active jusqu'à ce que vous exécutiez lingo logout.

Si vous avez créé une organisation dans l'application web sans avoir terminé sa configuration, login affiche alors un lien pour la finaliser :

text
Finish setting up Acme Inc in the web app: https://lingo.dev/orgs/org_a8c...

La configuration dans l'application web crée le premier moteur de l'organisation à partir de votre site web.

Clé API (CI / non interactif)#

bash
lingo login --api-key lk_...

Stocke la clé API. Générez vos clés sur la plateforme Lingo.dev, dans les paramètres API keys de votre organisation.

Vous pouvez aussi passer --api-key comme option globale sur n’importe quelle commande, ce qui contourne entièrement les identifiants enregistrés :

bash
lingo push --api-key lk_...

Pratique pour des jobs CI ponctuels qui ne doivent pas écrire d’identifiants sur le disque.

lingo logout#

bash
lingo logout

Efface ~/.lingo/credentials.json. Aucun effet si vous n’étiez pas connecté.

bash
lingo link
lingo link --org org_a8c... --engine eng_b9d...   # skip prompts

Associe le projet actuel à une organisation et à un moteur de localisation. Écrit orgId + engineId dans .lingo/config.json (commitez-le).

Le mode interactif vous permet de sélectionner une organisation et un moteur existants ou d'en créer directement : link vous demande un nom et, pour une nouvelle organisation, vous invite à répondre au questionnaire de prise en main, puis crée l'organisation via l'API avant d'établir le lien.

Tant que la configuration d'une organisation que vous avez créée n'est pas terminée dans l'application web, link n'y crée pas de moteurs. Il affiche le lien permettant de terminer la configuration et la liste des moteurs existants de l'organisation. Si elle ne contient aucun moteur, il s'arrête en affichant ce lien : terminez la configuration, puis exécutez à nouveau lingo link. Les organisations auxquelles vous avez reçu une invitation et les exécutions avec une clé API ne sont pas concernées.

bash
lingo unlink

Supprime orgId et engineId de .lingo/config.json. Ne supprime ni l’organisation ni le moteur — cela retire uniquement l’association locale. Utile avant de relier le projet à un autre moteur.

lingo whoami#

bash
lingo whoami
lingo whoami --json

Affiche trois éléments :

  1. Identité — l’adresse e-mail avec laquelle vous êtes connecté, ou si vous utilisez une clé API.
  2. Org — l’organisation associée (le nom est résolu via l’API).
  3. Moteur — le moteur associé (le nom est résolu via l’API).
text
Email:   you@company.com
  Org:     Acme Inc (org_a8c...)
  Engine:  Production (eng_b9d...)
  Auth:    session

Si vous n’êtes pas dans un répertoire de projet lié, les lignes Org/Moteur sont omises. --json renvoie les mêmes données dans un format structuré pour les scripts.

Option globale --api-key#

Chaque commande accepte une option --api-key qui remplace les identifiants enregistrés pour cette exécution uniquement. C’est le schéma standard en CI :

yaml
env:
  LINGO_API_KEY: ${{ secrets.LINGO_API_KEY }}
steps:
  - run: lingo push --backfill-missing --yes --wait --api-key "$LINGO_API_KEY"

(Le CLI lit aussi LINGO_API_KEY depuis l’environnement comme solution de secours.)

Pour la suite#

  • lingo push — traduction avec portée + delta.
  • lingo pull — récupérez les résultats du dernier push, avec détection des conflits.
  • Configuration — .lingo/config.json, fichier de verrouillage, état d’exécution.