dmno-dev/varlock

解決する課題

Varlockは、AIエージェントにとって安全な方法で環境変数とシークレットを管理する問題を解決します。従来の .env ファイルは、シークレットの漏洩や、サンプルファイルと実際の値との同期不足を招くことがよくあります。Varlockはスキーマベースのアプローチを導入しており、AIエージェントは実際の機密値を見ることなく、構成要件（型、検証、説明）を理解できます。

仕組み

@env-spec と呼ばれる新しいDSLを使用し、JSDoc形式のコメントを通じて .env ファイルにスキーマと機能を付加します。これにより、開発者は .env.schema ファイルで単一の信頼できる情報源（Single Source of Truth）を定義できます。このツールは、変数を解決してプロセスをロード、検証、実行するためのCLIを提供します。また、1Password、AWS、Azure、GCPなどの外部バックエンドからシークレットを取得するためのプラグインシステムを備えており、AIが生成したコード内の漏洩したシークレットを検出する varlock scan コマンドも含まれています。

対象ユーザー

AI統合アプリケーションを構築する開発者やチーム。シークレットを保護しつつ、AIエージェントに必要なコンテキストを提供し、複数の環境間で型安全性を維持する必要がある場合に最適です。

ハイライト

• AIセーフな設定: シークレットを公開することなく、変数名と型をエージェントに提供します。
• シークレット漏洩防止: varlock scan によるプロアクティブなスキャンと、ログの秘匿化を含む実行時保護。
• 型安全性: VSCode拡張機能を通じて、検証、強制変換、IntelliSenseサポートを提供します。
• 拡張可能なバックエンドサポート: 主要なシークレットマネージャー（HashiCorp Vault、Infisical、1Passwordなど）向けの幅広いプラグイン。
• マルチ環境管理: .env.* ファイルの自動ロードと明示的なインポート。