EnvSync-LE

EnvSync-LE：.env の同期を手間なく実現

.env ファイル間のキー不足を、問題になる前に発見
自動チェック、ステータスバーのカウンター、シンプルな Markdown レポート

役に立ちましたか？ スターや評価を付けると、ほかの開発者にも見つけてもらえます — ★ GitHub · ★ Open VSX · ★ Marketplace

機能

EnvSync-LE は、ワークスペース内の .env ファイル間で変数名を比較し、どのファイルでどのキーが不足しているかを知らせます。値を読み取ったり比較したりすることはなく、ファイルを変更することもありません。VS Code のほか、Cursor や VSCodium などの VS Code ベースのエディターでも動作します（Open VSX からインストール可能）。

• 自動チェック — 監視対象の .env ファイルが変更されるたびに、デバウンス処理を行った同期チェックを実行します
• ステータスバーのカウンター — 現在の問題数を表示し、ワンクリックで全レポートを確認できます
• Markdown レポート — Show Details で、ファイルごとに不足しているすべてのキーを一覧表示します
• 3 つの比較モード — auto（すべてのキーの和集合）、manual（指定したファイルのみ）、template（1 つの参照ファイルを基準にすべてを検証。ファイルにあってテンプレートにないキーもレポートします）
• 除外リスト — ファイル（例：.env.example）を一時的にチェック対象から除外します

インストール

AI エージェントから使用する

同じエンジンがMCPサーバーとして動作するため、コマンドを実行する代わりに、エージェントから直接呼び出せます。

compare_env_files(files[], mode?, templatePath?, caseSensitive?, maxResults?)

ファイルの内容を直接受け取り、どのファイルにどのキーがないかを報告します。返されるのはキー名のみで、値は返されません。認証情報が含まれるdotenvファイルの比較に、値は必要ありません。

サーバーは内容を受け取ってデータを返すだけです。ファイルを読み込まず、独自にネットワークリクエストを送信することもありません。npmではenvsync-le-mcpとして、MCPレジストリではio.github.nolindnaidoo/envsync-leとして公開されています。

{
  "mcpServers": {
    "envsync-le": {
      "command": "npx",
      "args": ["-y", "envsync-le-mcp"]
    }
  }
}

npm install -g envsync-le-mcp

{
  "mcpServers": {
    "envsync-le": { "command": "envsync-le-mcp" }
  }
}

echo '{"jsonrpc":"2.0","id":1,"method":"tools/list"}' | npx -y envsync-le-mcp

ファイルの分類

分類はベース名のセグメントに基づきます。app.device.envは 「開発」には分類されず、Windowsのパスも正しく分類されます。

CLI

同じ比較をターミナルやCIのステップから実行できます。Rust製のCLIは crate/にあり、拡張機能と同じコーパス crate/fixtures/を共有しているため、両者がdotenvファイルを 異なる方法で読み込むことはありません。 npmからnpm install -g envsync-leでインストールするか、npx envsync-leで 実行できます。または、crates.ioからcargo install envsync-leでインストールできます。どちらも 同じコマンドをインストールし、出力がバイト単位で一致するように管理されています。

envsync-le .                            # have these environments drifted? JSON on stdout when piped
envsync-le --template .env.example .    # will this deploy break?
envsync-le mcp                          # the same comparison over MCP on stdio

npmからインストール（envsync-le）するか、crates.ioからインストール（envsync-le）してください。どちらも同じenvsync-leコマンドをインストールします。

npm install -g envsync-le   # or run it once: npx envsync-le
cargo install envsync-le

.env: missing STRIPE_KEY, SENTRY_DSN (in .env.example)
.env.production: missing SENTRY_DSN (in .env.example)
out of sync — 2 files with mismatches across 3 files

終了コードが結果です。同期していれば0、同期していなければ1、不正な質問の場合は2です。 dotenvファイルがひとつも見つからない場合は0です。同期対象が存在しないためです。このファミリーの抽出ツールとは異なり、後続にパイプするリストはありません。数値がそのまま答えです。

**値を読み取ることはありません。**解析、比較、報告の対象はキー名のみです。また、それを単なる約束にとどめないため、個別に3つのチェックを実施しています。

コマンド

デフォルトでは、どのコマンドにもキーは割り当てられていません。エディターの Keyboard Shortcuts から、任意のコマンドにキーを割り当ててください。

設定

解析に関する注意

• キーは [A-Za-z_][A-Za-z0-9_.-]* に一致する必要があります。そのため、 spring.datasource.url などのドット区切りの名前も対象になります。= の左側が それ以外の場合、その行は解析エラーとして報告されます（ファイルの残りの部分は引き続き 対象になります）。
• export KEY=value も受け付けます。重複するキーは 1 つとして数えます。
• "、'、または ` で囲まれた値は複数行にまたがる場合があります。閉じられていない引用符はエラーとして報告されます。
• auto モードでは、すべてのキーの和集合が参照になります。そのため、「余分なキー」は template モードでのみ存在します。

言語

英語以外に 12 言語に対応しています。

ドイツ語 · スペイン語 · フランス語 · インドネシア語 · イタリア語 · 日本語 · 韓国語 · ポルトガル語（ブラジル） · ロシア語 · ウクライナ語 · ベトナム語 · 中国語（簡体字）

両方の部分に対応しています。マニフェスト（コマンド名、設定名、説明）と、 拡張機能の実行中に表示されるすべての内容（通知、ステータスバー、クイックピックと プロンプト、レポートの見出し）です。ヘルプページは英語で記述されています。拡張機能は VS Code の表示言語に従うため、エディターに設定されている言語と一致します。拡張機能独自の 設定はありません。

プライバシーとセキュリティ

• ネットワークアクセスはありません。 拡張機能がデータを外部に送信することはありません。 telemetryEnabled 設定は、確認できるローカルの出力チャンネル（envsync-le）にイベントを書き込むだけです。
• 値が読み取られたり、表示されたり、ログに記録されたりすることはありません — 比較するのはキー名のみです。
• MCP サーバーが返すのはキー名のみで、値は返しません。 認証情報を保存するのは dotenv ファイルなので、サーバーは不足または余分なキーがどれかを報告するだけで、その値の内容については一切報告しません。ファイルパスではなく、ファイルの内容を引数として受け取るため、ファイルを読み取ることもネットワークにアクセスすることもありません。バンドルのゲートでは、既知の値がレスポンスに含まれていないことを確認します。
• エラー通知では、ホームディレクトリと認証情報らしき文字列が伏せられます。
• 評価のプロンプトは最大 2 回だけ表示されます。 3 回目の正常な使用時に、評価していただけるかどうかを一度尋ねます。後でを選ぶか、閉じた場合は、20 回目にもう一度尋ねます。今後表示しないを選ぶと、表示されなくなります。notificationLevel を自分で important または silent に設定した場合も、表示されません。回数は VS Code の拡張機能ストレージに保存され、外部に送信されることはありません。評価するを選ぶと、インストール元の VS Code Marketplace または Open VSX の掲載ページがブラウザーで開きます。

ドキュメント

パフォーマンス

Apple M5 Pro、メモリ 24 GB、Node 24.3.0 で、ウォームアップ後に 7 回実行した中央値です。入力は リポジトリに含まれるファイルではなく scripts/benchmark.ts で生成されるため、上記のサイズは 測定された値そのものです。bun run benchmark で再現できます。

これらの値はマシン固有のもので、CI では検証されません。ビルドをブロックするベンチマークでは、 ランナーがどれほどビジーだったかしか分かりません。

テスト

28 ファイルにわたる 353 件のテストケースに加え、 実際の VS Code 拡張機能ホストで実行する統合テストスイートと、 ビルド済みの .vsix をクリーンなプロファイルにインストールするエンドツーエンドテストがあります。

実行結果である coverage/coverage-summary.json と coverage/test-results.json から scripts/coverage-readme.js で生成されます。このセクションに差異があると CI は失敗します。bun run test:coverage で再現できます。ケース数は vitest が出力する値です。

LE ファミリーのその他のツール

あらゆるモデルが直面する作業に対応する、単機能ツールが16個あります。それぞれに Rust CLI と MCP サーバーが付属します。詳細はこちら：letools.dev

取り出す

• String-LE — コードベース内のすべての文字列を抽出し、人が読めるようにします
• Numbers-LE — コードベース内のすべてのハードコードされた数値を抽出し、人が確認できるようにします
• Units-LE — 単位付きの数量をすべて抽出して正規化し、曖昧なものは名前を示して対象外にします
• Dates-LE — すべての日付とタイムスタンプ、およびそれぞれが解決される正確な時点を抽出します
• IDs-LE — UUID、ULID、NanoID、ObjectId、Snowflakeをすべて抽出し、内部に含まれる時刻をデコードします
• IPs-LE — IPアドレス、CIDRブロック、MACアドレスをすべて抽出し、正規化してスコープ別に分類します
• URLs-LE — コードベース内のすべてのURLを、プロトコルと正確な位置情報とともに抽出します
• Paths-LE — コードベース内のすべてのファイルパスを抽出し、現在も何かを指しているかどうかを示します
• Colors-LE — コードベース内のすべての色を抽出し、パレットにない色を示します

チェックする

• Regex-LE — コードベース内のすべての正規表現を検出し、壊滅的なバックトラッキングを引き起こす可能性があるものを報告します
• Versions-LE — リポジトリ内のマニフェスト間で、同じ依存関係のバージョン制約が異なる箇所を検出します
• i18n-LE — プロジェクトで使用している i18n ライブラリを特定し、そのライブラリのルールに基づいてカタログを監査します
• Scrape-LE — スクレイパーを書く前にページをスクレイピングできるか確認し、判定できない場合はその旨を示します

保護する

• Secrets-LE — コードベース内のハードコードされた認証情報を検出し、レポートに表示することはありません
• EnvSync-LE — ディレクトリツリー内の dotenv ファイルを比較し、どのファイルにどのキーがないかを示します
• Unicode-LE — 意味を隠す Unicode を検出します。双方向制御文字、不可視文字、ホモグリフ、混在スクリプトが対象です

それぞれが独立しています。共有クレートも、公開されたコアもありません。2つのツールが同じ答えにたどり着くとすれば、それはその答えが2度正しかったからです。

お問い合わせ — nolindnaidoo.com · GitHub · LinkedIn

nolindnaidoo によるその他のプロジェクト

Rust — pixelcoords と pixelactions は一連のループを構成します。pixelcoords が 場所 に答え、pixelactions がそこで 操作 します。それぞれ独自のツールと独自の方針を持ち、LE ファミリーには属しません。

• pixelcoords — 画面を固定し、領域を指定して、ピクセル単位で正確な座標と切り抜きを取得します pixelcoords.dev · crates.io · docs.rs
• pixelactions — 人が検証した座標を受け取り、操作を実行して、反映されたことを確認します pixelactions.dev · crates.io · docs.rs

ライセンス

MIT © nolindnaidoo