CLI
verbatra check$ npx @verbatra/cli check
verbatra check
de: 0 missing, 1 stale, 13 up-to-date (out of sync)
out of sync (run verbatra translate to update)ロックファイル
en.json 2 件変更
{
…ほか 12 件、変更なし
"checkout": {
"title": "Review and checkout", 変更あり
"pay": "Pay and place order" 変更あり
}
}verbatra.lock.json 2 stale, 12 up-to-date
{
"version": 1,
"locales": {
"de": {
…ほか 4 件、変更なし
"cart.total": "692deda3edfe75da",
"checkout.pay": "bcdca4b40874a53a", 古い
"checkout.title": "f0eeada9213af138", 古い
"errors.notFound": "427078dedd81b2ce",
…ほか 6 件、変更なし
}
}
}古い(stale)とは、記録されたハッシュが現在の en.json の値のハッシュと一致しないことです。残りの 12 件は一致しています。
verbatra translate 2 translated, 12 unchanged
$ npx @verbatra/cli translate
de: 2 translated, 12 unchangedde.json 事前生成(リアルタイムではありません)
{
…ほか 12 件、変更なし
"checkout": {
"title": "Überprüfen und zur Kasse gehen", 変更あり
"pay": "Bezahlen und Bestellung aufgeben" 変更あり
}
}gemini-2.5-flash,
verbatra.lock.json:2 件のハッシュを更新しました。
ゲート
すべての候補訳は、ファイルに届く前に整合性ゲートを通ります。 docs/translation-safety
profile.greeting gemini-2.5-flash
en.json 変更あり
"Welcome back, {name}!"
"Good to see you, {name}!"de プロバイダーの回答
"Schön, Sie zu sehen!" {name} 欠落まだ検証も書き込みもしていません。
verbatra translate 未書き込み 1 integrity-withheld
$ npx @verbatra/cli translate
de: failed, 0 translated, 13 unchanged, 1 integrity-withheld
integrity-withheld:
profile.greeting: placeholder (-{name})
0 succeeded, 0 partial, 1 failedde.json 未変更
"profile": {
"greeting": "Willkommen, {name}!",
...verbatra check exit 1
$ npx @verbatra/cli check
de: 0 missing, 1 stale, 13 up-to-date (out of sync)
out of sync (run verbatra translate to update)de.json 未変更
"profile": {
"greeting": "Willkommen, {name}!",
...de.json は前の値のままです。キーは古いままで、次の実行で再試行されます。
ロックファイルは
コマンド
ソースコードの最初の文字列から、本番に出るレビュー済みの訳文まで。
verbatra extractverbatra extract 2 件の新しいキー
$ npx @verbatra/cli extract --dry-run
verbatra extract
1 file scanned, 2 keys already present
would add 2 keys to messages/en.json
new keys (2):
checkout.giftNote src/Checkout.tsx:8
checkout.backToCart src/Checkout.tsx:10
dry run, nothing writtenwould add 2 keys to messages/en.json
コードから翻訳の呼び出しを探し、誰かが翻訳する前に、新しいキーをソースロケールに追加します。
docs/cli/extractverbatra typesverbatra-types.d.ts 14 件のキーを宣言済み
$ npx @verbatra/cli types
verbatra types
14 keys declared, 1 of them taking arguments, from messages/en.json
wrote verbatra-types.d.tsexport interface VerbatraMessages {
…ほか 8 件
"profile.greeting": { readonly "name": VerbatraArgument };
…ほか 3 件
"checkout.title": VerbatraNoArguments;
"checkout.pay": VerbatraNoArguments;
}14 keys declared, 1 of them taking arguments, from messages/en.json
キーとメッセージ引数の TypeScript 宣言を生成するので、キーのタイプミスはビルドの失敗になります。
docs/cli/typesverbatra doctorverbatra doctor API キー不要
$ npx @verbatra/cli doctor
verbatra doctor
[ok ] Configuration: Loaded .verbatrarc.json.
[ok ] Format adapter: Format "next-intl-json" resolves to an adapter.
[ok ] Provider: Provider "gemini" resolves to a factory.
[fail] API key environment variable: The GEMINI_API_KEY environment variable is not set.
fix: Set GEMINI_API_KEY in the environment, or, with the CLI, in a .env file in the project directory.
…ほかのチェックもすべて合格
1 problem found (run verbatra doctor again after fixing it)
$ npx @verbatra/cli translate --dry-run
verbatra translate (dry run)
de: 2 would translate, 12 unchanged
1 succeeded, 0 partial, 0 failed (dry run: nothing written)de: 2 would translate, 12 unchanged
doctor は API キーなしで構成を確認し、見積もりは費用が発生する前に実行の規模を示します。
docs/cli/doctorverbatra watchverbatra watch 保存のたびに
$ npx @verbatra/cli watch
verbatra: watching en (messages/{locale}.json); running initial translation
verbatra: translating de
verbatra: de batch 1/1
verbatra: de: writing
verbatra: de done, 2 translated
verbatra: run finished, 1 locale processed
verbatra translate
de: 2 translated, 12 unchanged
1 succeeded, 0 partial, 0 failed
verbatra: waiting for changes...de: 2 translated, 12 unchanged
開発中に監視プロセスを動かしておくと、ソースロケールを変更するたびに、保存と同時に翻訳されます。
docs/cli/watchverbatra exportverbatra-translations/de.csv 翻訳待ち 2 行
$ npx @verbatra/cli export --format csv
verbatra export -> verbatra-translations
de: 2 rows
2 rows across 1 locale| Key | Source | Status | Translation |
|---|---|---|---|
| checkout.pay | Pay and place order | changed | 翻訳者が入力 |
| checkout.title | Review and checkout | changed | 翻訳者が入力 |
de: 2 rows
翻訳者向けに Excel ブック、CSV、TSV、XLIFF をエクスポートし、あとでインポートして戻します。インポートした値は、以降の機械翻訳の実行から保護されます。
docs/cli/exportverbatra studioverbatra studio 実際のスクリーンショット
プロジェクトを扱うローカルのダッシュボード。全ロケールを閲覧し、レビューキューを処理し、値をその場で編集できます。
docs/cli/studio結果
どのインターフェースも同じロックファイルを読むため、profile.greeting が拒否されている状態では、どこで確認しても、ドイツ語は古い 1 件、最新 13 件です。
verbatra.lock.json 1 stale, 13 up-to-date
"profile.greeting": "deb45ffcf3548530", stale$ npx @verbatra/cli check
verbatra check
de: 0 missing, 1 stale, 13 up-to-date (out of sync)
out of sync (run verbatra translate to update)import { check } from "@verbatra/sdk";
const summary = await check({ config });
summary.locales[0];
// { locale: "de", missing: 0,
// stale: 1, upToDate: 13,
// inSync: false, ... }npm install --save-dev @verbatra/sdk
status.check({})
{ "inSync": false, "locales": [
{ "locale": "de", "missing": 0,
"stale": 1, "upToDate": 13, ... }
] }claude mcp add --transport stdio --scope project verbatra -- npx -y @verbatra/mcp
代替手段
翻訳ワークフローを左右するポイントについて、チームがよく比較するツールごとの答えをまとめました。
| 質問 | Verbatra | Crowdin | Tolgee | Lingo.dev | 手作業の流れ |
|---|---|---|---|---|---|
| ベンダーのアカウントなしで使える | はい | いいえ | 一部 | いいえ | はい |
| 自分のプロバイダーキーを使う | はい | はい | 一部 | 一部 | はい |
| 変更されたキーだけを翻訳する | はい | 一部 | 一部 | はい | いいえ |
| 翻訳が欠落または古いと CI を失敗させる | はい | はい | いいえ | はい | いいえ |
| 翻訳後にプレースホルダーと ICU を検査する | はい | はい | はい | 一部 | いいえ |
| 翻訳者向けの Web エディター | 一部 | はい | はい | 一部 | いいえ |
最終確認日 2026年11月16日
よくある質問
短い回答を並べ、それぞれに詳しいドキュメントへのリンクを付けています。
はい。MIT ライセンス (新しいタブで開きます)のオープンソースで、無料です。費用は変更されたキーのぶんのプロバイダー料金だけで、実行前に費用を見積もると規模を先に確認できます。
Anthropic、OpenAI、Gemini、DeepL、Google Cloud Translation、OpenCode、OpenAI-compatible、LibreTranslate に対応しています。provider に 1 つ指定します(人だけが翻訳する場合は none)。詳しくはプロバイダーを参照してください。
送り先は、コマンドが翻訳するときの、設定したプロバイダーだけです。テレメトリはありません。API キーは環境変数にだけ置き、各プロバイダーが受け取る内容はデータの取り扱いとプライバシーに載っています。
はい。verbatra check は API キー不要で、ロケールに欠落しているキーや古くなったキーがある間は終了コード 1 で終了します。GitHub Action は、これを pull request で実行します。
ホスト型のプラットフォームではなく、手元のコミット済みファイルに対して動く CLI です。比較表では、ほかのツールが優れている点も含めて照らし合わせています。
トークンを消費する前に
この手順は、すでにロケールファイルがあるプロジェクト向けで、どちらのステップも API キーは不要です。
npx @verbatra/cli initnpx @verbatra/cli translate --dry-run