env-sync

ELN env var sync — Lambda + CLI で .env.local を user/pw 認証だけで取得する仕組み。

claude-plugins repo の eln-machine-bootstrap skill (proxy mode) から呼び出される。consumer side は AWS account 不要。

何ができるか

env-sync login -e [email protected]        # email/pw で Cognito 認証 (一度だけ)
cd your-project && env-sync pull       # project-config.json を読んで .env.local に書く

Install

A. ソースからインストール (推奨・今すぐ動く)

ELN メンバーは GitHub repo に SSH または gh CLI で認証済みである前提:

# SSH 経由 (.ssh/config に github の鍵があるとき)
[email protected]:EarthLinkNetwork/env-sync.git \
  bash <(git archive [email protected]:EarthLinkNetwork/env-sync.git HEAD scripts/install-from-source.sh | tar -xO)

# シンプルに clone してから走らせる
git clone [email protected]:EarthLinkNetwork/env-sync.git
cd env-sync && ./scripts/install-from-source.sh
# (HTTPS でも gh CLI / credential helper があれば OK:
#  git clone https://github.com/EarthLinkNetwork/env-sync.git )

実体は ~/.env-sync に置かれ、env-sync が PATH に通る。再実行で main の最新に追従。Requires: git, node ≥ 22, pnpm ≥ 9。

B. npm registry 経由 (@earthlink/env-sync 公開後)

npm i -D @earthlink/env-sync      # プロジェクト依存
# or
npm i -g @earthlink/env-sync      # グローバル

2026-05-29 時点: version 0.1.0 が pnpm publish を投げ得る状態 (build + dry-run 検証済み、tag v0.1.0)。実 publish は npm login 後に ./scripts/npm-publish.sh を実行。

詳細は claude-plugins 側の以下を参照:

• PRD-0007 env-sync proxy CLI
• ADR-0014 Lambda Proxy bootstrap
• SDD-0007 env-sync proxy CLI technical design

Repo structure (target)

env-sync/
├── packages/
│   ├── cli/         # @earthlink/env-sync CLI
│   └── lambda/      # Lambda handlers (auth, env/pull)
├── infra/           # AWS CDK (Cognito + API Gateway + Lambda + DynamoDB)
└── docs/            # PRD / ADR / SDD / PLAN (本 repo 内)
    ├── prd/
    ├── adr/
    ├── sdd/
    └── plans/

Status

• 2026-05-28: repo 作成、spec set 起票
• 2026-05-28: Phase 6 smoke deploy (Cognito + Lambda + API Gateway + KMS) 通過
• 2026-05-29: package 公開準備完了 (v0.1.0, tag 付与, build/test 全 pass)
• 2026-05-29: 本番 e2e 確認: [email protected] で POST /auth/login → GET /env/pull?project=smoke&env=development 成功 (SHARED_KEY/HELLO を取得)
• 2026-05-29: ADR-0015 / PRD-0008 / SDD-0008 (multi-file bulk sync) を claude-plugins 側に起票。実装は v0.5.0 予定

Owner

ELN Platform Team ([email protected])