CLIコマンドリファレンス

セットアップ、翻訳、カタログの管理に使うCLIコマンドを確認できます。

通常のコマンド検索にはlingo --help、オプションの確認にはlingo <command> --helpを使います。lingo --versionでは、インストールされている世代を確認できます。現在のパッケージは@lingo.dev/cliです。i18n.jsonのプロジェクトでは、別途バージョン0のマニュアルを参照してください。

既存のi18n.jsonプロジェクトでは、移行で従来のワークフローと現在のコマンドの対応を確認できます。

初期化 #

lingo initは、翻訳元と翻訳先のロケール、ファイルパターンのひな形を作成します。強制オプションを使うと既存のファイルエントリが置き換えられ、詳細オプションが失われる場合があります。翻訳前に、生成された設定を確認してください。

ログイン #

lingo loginは、ブラウザのセッションまたは検証済みのAPIキーを保存します。このコマンドのローカルオプション--api-keyは、キーを永続的に保存します。他のコマンドで指定するグローバルオプションは、その実行時にのみ適用されます。

ログアウト #

lingo logoutは、永続的に保存された認証情報を削除します。環境変数や実行時に指定したキーは、引き続き有効です。

認証情報の確認 #

lingo whoamiは、認証されたユーザーと認証方式を表示します。--jsonを指定すると、機械可読形式で出力します。接続できず保存済みの情報を代わりに表示した場合、オンラインで検証されたことにはなりません。

lingo linkは、ファイル翻訳に使う組織とローカライゼーションエンジンのIDを保存します。IDはリソースを選択するためのもので、アクセス権を付与するものではありません。

lingo unlinkは、ファイル、ローカライゼーション設定、リモートリソースを保持したまま、これらのIDを削除します。

送信 #

lingo pushは、翻訳元ファイルを送信します。モードに応じて、ベースラインの保存、差分翻訳、未作成の翻訳先の補完、キーの更新、強制置換を使い分けられます。--waitでは出力も取得します。再実行すると、失敗した処理を再試行します。

取得 #

lingo pullは、ローカルに記録された最新の実行結果を取得し、書き込み前に翻訳先のハッシュを確認します。--dry-runでは書き込みの判断結果を事前に確認できますが、サーバーとの通信が発生する場合があります。

削除 #

lingo purgeは、生成された翻訳先の削除内容を事前に表示するか、実際に削除します。ファイルまたはロケールで絞り込むと、選択した翻訳先エントリだけをLockfileから削除します。絞り込まない場合は、Lockfile全体を削除します。共有のXCStringsカタログはスキップされます。

抽出 #

lingo extractは、対応する静的なTypeScript/TSXの呼び出しを、翻訳元のJSONCと宣言に変換します。ローカルでの抽出処理であり、自動書き換えや翻訳は行いません。

検査 #

lingo checkは、翻訳先ファイルが存在しない場合に失敗します。また、.lingo/lock.jsonがある場合は、前回の翻訳以降に翻訳元が変更されていても失敗します。ネットワーク通信は行わず、APIキーも不要です。Lockfileがない場合は、翻訳先ファイルが存在するかどうかだけを確認します。Reactプロジェクトでは、カタログと型が最新かどうかに加え、コンテキスト、孤立した項目、未翻訳の項目も確認します。React以外の翻訳先ファイルに含まれるキーの確認や、翻訳品質の評価は行いません。

クリーンアップ #

lingo cleanは、孤立した翻訳元の項目と古い翻訳先エントリをJSONCカタログから即座に削除します。試行実行用のフラグはなく、宣言の再生成も行いません。

ガイド #

lingo guide [name]は、同梱されているオフライン用のReactガイドを表示します。指定できる名前はindex、setup-react、api、migrateです。名前を省略すると索引を表示します。不明な名前を指定すると、利用可能な選択肢を表示します。ガイドは、インストールされているパッケージのバージョンに対応しています。

エージェント向けガイド #

lingo agent-guide [name]はAIエージェント向けです。名前を指定せずに実行すると、セットアップ、サインイン、MCP serverについて解説するエージェントガイドを出力します。このガイドには、エージェント向けとユーザー向けのガイド一覧も掲載されています。名前を指定すると、該当するガイドを出力します。一覧に載っていないスタック別ガイドも指定できます。各ガイドは、インストール済みのパッケージのバージョンに対応しています。

エージェント #

lingo agent setupは、検出したコーディングエージェント(Claude Code、Codex、Cursor、および自身の実行元のエージェント)にLingo.dev MCP serverが設定されているかを確認し、未設定のエージェントにはMCPの設定を案内します。エージェントの設定ファイルを編集することはありません。--clientを使うと、自動検出の結果に代えて、検出されなかったものも含めて確認対象のエージェントを指定できます。確認対象のエージェントがない場合は、何も書き込まずに失敗します。プロジェクト内では、AGENTS.mdにもLingo.devのブロックを書き込みます。既存のCLAUDE.mdにも書き込みますが、ブロックの書き込み先となるAGENTS.mdをインポートしている場合は除きます。CLAUDE.mdを新規作成することはありません。ファイルを読み取れない場合、リンク先がプロジェクト外にある場合、またはブロックの開始・終了マーカーが対応していない場合は、ファイルを変更せず、その理由を表示します。ファイルを修正してから、セットアップを再実行してください。--dry-runは実行予定の内容を表示し、-yは確認を求めずに書き込みます。--statusは--clientを無視し、検出したエージェントの設定状況を表示します。コーディングエージェントを使ったセットアップには、エージェントに渡すプロンプトが用意されています。

更新 #

lingo updateは、検出されたインストール方法で更新します。特定のリリースをインストールするには、パッケージマネージャーを使ってください。更新確認の結果はキャッシュされます。CI環境が検出された場合や、環境変数で無効化した場合は、更新確認をスキップします。

採点 #

lingo scoreは登録済みですが、通常のヘルプには表示されません。OpenRouterを通じて採点ツールとモデルの組み合わせをローカルで実行し、結果をローカルに書き込みます。Radarの履歴には追加しません。