Autres commandes

Max PrilutskiyPDG et cofondateurMis à jour le : il y a 2 mois · 2 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 :

OTP (par défaut, interactif)#

bash
lingo login
lingo login --email you@company.com           # skip the email prompt
lingo login --email you@company.com --code 123456   # skip the code prompt too

Envoie un code à usage unique à votre adresse e-mail, le vérifie, puis stocke une session Supabase dans ~/.lingo/auth.json. Les jetons de rafraîchissement y sont également enregistrés afin que la session reste active d’une session à l’autre, jusqu’à ce que vous exécutiez explicitement logout.

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/auth.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 choisir parmi vos organisations et moteurs existants, ou d’en créer de nouveaux à la volée — link vous demandera un nom, lancera le questionnaire d’onboarding pour les nouvelles organisations, puis créera la ressource via l’API avant d’établir le lien.

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 --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ération sur plusieurs machines.
  • Configuration.lingo/config.json, fichier de verrouillage, état d’exécution.