CLI-Referenz

Die i1n CLI ist die primäre Schnittstelle für die Verwaltung der Lokalisierung. Installieren Sie sie global mit npm i -g i1n.

Alle Befehle werden im Kontext des aktuellen Projektverzeichnisses ausgeführt und verwenden die Konfiguration von i1n.config.json.

Initialisieren Sie i1n in einem Projekt. Führt ein interaktives Setup aus, das Ihr Projekt-Framework erkennt, das Locale-Dateiformat und -Verzeichnis festlegt, die Quellsprache konfiguriert und i1n.config.json erstellt.

Dieser Befehl muss nur einmal pro Projekt ausgeführt werden. Führen Sie ihn erneut aus, um die Einstellungen neu zu konfigurieren.

Lade lokale Übersetzungsdateien nach i1n hoch. Die CLI scannt Ihre Lokalisierungsdateien (z. B. locales/**/*.json) und synchronisiert alle Schlüssel mit dem Projekt.

Verwenden Sie --translate [Sprachen], um die KI-Übersetzung nach dem Pushen auszulösen. Beispiel: i1n push --translate es,fr,de,ja übersetzt ins Spanische, Französische, Deutsche und Japanische.

Wenn ein Schlüssel und eine Sprache seit der letzten Synchronisierung auf beiden Seiten bearbeitet wurden (ein echter Konflikt), fordert Sie das CLI interaktiv auf: den lokalen Wert beizubehalten, den Serverwert zu akzeptieren oder den Push abzubrechen. Änderungen, die nur auf dem Server vorgenommen wurden (Bearbeitungen durch einen anderen Benutzer oder im Dashboard, während Sie gearbeitet haben), werden beim Push automatisch in Ihre lokalen Dateien geschrieben, und i1n.d.ts wird bei Bedarf neu generiert.

Verfügbare Flags: --translate [langs] löst nach dem Push eine KI-Übersetzung aus (Beispiel: i1n push --translate es,fr,de,ja); --strategy <mode> legt die Konfliktrichtlinie fest auf interactive (Standard im Terminal), ours (lokal gewinnt), theirs (Server gewinnt) oder abort (Abbruch bei jedem Konflikt). --force ist die Kurzform für --strategy ours und überschreibt Serverwerte, was destruktiv ist und alle serverseitigen Änderungen anderer Bearbeiter verwirft.

Zieht Übersetzungen aus i1n und schreibt lokale Dateien. Ruft alle Übersetzungen ab, schreibt Locale-Dateien in Ihrem konfigurierten Format und generiert i1n.d.ts TypeScript-Typdefinitionen.

Führen Sie dies aus, nachdem die Übersetzungen abgeschlossen sind, oder als Teil Ihrer CI/CD-Pipeline, um sicherzustellen, dass die Dateien immer synchron sind.

Fügen Sie Ihrem Projekt interaktiv neue Zielsprachen hinzu. Der Befehl prüft die verfügbaren Sprachplätze in Ihrem Tarif und ermöglicht die Reaktivierung zuvor verwendeter Sprachen, ohne neue Plätze zu verbrauchen.

Die Sprachverfügbarkeit hängt von Ihrem Tarif ab: Starter unterstützt 2, Pro 5, Business 12 und Enterprise alle 182 Sprachen.

Projektlimits und aktuelle Nutzung anzeigen. Zeigt verwendete Schlüssel im Verhältnis zum Limit, verwendete KI-Übersetzungs-Credits im Verhältnis zum Limit, verwendete Sprach-Slots im Verhältnis zu verfügbaren und eine Liste aktiver Sprachen.

Verwenden Sie diesen Befehl, um den Verbrauch zu überwachen und festzustellen, wann ein Plan-Upgrade erforderlich sein könnte.

Generieren Sie KI-Agenten-Kontextregeln für das Projekt. Erstellt Regeldateien für Cursor (.cursor/rules/i1n.mdc), Claude Code (CLAUDE.md), Windsurf (.windsurfrules), GitHub Copilot (.github/copilot-instructions.md), Codex (AGENTS.md) und Antigravity (.antigravity/rules.md).

Diese Dateien bringen KI-Agenten bei, Übersetzungs-Schlüssel anstelle von fest codierten Zeichenfolgen zu verwenden, Schlüssel in den richtigen Namespace-Dateien zu platzieren, Interpolationsvariablen beizubehalten und i1n push nach Änderungen auszuführen.

Starten Sie einen Model Context Protocol (MCP)-Server, der i1n-Tools für KI-Codierungsassistenten bereitstellt. Dies ermöglicht Cursor, Claude Code, Windsurf und anderen MCP-kompatiblen Agenten, i1n-Befehle direkt auszuführen – pushen, ziehen, übersetzen, Sprachen hinzufügen und mehr –, ohne die IDE zu verlassen.

Der MCP-Server stellt 7 Werkzeuge bereit: i1n_status, i1n_push, i1n_pull, i1n_translate, i1n_add_language, i1n_extract_and_translate und i1n_search. Das herausragende Merkmal ist i1n_extract_and_translate — Ihr KI-Agent extrahiert hartcodierte Strings aus einer Komponente, übergibt sie an i1n, und sie werden sofort gepusht, in alle aktiven Sprachen übersetzt und Typdefinitionen werden neu generiert. Konfigurieren Sie es mit: claude mcp add i1n -- npx i1n mcp.