Community코딩 & 개발github.com

steipete/one-password

1Password/op: 서비스 계정 우선, 대상 비밀 읽기/저장/주입, tmux 사용.

one-password란 무엇인가요?

이 스킬은 AI 에이전트(Claude Code, Cursor, Codex 등)가 1Password CLI(`op`)를 안전하고 안정적으로 사용할 수 있도록 설계되었습니다. 핵심 원칙은 서비스 계정 토큰을 우선 사용하여 비대화형으로 비밀을 읽고, 필요한 경우에만 데스크톱 앱을 통한 대화형 로그인으로 폴백(fallback)하는 것입니다. 모든 `op` 명령어는 단일 지속 tmux 세션 안에서 실행되어, 셸 도구의 TTY 제한을 우회하고 일관된 인증 상태를 유지합니다. 이 스킬은 알려진 항목에 대한 정확한 필드 읽기, 안전한 비밀 쓰기 패턴, 그리고 메타데이터만 검색하는 명시적 항목 검색을 위한 구체적인 워크플로우를 제공합니다. 로그나 채팅에 비밀 값이 노출되지 않도록 보호하며, 서비스 계정 범위 내에서만 작업하거나 사용자 동의 하에만 개인 금고에 접근합니다. tmux 세션, 서비스 계정 토큰, 데스크톱 앱 인증을 결합하여 자동화된 환경에서도 안전하게 1Password 자산을 관리할 수 있습니다.

지원 대상~Claude Code✓Codex CLI~Cursor
npx skills add https://github.com/steipete/agent-scripts/tree/main/skills/one-password

Installed? Explore more 코딩 & 개발 skills: steipete/bluebubbles, steipete/eightctl, steipete/blucli · View all 6 →

즐겨 사용하는 AI에게 물어보기

이 에이전트 스킬이 미리 로드된 새 채팅을 엽니다.

문서

1Password CLI

공식 CLI 시작하기 단계를 따르세요. 설치 명령어를 추측하지 마세요.

참고 자료

워크플로우

  1. OS + 셸 확인.
  2. tmux 내부에 CLI가 있는지 확인: op --version.
  3. 필수: 전체 비밀 작업을 위해 정확히 하나의 지속적인 이름이 지정된 tmux 세션을 생성합니다.
  4. 일치하는 토큰/워크플로우가 있으면 먼저 범위가 지정된 서비스 계정 접근을 시도합니다(대화 상자 없음).
  5. 서비스 계정 접근이 없거나 필요한 정확한 항목/필드가 없으면 같은 세션에서 자동으로 데스크톱 앱 폴백을 시도합니다. 먼저 채팅 권한을 묻지 마세요.
  6. 데스크톱 폴백: 같은 세션에서 앱 통합/잠금 해제를 트리거한 다음 op signin을 실행합니다. 1Password 프롬프트가 사용자 승인 경계입니다. 프롬프트를 표시하거나 완료할 수 없는 경우에만 채팅으로 물어보세요.
  7. 같은 세션에서 선택한 접근 경로를 확인합니다: op whoami.
  8. 여러 계정이 있는 경우: --account 또는 OP_ACCOUNT를 사용합니다.
  9. 명령어가 실패하면 같은 tmux 세션에서 tmux send-keys를 사용하여 재시도합니다. 재시도를 위해 두 번째 세션을 시작하지 마세요.

기본 계정

  • 개인/업무 비밀의 기본 계정은 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 명령어는 하나의 이름이 지정된 tmux 세션 안에서 실행됩니다.
  • 기본적으로 서비스 계정으로 금고/항목을 열거하지 마세요. 사용자가 명시적으로 검색을 요청하거나, 스크린샷/목록을 제공하거나, 모호한 항목 이름만 제공하는 경우 데스크톱 폴백 전에 아래의 안전한 메타데이터 검색을 사용하세요.
  • 존재 여부/형태만 출력하고 토큰 또는 비밀 값은 절대 출력하지 마세요.

필수 지속 Tmux 세션

셸 도구는 명령어당 새로운 TTY를 사용합니다. 전용 tmux 세션 하나 안에서 op를 실행하고 전체 비밀 작업이 끝날 때까지 같은 세션을 계속 사용하세요. 서비스 계정 명령어도 여기서 실행되지만 앱 프롬프트를 트리거해서는 안 됩니다.

예시:

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을 사용하세요. Molty 서비스 계정 항목, 비대화형 인증 래퍼 및 패키지 예약 도우미를 문서화합니다.
  • 이 스킬은 일반 1Password 규칙만 소유합니다: tmux 전용 op, 대상 읽기, 하나의 지속 세션, 광범위한 열거 금지, 비밀 출력 금지.

알려진 작동 비밀 쓰기 패턴

지속 tmux 세션을 사용하세요. 정확한 비밀 작업을 임시 스크립트에 작성한 다음 해당 스크립트를 op-work로 보내세요. 재시도를 위해 두 번째 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를 사용하세요.
  • "account is not signed in" 오류가 반환되면 tmux 내에서 op signin을 다시 실행하고 앱에서 승인하세요.
  • 데스크톱 1Password 잠금 해제 프롬프트가 사용자 상호 작용을 직접 요청하도록 두세요. 먼저 별도의 채팅 권한 왕복을 추가하지 마세요.
  • tmux 외부에서 op를 실행하지 마세요. tmux를 사용할 수 없으면 중지하고 물어보세요.

Individual skills in this repo

This repo contains 20 individual skills — each has its own dedicated page.

steipete/agent-transcript

GitHub PR/issue agent transcripts: redact, preview, and insert safely.

steipete/beeper

Beeper cache: contact hints, room lookup, WhatsApp/iMessage traces, FTS.

steipete/browser-use

Existing Chrome automation: Chrome plugin first, mcporter fallback.

steipete/clawsweeper-status

ClawSweeper status: URLs, workflow health, active workers, ops snapshot.

steipete/clickclack

ClickClack ops: chat app, Hetzner deploy, DNS/docs/app, Docker rollout.

steipete/cloudflare-registrar

Cloudflare Registrar: domain availability, prices, registration via mcporter.

steipete/codex-debugging

Codex debugging: codex-rs core/tui/exec/cli/app-server/config.

steipete/create-cli

CLI UX/spec: args, flags, help, output, errors, config, dry-run.

steipete/discord-clawd

Discord-backed OpenClaw agent/session relay; not archive search.

steipete/domain-dns-ops

DNS/domain ops: registrars, zones, redirects, DNS/HTTP verify, manager truth.

steipete/frontend-design

Frontend UI: pages, apps, components, polished non-generic design.

steipete/github-author-context

GitHub contributor context: identity, activity, trust, company/team signal.

steipete/github-cache-hygiene

GitHub quota/cache hygiene: gh, ghx, xcache, gitcrawl, mirrors, limits.

steipete/github-deep-review

GitHub deep review: bugs, PRs, best fix, stale-or-real, read code first.

steipete/github-project-triage

GitHub issue/PR triage: queues, CI, blockers, risk, proof, next actions.

steipete/hopper-debugger

Hopper debugging: macOS/iOS binaries, ObjC/Swift symbols, dyld, LLDB.

steipete/instruments-profiling

Instruments/xctrace profiling: macOS/iOS traces, binaries, args, exports.

steipete/mac-maintenance

Mac upkeep: brew update/upgrade, pull clean repos, empty Trash.

steipete/maintainer-orchestrator

Open-source maintainer orchestration: Codex app workers, work recovery, dependencies, vision, releases.

steipete/markdown-converter

Markdown conversion: PDF, Office, HTML, data, OCR, audio, ZIP, YouTube.

관련 스킬