CLI-Befehlsreferenz

Finde CLI-Befehle für die Einrichtung, Übersetzung und Katalogpflege.

Nutze lingo --help für die allgemeine Befehlsübersicht und lingo <command> --help für die verfügbaren Optionen. lingo --version zeigt die installierte Generation an. Das aktuelle Paket ist @lingo.dev/cli; i18n.json-Projekte verwenden das separate v0-Handbuch.

Für bestehende i18n.json-Projekte zeigt Migration, welche aktuellen Befehle den älteren Workflows entsprechen.

Initialisieren #

lingo init legt das Grundgerüst für Quell- und Zielsprachen sowie Dateimuster an. Die Force-Option ersetzt bestehende Dateieinträge und kann erweiterte Optionen verwerfen. Sieh dir deshalb vor der Übersetzung die entstandene Konfiguration an.

Anmelden #

lingo login speichert eine Browsersitzung oder einen validierten API-Schlüssel. Die lokale Option --api-key speichert den Schlüssel dauerhaft. Die globale Option bei einem anderen Befehl gilt dagegen nur für den jeweiligen Aufruf.

Abmelden #

lingo logout löscht dauerhaft gespeicherte Zugangsdaten. Schlüssel aus Umgebungsvariablen oder dem jeweiligen Befehlsaufruf bleiben wirksam.

Identität anzeigen #

lingo whoami zeigt die Identität und die Art der Authentifizierung an; --json liefert eine maschinenlesbare Ausgabe. Werden bei Verbindungsproblemen gespeicherte Informationen verwendet, ist das keine Online-Verifizierung.

lingo link speichert die IDs der Organisation und der Lokalisierungs-Engine, die für die Dateiübersetzung verwendet werden. Die IDs dienen zur Auswahl von Ressourcen, gewähren aber keinen Zugriff.

lingo unlink entfernt diese IDs. Dateien, Lokalisierungseinstellungen und Ressourcen auf dem Server bleiben erhalten.

Push #

lingo push übermittelt Quelldateien. Die Modi unterscheiden zwischen dem Speichern des Ausgangsstands, inkrementeller Übersetzung, dem Ergänzen fehlender Ziele, der Aktualisierung von Schlüsseln und erzwungenem Ersetzen. --wait ruft außerdem die Ausgabe ab. Ein erneuter Aufruf startet fehlgeschlagene Vorgänge noch einmal.

Pull #

lingo pull ruft die Ergebnisse der letzten lokal protokollierten Ausführung ab und überprüft vor dem Schreiben die Ziel-Hashes. --dry-run zeigt in einer Vorschau, was geschrieben würde, kann dabei aber dennoch den Server kontaktieren.

Bereinigen #

lingo purge zeigt eine Vorschau abgeleiteter Ziele an oder löscht sie. Mit Datei- oder Sprachfiltern entfernt der Befehl nur die ausgewählten Zieleinträge aus dem Lockfile; ohne Filter entfernt er das gesamte Lockfile. Gemeinsam genutzte XCStrings-Kataloge werden übersprungen.

Extrahieren #

lingo extract wandelt unterstützte statische TypeScript-/TSX-Aufrufe in Quell-JSONC und Deklarationen um. Die Extraktion erfolgt lokal; ein automatisches Umschreiben oder Übersetzen findet nicht statt.

Kontrollieren #

lingo check schlägt fehl, wenn eine Zieldatei fehlt – und bei vorhandenem .lingo/lock.json auch dann, wenn sich eine Quelle seit ihrer letzten Übersetzung geändert hat. Der Befehl führt keine Netzwerkaufrufe aus und benötigt keinen API-Schlüssel. Ohne Lockfile überprüft er lediglich, ob die Zieldateien vorhanden sind. In React-Projekten überprüft er außerdem die Aktualität von Katalog und Typen, den Kontext, verwaiste Einträge und fehlende Übersetzungen. Schlüssel in Nicht-React-Zieldateien überprüft er nicht; auch die Übersetzungsqualität beurteilt er nicht.

Aufräumen #

lingo clean entfernt sofort verwaiste Quelleinträge und veraltete Zieleinträge aus JSONC-Katalogen. Der Befehl bietet kein Flag für einen Probelauf und erzeugt keine neuen Deklarationen.

Anleitung #

lingo guide [name] gibt die mitgelieferten, offline verfügbaren React-Anleitungen aus. Die Namen lauten index, setup-react, api und migrate; ohne Namensangabe wird die Übersicht ausgewählt. Bei einem unbekannten Namen werden die verfügbaren Optionen angezeigt. Die Anleitung gehört zur installierten Paketversion.

Anleitung für Agenten #

lingo agent-guide [name] richtet sich an KI-Agenten. Ohne Namensangabe gibt es den Agentenleitfaden aus. Dieser behandelt die Einrichtung, die Anmeldung und den MCP server und listet die Leitfäden für Agenten und Menschen auf. Mit Namensangabe gibt es den jeweiligen Leitfaden aus – auch Leitfäden zu Technologie-Stacks, die nicht in der Liste stehen. Die Leitfäden passen zur installierten Paketversion.

Agent #

lingo agent setup überprüft, ob die erkannten Coding-Agenten (Claude Code, Codex und Cursor sowie der Agent, in dem es selbst läuft) den Lingo.dev MCP server eingerichtet haben. Für Agenten ohne diese Einrichtung verweist es auf die MCP-Einrichtung; ihre Konfigurationen ändert es niemals. Mit --client gibst du stattdessen an, welche Agenten überprüft werden sollen – auch solche, die nicht erkannt wurden. Gibt es keinen Agenten zu überprüfen, schlägt der Vorgang fehl, ohne etwas zu schreiben. Innerhalb eines Projekts schreibt es außerdem den Lingo.dev-Block in AGENTS.md und in eine vorhandene CLAUDE.md, sofern diese nicht eine AGENTS.md importiert, die den Block aufnimmt; CLAUDE.md erstellt es niemals. Kann eine Datei nicht gelesen werden, verweist sie auf ein Ziel außerhalb des Projekts oder bilden ihre Blockmarkierungen keine passenden Paare, bleibt sie unverändert und der Grund wird angegeben. Korrigiere die Datei und führe die Einrichtung erneut aus. --dry-run zeigt die geplanten Schritte, -y schreibt ohne Rückfrage und --status zeigt, was für die erkannten Agenten eingerichtet ist, wobei --client ignoriert wird. Einrichtung mit einem Coding-Agenten enthält Prompts, die du deinem Agenten geben kannst.

Aktualisieren #

lingo update verwendet die erkannte Installationsmethode. Nutze deinen Paketmanager, um eine bestimmte Version zu installieren. Die Ergebnisse der Update-Suche werden zwischengespeichert. Die Suche wird übersprungen, wenn eine CI-Umgebung erkannt wird oder die Deaktivierung über eine Umgebungsvariable gesetzt ist.

Bewertung #

lingo score ist registriert, wird aber in der allgemeinen Hilfe nicht aufgeführt. Der Befehl führt lokale Kombinationen aus Bewertungsverfahren und Modellen über OpenRouter aus und speichert die Ergebnisse lokal, ohne Einträge zum Radar-Verlauf hinzuzufügen.