CommunityCodierung & Entwicklunggithub.com

steipete/one-password

1Password/op: Service-Account zuerst, gezieltes Lesen/Speichern/Injizieren von Secrets, tmux.

Was ist one-password?

Diese Skill bietet einen zuverlässigen und sicheren Zugriff auf den 1Password CLI (`op`) für KI-Agenten wie Claude Code, Cursor oder Codex. Sie priorisiert nicht-interaktive Service-Account-Tokens für die Secret-Verwaltung und fällt nur bei Bedarf auf die Desktop-App zurück, um Benutzerdialoge zu vermeiden. Eine wesentliche Anforderung ist die Verwendung einer einzigen, persistenten tmux-Sitzung für alle `op`-Befehle, da die Shell des Tools pro Befehl eine neue TTY erstellt. Die Skill umfasst Workflows zum Speichern, Lesen und Überprüfen von Secrets mit Schwerpunkt auf Genauigkeit (z. B. exakte Feldlesungen über JSON), ohne jemals Secret-Werte in Logs oder Chat auszugeben. Sie wird auf GitHub unter steipete/one-password gehostet und ist für Entwickler konzipiert, die automatisierte, sichere Secret-Operationen mit 1Password benötigen.

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

Installed? Explore more Codierung & Entwicklung skills: steipete/bluebubbles, steipete/eightctl, steipete/blucli · View all 6 →

In Ihrer bevorzugten KI fragen

Öffnet einen neuen Chat, in dem dieser Agent-Skill bereits geladen ist.

Dokumentation

1Password CLI

Folgen Sie den offiziellen CLI-Erste-Schritte-Schritten. Raten Sie keine Installationsbefehle.

Referenzen

  • Offizielle Dokumentation: https://developer.1password.com/docs/cli/get-started/
  • references/get-started.md (Installation + App-Integration + Anmeldevorgang)
  • references/cli-examples.md (echte op-Beispiele, einschließlich sicherer Muster zum Erstellen/Bearbeiten von Einträgen)

Arbeitsablauf

  1. Betriebssystem + Shell überprüfen.
  2. Überprüfen, ob die CLI in tmux vorhanden ist: op --version.
  3. ERFORDERLICH: Genau eine benannte persistente tmux-Sitzung für die gesamte Secret-Aufgabe erstellen.
  4. Zuerst versuchen, einen eingeschränkten Service-Account-Zugriff zu verwenden, wenn ein passender Token/Workflow vorhanden ist; keine Dialoge.
  5. Wenn der Service-Account-Zugriff fehlt oder nicht den genauen benötigten Eintrag/das genaue Feld enthält, automatisch den Desktop-App-Fallback in derselben Sitzung versuchen. Nicht zuerst um Chat-Erlaubnis fragen.
  6. Desktop-Fallback: App-Integration/Entsperrung auslösen, dann op signin einmal innerhalb derselben Sitzung. Die 1Password-Eingabeaufforderung ist die Benutzerautorisierungsgrenze; nur im Chat fragen, wenn die Aufforderung nicht angezeigt oder abgeschlossen werden kann.
  7. Den gewählten Zugriffspfad innerhalb derselben Sitzung überprüfen: op whoami.
  8. Bei mehreren Konten: --account oder OP_ACCOUNT verwenden.
  9. Wenn ein Befehl fehlschlägt, dieselbe tmux-Sitzung mit tmux send-keys wiederverwenden; keine zweite Sitzung nur für einen Wiederholungsversuch starten.

Standardkonto

  • Das Standardkonto für persönliche/berufliche Secrets ist my.1password.com.
  • Nicht stillschweigend my.1password.eu / Titan verwenden, es sei denn, es wurde explizit darum gebeten.
  • --account my.1password.com bei jedem op-Befehl zum Speichern oder Lesen von Secrets übergeben. Sich nicht auf die automatische Kontoauswahl verlassen.
  • op account list ist nur Metadaten, muss aber trotzdem in tmux ausgeführt werden. Verwenden Sie es, um Kontonamen zu bestätigen, wenn die Weiterleitung unklar ist.
  • op signin --account my.1password.com kann den Status 0 ohne nützliche Ausgabe zurückgeben und dennoch eine spätere Shell nicht angemeldet lassen. Bevorzugen Sie es, Anmeldung, Erstellen/Bearbeiten/Abrufen und Überprüfung in derselben tmux-Shell durchzuführen.

Service-Account-Tokens

  • Service-Account-Tokens vor jedem interaktiven 1Password-Vorgang bevorzugen. Benutzerdialoge sind nur ein Fallback.
  • 1Password-Service-Accounts sind nicht-interaktive Tokens für einen bestimmten Tresor/Bereich, nützlich für Automatisierung ohne Entsperren der Desktop-App.
  • Peters standardmäßiger Service-Account-Token wird aus ~/.profile als OP_SERVICE_ACCOUNT_TOKEN in einem Codex-verwalteten Block exportiert. Er ist auf den eingeschränkten Molty-Tresor beschränkt.
  • Ältere Shells können denselben Wert als MOLTY_OP_SERVICE_ACCOUNT_TOKEN bereitstellen; dies als Fallback-Alias für bekannte Molty-Tresor-Einträge behandeln.
  • Wenn der Token nicht bereits exportiert ist, nicht zutrifft oder der genaue bekannte Eintrag/das genaue Feld nicht gelesen werden kann, automatisch den Desktop-App-1Password-Vorgang unten verwenden. Nur fragen, wenn eine tatsächliche Entsperrung oder andere Benutzerinteraktion blockiert bleibt.
  • Den Token nur für den einzelnen Befehl exportieren/übergeben, der ihn benötigt: OP_SERVICE_ACCOUNT_TOKEN="$OP_SERVICE_ACCOUNT_TOKEN" op item get "<bekannter Eintrag>" --vault Molty ....
  • Service-Account-op-Lesevorgänge erfordern eine explizite Tresorabfrage; das Weglassen von --vault Molty schlägt fehl, selbst wenn der Token gültig ist.
  • Die tmux-Regel einhalten: Jeder op-Befehl, einschließlich Service-Account-Lesevorgänge, läuft weiterhin innerhalb einer einzelnen benannten tmux-Sitzung.
  • Standardmäßig keine Tresore/Einträge mit Service-Accounts auflisten. Wenn der Benutzer explizit bittet zu suchen, einen Screenshot/eine Auflistung gibt oder nur einen ungefähren Eintragsnamen angibt, die sichere Metadatensuche unten vor dem Desktop-Fallback verwenden.
  • Nur Vorhandensein/Form anzeigen, niemals Token- oder Secret-Werte.

Erforderliche persistente tmux-Sitzung

Das Shell-Tool verwendet pro Befehl eine neue TTY. Führen Sie op innerhalb einer dedizierten tmux-Sitzung aus und verwenden Sie dieselbe Sitzung, bis die gesamte Secret-Aufgabe erledigt ist. Service-Account-Befehle werden ebenfalls hier ausgeführt, dürfen aber keine App-Aufforderungen auslösen.

Beispiel:

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

Keine neue tmux-Sitzung nach einem Fehler bei Anführungszeichen, Eintragsnamen oder Befehl erstellen. Einen korrigierten Befehl in die vorhandene Sitzung senden. Die Sitzung als $SESSION: ansprechen, nicht Fenster 0 annehmen; ältere Sitzungen können Fensterindizes haben, die bei 1 beginnen.

Dienstspezifische Arbeitsabläufe

  • Dienstspezifische Authentifizierungsdetails in der zugehörigen Skill belassen.
  • Für npm-Registrierungs-/Paketarbeit $npm verwenden; es dokumentiert den Molty-Service-Account-Eintrag, den nicht-interaktiven Authentifizierungs-Wrapper und den Paketreservierungs-Helfer.
  • Diese Skill besitzt nur die generischen 1Password-Regeln: tmux-only op, gezielte Lesevorgänge, eine persistente Sitzung, keine breite Auflistung, keine Secret-Ausgabe.

Bekanntes funktionierendes Secret-Schreibmuster

Die persistente tmux-Sitzung verwenden. Die genaue Secret-Aufgabe in ein temporäres Skript schreiben, dann dieses Skript an op-work senden; keine zweite tmux-Sitzung für Wiederholungsversuche erstellen.

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

Der op-Kategoriename ist in diesem CLI-Build lesbar und groß-/kleinschreibungssensitiv; verwenden Sie "API Credential", nicht api_credential.

Exakte Feldlesungen

Bei einem bekannten Eintrag die Feldform überprüfen, bevor Sie es live verwenden: Länge, erwartetes Präfix, Anzahl Zeilenumbrüche, niemals den Wert. op --field NAME und --fields label=NAME können das falsche versteckte Feld zurückgeben, wenn ein Eintrag doppelte/veraltete Anmeldeinformationsfelder hat. Wenn die Form falsch ist, den bekannten Eintrag als JSON lesen und das genaue Label extrahieren.

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-Extraktion auf den bekannten Eintrag und Tresor beschränken. Keine Tresore/Einträge auflisten, um Kandidaten zu entdecken.

Explizite Eintragssuche

Nur verwenden, wenn der Benutzer explizit bittet zu suchen, einen Screenshot/eine Auflistung gibt oder die genaue Titelschätzung fehlgeschlagen ist und der Benutzer nach Regex/unscharfer Suche fragt. Auf Tresor beschränkt und nur Metadaten bleiben; Kandidatentitel/IDs/Kategorien/Tresornamen anzeigen, niemals Felder oder Werte. Bevorzugt zuerst exakte sichtbare Zeichenfolgen aus Screenshots verwenden: Tresorname, Eintragstitel und Feldbezeichnung.

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

Nach der Auswahl eines Kandidaten zurück zur exakten Eintrags-/Feld-JSON-Extraktion und formgesteuerten Validierung wechseln. Ein genauer bekannter persönlicher Eintrag kann automatisch den Desktop-Fallback verwenden; persönliche Tresore nicht breit auflisten, es sei denn, der Benutzer hat darum gebeten zu suchen.

Geschwärztes Debugging

Die gesamte Pipeline innerhalb derselben tmux-Sitzung halten. Status und Ausgabelänge überprüfen, niemals Secret-Werte.

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

Schutzmaßnahmen

  • Niemals Secrets in Logs, Chat oder Code einfügen.
  • op run / op inject gegenüber dem Schreiben von Secrets auf die Festplatte bevorzugen.
  • Wenn eine Anmeldung ohne App-Integration erforderlich ist, op account add verwenden.
  • Wenn ein Befehl "account is not signed in" zurückgibt, op signin in tmux erneut ausführen und in der App autorisieren.
  • Die Desktop-1Password-Entsperraufforderung die Benutzerinteraktion direkt anfordern lassen; keine separate Chat-Erlaubnis-Round-Trip davor einfügen.
  • op nicht außerhalb von tmux ausführen; anhalten und fragen, wenn tmux nicht verfügbar ist.

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.

Verwandte Skills