CLI リファレンス

コマンドの各フラグに対して ai-i18n-tools <command> --help を実行します。以下のグループページでは、コンテキスト、主なオプション、およびトピックガイドへのリンクを追加しています。

コマンド概要

はじめに

コマンド	概要
version	CLIのバージョンとビルドタイムスタンプを表示します。
init	初期設定ファイルを書き出します。-t がスキャフォールドテンプレートを選択します。
help	サブコマンドのヘルプを表示します。

モデルと言語

コマンド	概要
check-models	設定されたモデルIDをアクティブなプロバイダーに対して検証します。
list-models	アクティブなプロバイダーが提供するモデルを一覧表示します。
bench-models	設定されたモデルを1つのサンプル翻訳でベンチマークします。
list-languages	バンドルされているUI言語カタログを一覧表示します。

UI文字列

コマンド	概要
extract	ソースリテラルとHTMLマーカーから strings.json を更新します。
mark-html	HTMLファイルに data-i18n* マーカーを挿入します。
migrate-intlayer	Intlayerの.content.ts辞書をインポートし、シンプルなuseIntlayer / getIntlayerサイトをt()に書き換えます。
generate-ui-languages	設定のロケールから ui-languages.json を書き出します。
translate-ui	UI文字列を翻訳します (strings.json → ロケールJSON)。
sync-ui	UI文字列を抽出してから翻訳します。
proofread-ui	UI文字列を抽出してから、ソースロケールのUI文字列をLLMでレビューします。
export-ui-xliff	strings.json をXLIFF 2.0にエクスポートします。

ドキュメント

コマンド	概要
translate-docs	Markdown、MDX、.astro、およびフレームワークカタログを翻訳します。
write-heading-ids	ATX見出しの前にHTMLアンカー行を挿入します。
check-markdown	Markdown/MDXをスキャンして区切り文字と強調の問題を検出します。

JSONとSVG

コマンド	概要
translate-json	json[] 設定ブロックに従ってネストされたJSONを翻訳します。
translate-svg	config.svg で設定されたSVGファイルを翻訳します。

ワークフローとレポート

コマンド	概要
sync	抽出 + UI + SVG + ドキュメント + JSON を1つのパイプラインで実行します。
status	UI、ドキュメント、およびJSONの翻訳カバレッジを出力します。
statistics	キャッシュとstrings.jsonの統計を出力します。
usage	記録されたモデルAPI呼び出しのトークンとコストを出力します。

キャッシュのメンテナンス

Command	Summary
cleanup	古い/孤立した/未設定ロケールのキャッシュ行を削除し、Markdownのissueを再作成します。
clean-temp	*.log、*.tmp、およびキャッシュのバックアップを検索して削除します。
purge-locale	ロケールのキャッシュ行と生成されたアーティファクトを削除します。

ダッシュボードと用語集

コマンド	概要
dashboard (dash)	翻訳ダッシュボードのWeb UIを起動します。
glossary-generate	空のglossary-user.csvテンプレートを書き込みます。

概要

ai-i18n-tools version
ai-i18n-tools init [-t ui-markdown|ui-docusaurus|ui-starlight|ui-vitepress|ui-nextra|ui-fumadocs|ui-astro-website|ui-json-bundles] [-o path] [-P <provider>] [--with-translate-ignore]
ai-i18n-tools help [command]
ai-i18n-tools check-models
ai-i18n-tools list-models
ai-i18n-tools bench-models [--model <ids>] [--text <text>|--file <path>] [--source <locale>] [--target <locale>]
ai-i18n-tools list-languages [search]
ai-i18n-tools extract
ai-i18n-tools mark-html [paths...] [--write]
ai-i18n-tools migrate-intlayer [paths...] [--write] [--report <path>] [--content-glob <glob>] [--t-import <specifier>]
ai-i18n-tools generate-ui-languages [--master path] [--dry-run]
ai-i18n-tools translate-ui …
ai-i18n-tools sync-ui …
ai-i18n-tools proofread-ui …
ai-i18n-tools export-ui-xliff …
ai-i18n-tools translate-docs …
ai-i18n-tools write-heading-ids …
ai-i18n-tools check-markdown [-p|--path <path>] [-f|--file <path>] [--json] [--no-cache]
ai-i18n-tools translate-json …
ai-i18n-tools translate-svg …
ai-i18n-tools sync …
ai-i18n-tools status …
ai-i18n-tools statistics …
ai-i18n-tools usage …
ai-i18n-tools cleanup …
ai-i18n-tools clean-temp …
ai-i18n-tools purge-locale -l <code> [-l <code> …] [--dry-run] [-y|--yes] [-f|--force] [--keep-files] [--backup <path>]
ai-i18n-tools dashboard …
ai-i18n-tools glossary-generate

ルートおよびグローバルオプション

オプション	スコープ	説明
-V / --version	ルートプログラム	バージョン番号とビルド日時を出力します（versionサブコマンドと同じ情報）。
-h / --help	ルートプログラム	ルートプログラムまたはコマンド名と併用した場合のサブコマンドのヘルプを表示します。
-c / --config <path>	すべてのコマンド	設定ファイルのパス（デフォルト: ai-i18n-tools.config.json）。
-v / --verbose	すべてのコマンド	詳細ログ出力。
-P / --provider <name>	すべてのコマンド	この実行のアクティブな LLM プロバイダー。設定の provider キーをオーバーライドします。providers の下で設定する必要があります。
-L / --ui-lang <code>	すべてのコマンド	ツール独自のUI（CLIヘルプ、ログ/サマリー、ダッシュボード）の言語。最優先ソース。ツールUI言語を参照してください。
-w / --write-logs [path]	選択されたコマンド	コンソール出力を .log ファイルにティーします (デフォルトパス: ルート cacheDir の下)。translate-docs、translate-json、translate-svg、translate-ui、sync-ui、sync、および cleanup のみで機能します。
--debug-failed	翻訳コマンド	破棄された翻訳チェック（スクリプトの誤り、解析、または品質）ごとに、ルート cacheDir 配下に FAILED-TRANSLATION ログを書き込みます。これにはフォールバックも含まれます — すべてのモデルが失敗した場合だけでありません。プロバイダー API / 空のボディエラーはコンソールに出力され（モデルおよびエラーメッセージごとに1回）、これらのファイルは書き込まれません。translate-ui、translate-docs、translate-json、translate-svg、sync-ui、sync、および cleanup に適用されます。

コマンドごとのヘルプ

使用法	説明
ai-i18n-tools <command> --help	そのコマンドのすべてのオプション。
ai-i18n-tools help <command>	<command> --help と同じ出力。

ターゲットロケール（-l / --locale）

コマンド	動作
translate-docs、translate-json、translate-svg、translate-ui、sync、sync-ui、export-ui-xliff	-l / --locale <codes> — コンマ区切りのターゲット BCP-47 コード (例: de,fr,pt-BR)。省略した場合、デフォルトは設定から取得されます (json[] ブロックはブロックごとの targetLocales を設定することもできます。UI ステップは targetLocales から sourceLocale を引いたものを使用します)。
proofread-ui	-l / --locale <code> — レビュー対象の単一ソースロケール（デフォルト：設定のsourceLocale）。