Dokumentation

Halte jede Locale-Datei im Gleichschritt mit deiner Quelle.

verbatra übersetzt deine i18n-Locale-Dateien inkrementell: Es sendet nur die neuen und geänderten Strings an den Provider, den du konfigurierst, prüft jedes Ergebnis und schreibt die Dateien direkt zurück.

npm i -D @verbatra/cli
SchnellstartCLI-Referenz
~/acme-shop

An example verbatra command-line session.

  1. verbatra init
    • ✓ created verbatra.config.ts
    • source en · targets de, es, fr
    • provider gemini · key from GEMINI_API_KEY
  2. verbatra translate
    • diff en.json · 12 new · 0 changed · 108 unchanged
    • de 12 translated · 108 unchanged · 0 withheld
    • es 12 translated · 108 unchanged · 0 withheld
    • fr 12 translated · 108 unchanged · 0 withheld
    • ✓ 36 keys translated in 5.4s · 0 skipped · lock updated
  3. verbatra diff
    • en.json · 120 keys · source of truth
    • de 2 new · 1 changed · 117 up to date
    • es 0 new · 0 changed · 120 up to date
    • fr 5 new · 0 changed · 115 up to date
    • 8 keys would be sent · run verbatra translate to apply
  4. verbatra watch
    • watching en.json for changes
    • en.json changed · 1 new key
    • de 1 translated · 0 withheld
    • ✓ 3 keys translated · waiting for changes

Wohin als Nächstes

Neu hierDeine erste ÜbersetzungInstalliere die CLI, erzeuge eine Konfiguration, hinterlege deinen API-Schlüssel und übersetze.Schon eingerichtetEine Sprache hinzufügenTrage eine Locale in deine Konfiguration ein und lass einen Lauf sie füllen.Unter der HaubeWie es funktioniertDie Pipeline: Vergleich mit der Lock-Baseline, übersetzen, prüfen, schreiben.Mit einem KI-AgentenMit KI einrichtenGib Claude Code, Cursor oder einem beliebigen Coding-Agenten einen Prompt zum Kopieren und Einfügen.

Was verbatra macht

Eine Quell-Locale von Hand zu pflegen bedeutet, dass jede andere Locale-Datei abdriftet: Neue Keys fehlen in den Zielen, bearbeitete Strings hinterlassen veraltete Übersetzungen, und gelöschte Keys bleiben als Waisen zurück. verbatra schließt diese Lücke, indem es jedes Ziel gegen eine committete Lock-Datei, verbatra.lock.json, vergleicht und nur das Geänderte an den von dir konfigurierten Provider sendet; ein zweiter Lauf ohne etwas Neues macht überhaupt keinen Provider-Aufruf. Jedes Ergebnis wird vor dem Schreiben geprüft, sodass ein kaputter Platzhalter zurückgehalten und erneut versucht wird, statt ausgeliefert zu werden. Siehe Wie es funktioniert für die vollständige Pipeline.

verbatra liest und schreibt zwölf Formate und übersetzt über sechs Provider hinter einer einzigen Schnittstelle. Siehe Formate und Provider.

Die Pakete

@verbatra/cli

Das verbatra-Binary: zehn Befehle, ein dünner Wrapper über dem SDK. Starte hier.

@verbatra/sdk

Der Motor darunter: translate, watch, check, diff, doctor, dazu der Excel-Roundtrip.

@verbatra/studio

Ein lokales Dashboard mit eingebautem Bearbeiten und Review-Warteschlange. Provider-Ausgaben bleiben aus, bis du zustimmst.

@verbatra/mcp

Ein stdio-MCP-Server, der Übersetzungsstatus, Glossar und Bearbeitungs-Tools für einen MCP-Client bereitstellt.