One run, one locale
de: 2 translated, 12 unchanged, 359 tokens (318 in, 41 out)
A CLI, an SDK, a local Studio and an MCP server, all reading the same lock file.
Translate
$ npx @verbatra/cli translate
de: 2 translated, 12 unchanged, 359 tokens (318 in, 41 out)
fr: 2 translated, 12 unchanged, 366 tokens (322 in, 44 out)
total: 725 tokens (640 in, 85 out)
2 succeeded, 0 partial, 0 failedCheck
exit 1
The check exits 1 while a locale is missing keys. It needs no API key, so it runs on every pull request.
Integrity
Agents
Register the MCP server for the project, and the agent can read status and fix translations. Tools that spend provider tokens stay off until you allow them.
claude mcp add --transport stdio --scope project verbatra -- npx -y @verbatra/mcpPick a string and watch the SDK call translate it into every language below. Placeholders stay exactly in place.
import { defineConfig, loadConfig, translate } from "@verbatra/sdk";
const config = await loadConfig({
configOverride: defineConfig({
sourceLocale: "en",
targetLocales: [
"de",
"es",
"fr",
"ja",
],
format: "next-intl-json",
files: { pattern: "messages/{locale}.json" },
provider: {
id: "gemini",
options: { model: "gemini-2.5-flash", maxOutputTokens: 2048 },
},
}),
});
const summary = await translate({ config });Pre-generated with the Verbatra SDK and Gemini, not live.
How these results were generated
| Source (English) | German | Spanish | French | Japanese |
|---|---|---|---|---|
| Save changes | Änderungen speichern | Guardar cambios | Enregistrer les modifications | 変更を保存 |
| Sign in | Anmelden | Iniciar sesión | Se connecter | サインイン |
| Welcome back, {name}! | Willkommen zurück, {name}! | ¡Bienvenido de nuevo, {name}! | Bienvenue, {name} ! | おかえりなさい、{name}さん！ |
| You have {count} new messages | Sie haben {count} neue Nachrichten | Tienes {count} mensajes nuevos | Vous avez {count} nouveaux messages | {count}件の新しいメッセージがあります |
| Your cart is empty. | Ihr Warenkorb ist leer. | Tu carrito está vacío. | Votre panier est vide. | カートは空です。 |
| Delete this file? | Diese Datei löschen? | ¿Eliminar este archivo? | Supprimer ce fichier ? | このファイルを削除しますか？ |
| Don't show this again | Nicht wieder anzeigen | No mostrar esto de nuevo | Ne plus afficher ceci | 今後表示しない |
| Settings | Einstellungen | Configuración | Paramètres | 設定 |
| Only changed keys get translated. | Es werden nur geänderte Schlüssel übersetzt. | Solo las claves modificadas se traducen. | Seules les clés modifiées sont traduites. | 変更されたキーのみが翻訳されます。 |
| Verbatra | Verbatra | Verbatra | Verbatra | Verbatra |
Read more
Features
From the first string in your source code to the reviewed translation in production.
A local dashboard over your project: browse every locale, work through the review queue and edit values in place.
Export an Excel workbook for a translator and import it back. Imported values stay protected from later machine runs.
Scan your code for translation calls and add the new keys to the source locale before anyone translates them.
Keep a watcher running in development, and every change to the source locale is translated as you save.
Generate TypeScript declarations for your keys and message arguments, so a typo in a key fails the build.
Doctor checks the setup without an API key, and an estimate sizes a run before it costs anything.
Short answers, each with the docs page that goes deeper.
Yes. Verbatra is free and open source under the MIT license (opens in a new tab), and you pay only your provider for the keys that changed; estimating cost sizes a run first.
Anthropic, OpenAI, Gemini, DeepL, Google Cloud Translation, OpenCode, OpenAI-compatible, and LibreTranslate. Set one in provider, or none when only people translate; the providers page covers each.
Only to the provider you configure, when a command translates; there is no telemetry. Keys stay in environment variables, and data handling lists what each provider receives.
Yes. verbatra check exits 1 while a locale has missing or stale keys, with no API key needed; the GitHub Action runs it on pull requests.
No. Only new and changed keys go to your provider; a committed lock file records what is already translated.
Before you spend a token
After init, a dry run needs no API key, writes nothing and lists exactly which keys a real run would send.
npx @verbatra/cli translate --dry-run