Community编程与开发github.com

steipete/one-password

1Password CLI技能:优先使用服务账户令牌,安全地读取、存储和注入密钥,所有操作都在tmux会话中进行。

one-password 是什么?

该技能为AI编程助手(如Claude Code、Cursor、Codex等)提供了与1Password CLI (`op`) 安全交互的完整工作流。开发者在需要读取或存储API令牌、数据库密码等敏感信息时,无需离开终端环境。技能的核心设计原则是强制所有操作在单个持久的tmux会话中执行,以避免命令行工具因每个命令启动新的TTY而导致的认证状态丢失问题。它优先使用非交互式的服务账户令牌(例如针对特定存储库`Molty`的令牌)来实现自动化,避免了桌面应用解锁对话框的干扰。当服务账户无法满足需求时,技能会自动回退到桌面应用集成认证,并将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 中提问

打开一个已预加载此 Agent Skill 的新对话。

文档

1Password CLI

遵循官方CLI入门步骤。不要猜测安装命令。

参考

工作流

  1. 检查操作系统和Shell。
  2. 在tmux中验证CLI是否存在:op --version。
  3. 必需:为整个密钥任务创建恰好一个持久的命名tmux会话。
  4. 当存在匹配的令牌/工作流时,优先尝试范围限定的服务账户访问;无需对话框。
  5. 如果缺少服务账户访问权限或缺少所需的精确项/字段,自动在同一会话中回退到桌面应用。不要先请求聊天许可。
  6. 桌面回退:触发应用集成/解锁,然后在同一会话内执行op signin。1Password提示是用户批准的边界;仅当提示无法显示或完成时才在聊天中询问。
  7. 在同一会话中验证所选访问路径:op whoami。
  8. 如果有多个账户:使用--account或OP_ACCOUNT。
  9. 如果命令失败,使用tmux send-keys重复使用同一tmux会话;不要仅仅为了重试而启动第二个会话。

默认账户

  • 个人/工作密钥的默认账户是my.1password.com。
  • 除非明确要求,否则不要静默使用my.1password.eu / Titan。
  • 在存储或读取密钥时,在每个op命令上传递--account my.1password.com。不要依赖环境账户选择。
  • op account list仅用于元数据,但仍必须在tmux内运行。当路由不明确时,用它来确认账户名称。
  • op signin --account my.1password.com可以返回状态0且没有有用输出,并且仍然不会使后续Shell登录。最好在同一个tmux Shell中执行登录、创建/编辑/获取和验证。

服务账户令牌

  • 在任何交互式1Password流程之前优先使用服务账户令牌。用户对话框仅作为回退。
  • 1Password服务账户是特定存储库/范围的非交互式令牌,适用于无需解锁桌面应用的自动化。
  • Peter的默认服务账户令牌已从~/.profile导出为OP_SERVICE_ACCOUNT_TOKEN,位于一个Codex管理的块中。其范围限定为受限的Molty存储库。
  • 较旧的Shell可能将相同的值暴露为MOLTY_OP_SERVICE_ACCOUNT_TOKEN;将其视为已知Molty存储库项的回退别名。
  • 如果令牌尚未导出、不适用或无法读取所需的精确已知项/字段,则自动使用下面的桌面应用1Password流程。仅在实际解锁或其他用户交互仍被阻塞时才询问。
  • 仅为需要它的单个命令导出/传递它:OP_SERVICE_ACCOUNT_TOKEN="$OP_SERVICE_ACCOUNT_TOKEN" op item get "<known item>" --vault Molty ...。
  • 服务账户op读取需要显式指定存储库;省略--vault Molty即使令牌有效也会失败。
  • 保留tmux规则:每个op命令,包括服务账户读取,仍在一个命名tmux会话内运行。
  • 默认情况下,不要使用服务账户枚举存储库/项。如果用户明确要求搜索、提供截图/列表或仅给出模糊的项名称,请在桌面回退之前使用下面的安全元数据搜索。
  • 仅打印存在性/形状,绝不打印令牌或密钥值。

必需的持久Tmux会话

Shell工具每个命令使用一个新的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.

相关技能