oharu121 プロジェクトの .env ファイルに含まれるシークレットを 1Password CLI (op) に移行します。
ユーザーの入力: $ARGUMENTS
Step 1: .env ファイルの確認
プロジェクトルートの .env ファイルを読み込み、環境変数の一覧を確認する。
.envが存在しない、または空の場合: 移行対象がない旨を伝えて終了する- 存在する場合: 変数名と値の一覧をユーザーに表示し、移行対象を確認する
Step 2: 1Password CLI のインストール確認
which op && op --version
opコマンドが見つからない場合:- AskUserQuestion ツールで「1Password CLI をインストールしますか？」と確認する
- ユーザーが承認したら
brew install --cask 1password-cliを実行する - インストール失敗時はエラーを表示して終了する
opコマンドが存在する場合: 次のステップへ
Step 3: 1Password CLI の認証確認
op whoami
- 認証済みの場合: アカウント情報を表示して次のステップへ
- 未認証の場合:
- ユーザーに以下を案内する:
- 1Password デスクトップアプリがインストール済みの場合: 1Password > Settings > Developer > Connect with 1Password CLI を有効にすることを推奨
- ターミナルで
eval $(op signin)を実行してサインインする
- AskUserQuestion ツールで「サインインが完了したら教えてください」と待機する
- ユーザーが完了を報告したら、再度
op whoamiで認証状態を確認する - まだ未認証の場合はエラーを表示し、再試行を促す
- ユーザーに以下を案内する:
Step 4: 1Password Vault の選択
op vault list --format=json
- Vault 一覧を取得し、AskUserQuestion ツールでユーザーに保存先の Vault を選択してもらう
- 選択肢には Vault 名と ID を含める
Step 5: 1Password にアイテムを作成
.env ファイルの各環境変数を 1Password に保存する。
- プロジェクト名（ディレクトリ名やリポジトリ名）をベースにアイテムのタイトルを提案する
- AskUserQuestion ツールでアイテムのタイトルを確認する
- 以下のコマンドで 1Password にアイテムを作成する:
op item create \
--category=login \
--title="{アイテムタイトル}" \
--vault="{選択されたVault}" \
"{変数名1}={値1}" \
"{変数名2}={値2}" \
...
- 作成成功を確認する
Step 6: .env ファイルを op:// 参照に書き換える
.env ファイルの各行を op:// 参照形式に書き換える。
変換前:
KEY=secret-value
変換後:
KEY=op://{Vault名}/{アイテムタイトル}/{フィールド名}
- 書き換え前にユーザーに変換内容を表示して確認を取る
- 確認が取れたら
.envファイルを上書きする
Step 7: 動作確認
op run --env-file=.env -- env | grep {変数名}
- 各変数が正しく解決されることを確認する
- 成功したら完了メッセージを表示する
Step 8: 使い方の案内
移行完了後、以下の使い方を案内する:
コマンドの実行方法
# 環境変数を注入してコマンドを実行
op run --env-file=.env -- <your-command>
# 例
op run --env-file=.env -- node script.js
op run --env-file=.env -- python main.py
注意事項
.envファイルには平文のシークレットが含まれなくなったため、安全性が向上したop runを使わずに直接.envを読み込むとop://の参照文字列がそのまま使われるため注意- プロジェクト内で
dotenv等を使っている場合は、op run経由で実行するか、スクリプトの起動方法を変更する必要がある
エラーハンドリング
- 各ステップでエラーが発生した場合、エラー内容を表示して原因と対処法を提案する
- 1Password の API レート制限に達した場合は、少し待ってからリトライするよう案内する
- Vault へのアクセス権限がない場合は、1Password アプリで権限を確認するよう案内する