1Password CLI
公式CLIの開始手順に従ってください。インストールコマンドを推測しないでください。
リファレンス
- 公式ドキュメント: https://developer.1password.com/docs/cli/get-started/
references/get-started.md(インストール + アプリ連携 + サインインフロー)references/cli-examples.md(実際のop使用例、安全なアイテム作成/編集パターンを含む)
ワークフロー
- OS + シェルを確認する。
- tmux内でCLIが存在することを確認:
op --version。 - 必須: シークレットタスク全体のために、永続的な名前付きtmuxセッションを1つだけ作成する。
- 一致するトークン/ワークフローが存在する場合は、最初にスコープ指定されたサービスアカウントアクセスを試みる。ダイアログは不要。
- サービスアカウントアクセスがないか、必要なアイテム/フィールドを正確に持っていない場合は、同じセッションで自動的にデスクトップアプリフォールバックを試みる。先にチャットで許可を求めない。
- デスクトップフォールバック: 同じセッション内でアプリ連携/ロック解除をトリガーし、次に
op signinを実行する。1Passwordプロンプトがユーザー承認の境界となる。プロンプトを表示できない、または完了できない場合にのみチャットで確認する。 - 同じセッション内で選択したアクセスパスを確認:
op whoami。 - 複数のアカウントがある場合:
--accountまたはOP_ACCOUNTを使用する。 - コマンドが失敗した場合、
tmux send-keysで同じtmuxセッションを再利用する。再試行のために2番目のセッションを開始しない。
デフォルトアカウント
- 個人/仕事用シークレットのデフォルトアカウントは
my.1password.comです。 - 明示的に指示がない限り、
my.1password.eu/ Titanを黙って使用しない。 - シークレットの保存または読み取り時に、すべての
opコマンドに--account my.1password.comを渡す。環境によるアカウント選択に依存しない。 op account listはメタデータのみだが、それでもtmux内で実行する必要がある。ルーティングが不明確な場合にアカウント名を確認するために使用する。op signin --account my.1password.comは、ステータス0で有用な出力なしに成功し、後続のシェルがサインイン状態にならない場合がある。サインイン、作成/編集/取得、および確認は同じtmuxシェル内で行うことを推奨する。
サービスアカウントトークン
- 対話型の1Passwordフローよりも、サービスアカウントトークンを優先する。ユーザーダイアログはフォールバックのみ。
- 1Passwordサービスアカウントは、特定のボールト/スコープ用の非対話型トークンであり、デスクトップアプリのロック解除なしで自動化に役立つ。
- Peterのデフォルトサービスアカウントトークンは、
~/.profileからCodex管理ブロック内でOP_SERVICE_ACCOUNT_TOKENとしてエクスポートされる。制限付きのMoltyボールトにスコープ指定されている。 - 古いシェルでは、同じ値が
MOLTY_OP_SERVICE_ACCOUNT_TOKENとして公開されている場合がある。既知のMoltyボールトアイテムの代替エイリアスとして扱う。 - トークンがまだエクスポートされていない、適用できない、または必要な既知のアイテム/フィールドを読み取れない場合は、以下のデスクトップアプリ1Passwordフローを自動的に使用する。実際のロック解除やその他のユーザー操作がブロックされたままの場合にのみ確認する。
- トークンは、それを必要とする単一のコマンドに対してのみエクスポート/渡す:
OP_SERVICE_ACCOUNT_TOKEN="$OP_SERVICE_ACCOUNT_TOKEN" op item get "<既知のアイテム>" --vault Molty ...。 - サービスアカウントでの
op読み取りには、明示的なボールトクエリが必要。--vault Moltyを省略すると、トークンが有効でも失敗する。 - tmuxルールを維持: サービスアカウントの読み取りを含むすべての
opコマンドは、1つの名前付きtmuxセッション内で実行する。 - デフォルトではサービスアカウントでボールト/アイテムを列挙しない。ユーザーが明示的に検索を要求したり、スクリーンショット/一覧を提供したり、あいまいなアイテム名のみを指定した場合のみ、デスクトップフォールバックの前に以下の安全なメタデータ検索を使用する。
- 存在/形状のみを表示し、トークンやシークレット値は決して表示しない。
必須の永続的tmuxセッション
シェルツールはコマンドごとに新しいTTYを使用します。opを1つの専用tmuxセッション内で実行し、シークレットタスク全体が完了するまで同じセッションを使い続けてください。サービスアカウントコマンドもここで実行されますが、アプリプロンプトをトリガーしてはいけません。
例:
SOCKET_DIR="${CLAWDBOT_TMUX_SOCKET_DIR:-${TMPDIR:-/tmp}/clawdbot-tmux-sockets}"
mkdir -p "$SOCKET_DIR"
SOCKET="$SOCKET_DIR/clawdbot-op.sock"
SESSION="op-work"
tmux -S "$SOCKET" has-session -t "$SESSION" 2>/dev/null ||
tmux -S "$SOCKET" new -d -s "$SESSION" -n shell
tmux -S "$SOCKET" send-keys -t "$SESSION:" -- "op signin --account my.1password.com" Enter
tmux -S "$SOCKET" send-keys -t "$SESSION:" -- "op whoami" Enter
tmux -S "$SOCKET" capture-pane -p -J -t "$SESSION:" -S -200
引用、アイテム名、またはコマンドの失敗後に新しいtmuxセッションを作成しないでください。修正したコマンドを既存のセッションに送信してください。
セッションを$SESSION:で指定し、ウィンドウ0を想定しないでください。古いセッションではウィンドウインデックスが1から始まる場合があります。
サービス固有のワークフロー
- サービス固有の認証詳細は、所有するスキルに保持する。
- npmレジストリ/パッケージ作業には
$npmを使用する。$npmは、Moltyサービスアカウントアイテム、非対話型認証ラッパー、およびパッケージ予約ヘルパーを文書化している。 - このスキルは一般的な1Passwordルールのみを所有する: tmux限定の
op、対象指定の読み取り、1つの永続的セッション、広範な列挙禁止、シークレット出力禁止。
実績のあるシークレット書き込みパターン
永続的tmuxセッションを使用します。正確なシークレットタスクを一時スクリプトに書き込み、そのスクリプトをop-workに送信します。再試行のために2番目のtmuxセッションを作成しないでください。
SOCKET_DIR="${CLAWDBOT_TMUX_SOCKET_DIR:-${TMPDIR:-/tmp}/clawdbot-tmux-sockets}"
SOCKET="$SOCKET_DIR/clawdbot-op.sock"
SESSION="op-work"
tmux -S "$SOCKET" has-session -t "$SESSION" 2>/dev/null ||
tmux -S "$SOCKET" new -d -s "$SESSION" -n shell
cat > /tmp/op-store-secret.sh <<'SCRIPT'
#!/usr/bin/env bash
set -euo pipefail
set +x
ACCOUNT="my.1password.com"
ITEM_TITLE="Service API Tokens"
FIELD_NAME="api_token"
EXPECTED_PREFIX=""
NOTES="Created via tmux-safe op workflow"
TOKEN="$(pbpaste)"
if [ -n "$EXPECTED_PREFIX" ]; then
case "$TOKEN" in "$EXPECTED_PREFIX"*) ;; *) echo "clipboard value does not match expected prefix" >&2; exit 2;; esac
fi
op item create --account "$ACCOUNT" --category "API Credential" --title "$ITEM_TITLE" "$FIELD_NAME[password]=$TOKEN" "notesPlain=$NOTES" >/dev/null
op item get "$ITEM_TITLE" --account "$ACCOUNT" --fields "label=$FIELD_NAME" >/dev/null
echo "stored and verified secret field without printing it"
SCRIPT
chmod 700 /tmp/op-store-secret.sh
tmux -S "$SOCKET" send-keys -t "$SESSION" -- "bash /tmp/op-store-secret.sh; rm -f /tmp/op-store-secret.sh" C-m
このCLIビルドでは、opのカテゴリ文字列は人間が読める形式で大文字小文字を区別します。"API Credential"を使用し、api_credentialは使用しないでください。
正確なフィールド読み取り
既知のアイテムについて、実際に使用する前にフィールドの形状を確認する: 長さ、期待されるプレフィックス、改行数、値は確認しない。op --field NAMEおよび--fields label=NAMEは、アイテムに重複/レガシーな資格情報フィールドがある場合、間違った隠しフィールドを返す可能性があります。形状が間違っている場合は、既知のアイテムをJSONとして読み取り、正確なラベルを抽出します。
cat > /tmp/op-read-field.sh <<'SCRIPT'
#!/usr/bin/env bash
set -euo pipefail
set +x
ITEM_TITLE="Known API Credential Item"
FIELD_LABEL="api_token"
VAULT="Molty"
value="$(
OP_SERVICE_ACCOUNT_TOKEN="$OP_SERVICE_ACCOUNT_TOKEN" \
op item get "$ITEM_TITLE" --vault "$VAULT" --format json |
FIELD_LABEL="$FIELD_LABEL" node -e 'let s=""; process.stdin.on("data",d=>s+=d); process.stdin.on("end",()=>{const item=JSON.parse(s); const f=(item.fields||[]).find(x=>x.label===process.env.FIELD_LABEL); if(!f?.value) process.exit(2); process.stdout.write(f.value);})'
)"
echo "field_len:${#value}"
case "$value" in sk-*) echo "field_prefix:sk" ;; *) echo "field_prefix:other" ;; esac
echo "field_has_newline:$(printf %s "$value" | wc -l | tr -d ' ')"
SCRIPT
chmod 700 /tmp/op-read-field.sh
tmux -S "$SOCKET" send-keys -t "$SESSION:" -- "bash /tmp/op-read-field.sh; rm -f /tmp/op-read-field.sh" C-m
JSON抽出は既知のアイテムとボールトに限定してください。候補を見つけるためにボールト/アイテムを列挙しないでください。
明示的なアイテム検索
これは、ユーザーが明示的に検索を要求した場合、スクリーンショット/一覧を提供した場合、または正確なタイトルの推測が失敗し、ユーザーが正規表現/あいまい検索を要求した場合にのみ使用してください。ボールトスコープとメタデータのみに留め、候補のタイトル/ID/カテゴリ/ボールト名を表示し、フィールドや値は表示しないでください。最初にスクリーンショットから正確な可視文字列を優先する: ボールト名、アイテムタイトル、フィールドラベル。
cat > /tmp/op-find-item.sh <<'SCRIPT'
#!/usr/bin/env bash
set -euo pipefail
set +x
VAULT="Molty"
QUERY="minimax"
OP_SERVICE_ACCOUNT_TOKEN="$OP_SERVICE_ACCOUNT_TOKEN" \
op item list --vault "$VAULT" --format json |
QUERY="$QUERY" VAULT="$VAULT" node -e '
let s=""; process.stdin.on("data",d=>s+=d); process.stdin.on("end",()=>{
const q=process.env.QUERY.toLowerCase();
const vault=process.env.VAULT;
const items=JSON.parse(s).filter(x => [
x.title, x.id, x.category, ...(x.tags || [])
].filter(Boolean).join("\n").toLowerCase().includes(q));
for (const item of items.slice(0, 10)) {
console.log(`title:${item.title} id:${item.id} category:${item.category || ""} vault:${vault}`);
}
console.log(`matches:${items.length}`);
})'
SCRIPT
chmod 700 /tmp/op-find-item.sh
tmux -S "$SOCKET" send-keys -t "$SESSION:" -- "bash /tmp/op-find-item.sh; rm -f /tmp/op-find-item.sh" C-m
候補を選択した後、正確なアイテム/フィールドJSON抽出と形状のみの検証に戻ります。既知の個人アイテムは自動的にデスクトップフォールバックを使用する場合があります。ユーザーが検索を要求しない限り、個人のボールトを広く列挙しないでください。
編集されたデバッグ
パイプライン全体を同じtmuxセッション内に維持します。ステータスと出力の長さを検査し、シークレット値は決して検査しません。
cat > /tmp/op-debug.sh <<'SCRIPT'
#!/usr/bin/env bash
set -euo pipefail
set +x
SIGNIN_OUTPUT="$(op signin --account my.1password.com 2>&1 || true)"
echo "signin output bytes: ${#SIGNIN_OUTPUT}"
op account list 2>&1 | sed -E "s/(xox[baprs]-)[A-Za-z0-9-]+/\\1REDACTED/g; s/(xapp-)[A-Za-z0-9-]+/\\1REDACTED/g"
SCRIPT
chmod 700 /tmp/op-debug.sh
tmux -S "$SOCKET" send-keys -t "$SESSION" -- "bash /tmp/op-debug.sh; rm -f /tmp/op-debug.sh" C-m
ガードレール
- シークレットをログ、チャット、コードに貼り付けないこと。
- シークレットをディスクに書き込むよりも、
op run/op injectを優先すること。 - アプリ連携なしでサインインする必要がある場合は、
op account addを使用すること。 - コマンドが「アカウントがサインインしていません」を返した場合、tmux内で
op signinを再実行し、アプリで認証すること。 - デスクトップ1Passwordロック解除プロンプトがユーザー操作を直接要求するようにすること。別途チャットで許可を求めるラウンドトリップを追加しないこと。
- tmux外で
opを実行しないこと。tmuxが利用できない場合は停止して確認すること。