CLIリファレンス

i1n CLIは、ローカライゼーションを管理するための主要なインターフェースです。npm i -g i1n でグローバルにインストールしてください。

すべてのコマンドは、i1n.config.json の設定を使用して、現在のプロジェクト ディレクトリのコンテキストで実行されます。

プロジェクトにi1nを初期化します。対話形式のセットアップを実行し、プロジェクトフレームワークを検出し、ロケールファイルの形式とディレクトリを設定し、ソース言語を構成して、i1n.config.jsonを作成します。

このコマンドはプロジェクトごとに1回だけ実行する必要があります。設定を再構成するには、再度実行してください。

ローカルの翻訳ファイルをi1nにプッシュします。CLIはロケールファイル（例：locales/**/*.json）をスキャンし、すべてのキーをプロジェクトに同期します。

プッシュ後にAI翻訳をトリガーするには --translate [言語] を使用します。例: i1n push --translate es,fr,de,ja はスペイン語、フランス語、ドイツ語、日本語に翻訳されます。

前回の同期以降にキーと言語の両方が編集された場合（真の競合）、CLIは対話形式でプロンプトを表示します。ローカル値を保持する、サーバー値を受け入れる、またはプッシュを中止するかを選択できます。サーバーのみの変更（作業中に他のユーザーやダッシュボードで行われた編集）は、プッシュ時に自動的にローカルファイルに書き込まれ、必要に応じてi1n.d.tsが再生成されます。

利用可能なフラグ: --translate [langs] はプッシュ後にAI翻訳をトリガーします（例: i1n push --translate es,fr,de,ja）。--strategy <mode> は競合ポリシーを設定します。interactive（ターミナルでのデフォルト）、ours（ローカル優先）、theirs（サーバー優先）、またはabort（競合発生時に終了）から選択可能です。--force は --strategy ours の短縮形であり、サーバーの値を上書きします。これは破壊的な操作であり、他のライターが行ったサーバー側の編集はすべて破棄されます。

i1n から翻訳を取得し、ローカルファイルに書き込みます。すべての翻訳を取得し、設定された形式でロケールファイルを書き込み、i1n.d.ts TypeScript 型定義を生成します。

翻訳が完了した後、またはCI/CDパイプラインの一部としてこれを実行し、ファイルが常に同期していることを確認してください。

プロジェクトに新しいターゲット言語をインタラクティブに追加します。このコマンドは、プランで利用可能な言語スロットを確認し、新しいスロットを消費せずに以前使用した言語を再アクティブ化できます。

言語の利用可否はプランによって異なります。Starterは2言語、Proは5言語、Businessは12言語、Enterpriseは全182言語をサポートしています。

プロジェクトの制限と現在の使用状況を表示します。使用されたキーと制限、使用されたAI翻訳クレジットと制限、使用された言語スロットと利用可能なスロット、およびアクティブな言語のリストが表示されます。

このコマンドを使用して、使用状況を監視し、プランのアップグレードが必要になる時期を判断してください。

プロジェクトのAIエージェントコンテキストルールを生成します。Cursor（.cursor/rules/i1n.mdc）、Claude Code（CLAUDE.md）、Windsurf（.windsurfrules）、GitHub Copilot（.github/copilot-instructions.md）、Codex（AGENTS.md）、Antigravity（.antigravity/rules.md）用のルールファイルを作成します。

これらのファイルは、AIエージェントにハードコードされた文字列の代わりに翻訳キーを使用させ、キーを正しい名前空間ファイルに配置させ、補間変数を保持させ、変更後にi1n pushを実行させる方法を教えます。

i1nツールをAIコーディングアシスタントに公開するModel Context Protocol (MCP)サーバーを起動します。これにより、Cursor、Claude Code、Windsurf、およびその他のMCP互換エージェントは、IDEを離れることなく、プッシュ、プル、翻訳、言語の追加などのi1nコマンドを直接実行できます。

MCPサーバーは7つのツールを公開します：i1n_status、i1n_push、i1n_pull、i1n_translate、i1n_add_language、i1n_extract_and_translate、i1n_searchです。際立った機能はi1n_extract_and_translateです — AIエージェントがコンポーネントからハードコードされた文字列を抽出し、i1nに渡すと、それらは即座にプッシュされ、すべてのアクティブな言語に翻訳され、型定義が再生成されます。設定方法：claude mcp add i1n -- npx i1n mcp。

ネットワークに接続することなく、ローカルの翻訳ファイルを検証します。言語ごとの不足キー、壊れた補間プレースホルダー（ソース言語と比較した{{name}}、{name}、%{name}）、空の値、不正な形式のファイル、言語ごとのカバレッジを確認できます。翻訳時に変数が欠落し、実行時にフォーマットがクラッシュするという、よくある「静かなるキラー」を未然に防ぎます。

CI向けに構築されています：正常時は終了コード0、エラー検出時は1、設定上の問題がある場合は2を返します。--min-coverage 95を追加すると、翻訳カバレッジがしきい値を下回った際にビルドを失敗させることができ、--jsonを追加すると機械可読なレポートを出力します。API呼び出しやシークレットは不要なため、あらゆるパイプラインで実行可能です。

私たちはこれを構築したその日に自社のウェブサイトで実行しました。すると、数週間もの間本番環境で放置されていた47個の壊れたプレースホルダーが見つかりました。リリースのたびに npx i1n check を実行してください。