Intlayerの初期化

npx intlayer init

init コマンドは Intlayer のパッケージをインストールし、フレームワークを設定します（設定ファイル、TypeScript、バンドラープラグイン、ミドルウェア/プロキシ、プロバイダー）。Intlayer を始めるための推奨される方法です。

それ以外（CI ワークフロー、AI スキル、MCP サーバー、エディターツール、lint ルール、CMS、インフラストラクチャ）はオプトインです。--interactive のチェックリストから選ぶか、専用のサブコマンドを実行してください（下記参照）。

エイリアス:

• npx intlayer init

引数:

• --project-root [projectRoot] - 任意。プロジェクトのルートディレクトリを指定します。指定しない場合、コマンドは現在の作業ディレクトリからプロジェクトのルートを探します。
• --no-gitignore - 任意。.gitignore ファイルの自動更新をスキップします。このフラグが設定されている場合、.intlayer は .gitignore に追加されません。
• --no-framework-setup - 任意。プロジェクトのファイルを変更せず、パッケージのインストールのみを行います。
• --routing <routing> - 任意。ロケールのルーティング: prefix-no-default（デフォルト）、prefix-all、no-prefix、search-params、none。
• -i, --interactive - 任意。デフォルトのセットの代わりに、チェックリスト（パッケージ、CI、スキル、MCP、VS Code、LSP、lint、CMS、インフラストラクチャ、…）からセットアップ手順を選びます。ターミナルが必要です。ターミナルがない場合（AI エージェント、CI）、コマンドは失敗し、代わりに実行するサブコマンドを一覧表示します。
• --no-github-actions - 任意。--interactive と併用すると、選択されていても GitHub Actions ワークフローを作成しません。

動作の仕組み:

init コマンドは以下のセットアップタスクを実行します：

1. プロジェクト構造の検証 - package.json ファイルがある有効なプロジェクトディレクトリにいることを確認します。
2. パッケージをインストール - スタックに不足している Intlayer パッケージ（例: react-intlayer、vite-intlayer）をインストールし、古いものを更新します。
3. .gitignore の更新 - 生成されたファイルをバージョン管理から除外するために、.intlayer を .gitignore ファイルに追加します（--no-gitignore でスキップ可能）。
4. TypeScript の構成 - すべての tsconfig.json ファイルを更新し、Intlayer の型定義 (.intlayer/**/*.ts) を含めます。
5. 設定ファイルの作成 - デフォルト設定で intlayer.config.ts（TypeScript プロジェクトの場合）または intlayer.config.mjs（JavaScript プロジェクトの場合）を生成します。
6. バンドラー / フレームワークの設定を更新 - Vite、Next.js、Nuxt、Astro などの設定に Intlayer プラグインを追加し、フレームワークが対応している場合はミドルウェア/プロキシとプロバイダーを作成します。

1 ステップずつ設定する

--interactive チェックリストの各ステップには専用のサブコマンドがあります。値をフラグで渡せば何も質問しないため、AI エージェントや CI ジョブから安全に実行できます。

AI エージェントや CI ジョブから実行する

AI エージェントのシェルにはターミナルがないため、質問に答えることができません。デフォルトのコマンドを実行し、その後に必要なサブコマンドを実行してください:

npx intlayer init
npx intlayer init skills --platform Claude
npx intlayer init mcp --platform Claude --transport stdio

ターミナルがない場合:

• init skills は、--skills が指定されていない限り、スタックに合ったスキルをインストールします（例: --skills Usage Content React）。
• init skills と init mcp は、--platform が指定されていない限り、検出された AI プラットフォーム（Claude Code、Cursor、VS Code、Windsurf、…）を使います。何も検出されない場合は、プラットフォームの一覧を表示して失敗します。
• init mcp は、--transport が指定されていない限り stdio トランスポートを使います。
• init infra には --mode が必須です。init extension は、--browser が指定されていない限りストアのリンクを表示するだけです。

MCP サーバーは常にプロジェクト内に設定されます（Claude Code の場合は .mcp.json）。

例:

基本的な初期化:

npx intlayer init

これにより、現在のディレクトリでIntlayerが初期化され、プロジェクトのルートが自動的に検出されます。

カスタム プロジェクト ルートでの初期化:

npx intlayer init --project-root ./my-project

これにより、指定されたディレクトリでIntlayerが初期化されます。

.gitignore を更新せずに初期化する:

npx intlayer init --no-gitignore

これにより、すべての設定ファイルがセットアップされますが、.gitignore は変更されません。

インフラストラクチャのセットアップ（デスクトップアプリまたはセルフホスティング）:

npx intlayer init infra

ホストされたインストーラー（macOS / Linux では https://intlayer.org/install.sh、Windows では install.ps1）をダウンロードして実行し、Intlayerの実行方法を尋ねます:

• デスクトップアプリ - Intlayer Cloudに接続されたネイティブダッシュボードをマシンにインストールします。
• オールインワン Docker - 単一コンテナ内にダッシュボード + API + MongoDB + Redis + MinIO を集約。
• Docker Compose - スケーラブルなセルフホスティング向けにサービスごとに1つのコンテナを用意。

--mode でメニューをスキップできます:

npx intlayer init infra --mode compose

同様の手順は npx intlayer init --interactive でも提供されます。インストーラーの設定については init infra リファレンス を、各モードで設定される内容については セルフホスティングガイド を参照してください。

出力例:

npx intlayer init
Checking Intlayer configuration...
✓ Added .intlayer to .gitignore
✓ Updated tsconfig.json to include intlayer types
✓ Created intlayer.config.ts
✓ Injected import into vite.config.ts
✓ Intlayer init setup complete.

注意事項:

• このコマンドはべき等です。複数回安全に実行でき、すでに構成されているステップはスキップされます。
• 設定ファイルがすでに存在する場合、上書きされません。
• include 配列のない TypeScript 設定（Solution スタイルの設定など）はスキップされます。
• プロジェクトのルートに package.json が見つからない場合、コマンドはエラーで終了します。