PlattformKonto erstellen

Weitere Befehle

Max PrilutskiyCEO & Mitgründer3 Min. Lesezeit

Einrichtungs- und Identitätsbefehle. Keiner davon greift auf Quellinhalte zu — sie verwalten nur Anmeldedaten und Projektverknüpfungen.

lingo login#

Bei Lingo.dev anmelden. Zwei Wege:

Browser (Standard, interaktiv)#

bash
lingo login

Öffnet Lingo.dev in deinem Browser, wo du die CLI autorisierst. Falls du noch nicht angemeldet bist, meldest du dich zuerst an. Die CLI speichert die Sitzung in ~/.lingo/credentials.json und hält sie aktuell, bis du lingo logout ausführst.

Wenn du noch keiner Organisation angehörst oder in der Web-App eine Organisation erstellt, deren Einrichtung aber noch nicht abgeschlossen hast, gibt login anschließend einen Link aus, über den du die Einrichtung in der Web-App abschließen kannst:

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

Bei der Einrichtung in der Web-App wird auf Basis deiner Website die erste Engine der Organisation erstellt.

API-Schlüssel (CI / nicht interaktiv)#

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

Speichert den API-Schlüssel. Du kannst Schlüssel auf der Lingo.dev-Plattform in den API keys-Einstellungen deiner Organisation erstellen.

Du kannst --api-key auch als globales Flag an jeden Befehl übergeben — damit werden gespeicherte Anmeldedaten vollständig umgangen:

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

Praktisch für einmalige CI-Jobs, die keine Anmeldedaten auf die Festplatte schreiben sollen.

lingo logout#

bash
lingo logout

Löscht ~/.lingo/credentials.json. Ohne Effekt, wenn du nicht angemeldet warst.

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

Verknüpft das aktuelle Projekt mit einer Organisation und einer Lokalisierungs-Engine. Schreibt orgId + engineId in .lingo/config.json (einchecken).

Im interaktiven Modus kannst du aus deinen bestehenden Organisationen und Engines auswählen oder direkt neue erstellen: link fragt nach einem Namen, führt dich bei einer neuen Organisation durch die Onboarding-Umfrage und erstellt die Organisation über die API, bevor die Verknüpfung erfolgt.

Solange die Einrichtung einer von dir erstellten Organisation in der Web-App noch nicht abgeschlossen ist, erstellt link darin keine Engines. Stattdessen wird der Link zum Abschließen der Einrichtung angezeigt und die bestehenden Engines der Organisation werden aufgelistet. Gibt es keine, endet die Ausführung mit diesem Link: Schließe die Einrichtung ab und führe dann lingo link erneut aus. Organisationen, zu denen du eingeladen wurdest, und Ausführungen mit einem API-Schlüssel sind davon nicht betroffen.

Wenn du noch keiner Organisation angehörst oder deine Organisation Single Sign-on voraussetzt und du dich noch nicht darüber angemeldet hast, beendet sich link stattdessen mit einem Link zur Web-App: Richte dort eine Organisation ein oder melde dich mit SSO an und führe danach lingo link erneut aus.

bash
lingo unlink

Entfernt orgId und engineId aus .lingo/config.json. Löscht weder die Organisation noch die Engine — nur die lokale Verknüpfung wird aufgehoben. Nützlich, bevor du das Projekt erneut mit einer anderen Engine verknüpfst.

lingo whoami#

bash
lingo whoami
lingo whoami --json

Zeigt drei Dinge an:

  1. Identität — die E-Mail-Adresse, mit der du angemeldet bist, oder ob du einen API-Schlüssel verwendest.
  2. Organisation — die verknüpfte Organisation (der Name wird über die API aufgelöst).
  3. Engine — die verknüpfte Engine (der Name wird über die API aufgelöst).
text
Email:   you@company.com
  Org:     Acme Inc (org_a8c...)
  Engine:  Production (eng_b9d...)
  Auth:    session

Wenn du dich nicht in einem verknüpften Projektverzeichnis befindest, werden die Zeilen für Organisation/Engine weggelassen. --json gibt dieselben Daten auch strukturiert für Skripte aus.

Globales --api-key-Flag#

Jeder Befehl akzeptiert ein --api-key-Flag, das gespeicherte Anmeldedaten nur für diesen Aufruf überschreibt. Das ist das Standardmuster in CI:

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

(Die CLI liest LINGO_API_KEY alternativ auch aus der Umgebung.)

Wie geht’s weiter?#

  • lingo push — bereichsbezogene Delta-Übersetzung.
  • lingo pull – holt die Ausgaben des letzten Pushs mit Konflikterkennung.
  • Configuration — .lingo/config.json, Lockfile, Ausführungsstatus.