Ein Protokoll für Secrets und KI-Agenten · macOS
Dein Agent kennt den Namen.
Nie den Wert.
SecretBar ist ein Befehl und eine Menüleisten-App für den Mac. Passwörter, Tokens und API-Schlüssel bleiben in der Secure Enclave. Der Agent fragt nach dem Namen, ein Mensch bestätigt, der Prozess erhält den Wert, und die Ausgabe kommt geschwärzt zurück.
$ brew install secretbar/tap/secretbaragent › Ich brauche das Datenbankpasswort für den Shop.
$ secret ls -l
SHOP_DB_PASSWORD shop: PostgreSQL password1
BILLING_API_TOKEN billing: prod API token
$ secret run --mask SHOP_DB_PASSWORD -- psql -c 'select 1'2
password=k9#Vq2!xR7mW → ***3
- Der Agent sieht Namen und Kommentare. Nie Werte.
- Touch ID auf deinem Mac. Der Wert geht in die Umgebung von psql und sonst nirgendwohin.
- Die Ausgabe kommt maskiert zurück. Auch in base64- und URL-Kodierung.
Das Protokoll
Sechs Regeln, denen der Wert folgt.
Jede Funktion von SecretBar setzt eine davon durch. Keine hängt davon ab, dass sich der Agent gut benimmt.
- §1
Eingabe
Ein Mensch tippt den Wert in einen verdeckten macOS-Dialog:
secret ask NAME. Der Chat sieht ihn nie.secret generzeugt einen Zufallswert, den niemand sieht. - §2
Speicherung
Schlüssel in der Secure Enclave versiegeln jeden Wert: P-256 und Post-Quanten-ML-KEM-768. Die ganze Datei ist zusätzlich verschlüsselt. Nichts geht in eine Cloud.
- §3
Zugriff
Jedes Lesen braucht Touch ID oder Apple Watch. Die Kulanzzeit gleitet 30 Minuten lang und endet, wenn der Bildschirm gesperrt wird. Eine Freigabe gibt einem Agenten benannte Secrets für bis zu 24 Stunden, nach einmal Touch ID.
- §4
Verwendung
secret runlegt den Wert in die Umgebung eines einzigen Prozesses. Nicht in argv, eine Datei oder den Chat. Eine.env-Datei enthält Verweise:secret:NAME. - §5
Ausgabe
Jeder Wert in stdout und stderr kommt als
***zurück, auch in base64- und URL-Kodierung. Ein Claude Code Hook stopptcat .env,secret getundenv, bevor sie laufen. - §6
Nachweis
Ein Zugriffsprotokoll hält fest, wer welchen Namen wann gelesen hat:
agentoderhuman. Nur Namen.
Die Menüleisten-App
Die menschliche Seite des Protokolls.
⌥⌘S aus jeder App, Spotlight, Siri und Kurzbefehle. Eine Karte für jedes Secret mit den .env-Dateien, die es nutzen. Die App liest nie einen Wert: Der Helfer legt ihn in die Zwischenablage und löscht ihn nach 30 Sekunden.
- Schnellsuche: ↩ kopiert den Verweis, ⇧↩ den Wert
- + in der Menüleiste: ein neues Secret, sein Verweis in der Zwischenablage
- Aktivität: Agent-Läufe und Touch ID-Anfragen
- English, Deutsch, Français, Español, Italiano, Português, Polski, Русский
Bedrohungsmodell
Was es verhindert, und was nicht.
| Bedrohung | Verhindert | Verhindert nicht |
|---|---|---|
| Ein Wert im Chat | Eingabe im Dialog, Generierung, maskierte Ausgabe, der Hook. | Ein Wert in einer eigenen Kodierung, zum Beispiel base64(user:pass). |
Ein Wert in ps | Werte gehen über stdin und Dateideskriptoren. | secret set NAME VALUE mit dem Wert als Argument. |
| Ein Prozess liest hinter deinem Rücken | Der Secure-Enclave-Schlüssel funktioniert nur nach Touch ID oder Apple Watch, für jeden Prozess. | Lesezugriffe innerhalb der Kulanzzeit: 30 Minuten Leerlauf, höchstens 8 Stunden. |
| Verlust des Mac | secret export: AES-256, PBKDF2 mit 600.000 Iterationen. | Ein vergessenes Backup-Passwort kann niemand wiederherstellen. |
Fragen
- Sieht der KI-Agent jemals den Wert eines Secrets?
- Nein. Der Agent arbeitet mit Namen. Der Wert geht in die Umgebung des Befehls, der ihn braucht, und die Ausgabe kommt mit
***statt des Werts zurück. Ein Claude Code Hook stoppt Befehle, die einen Wert ausgeben würden. - Wo werden die Secrets gespeichert?
- In einer verschlüsselten Datei auf deinem Mac. Schlüssel in der Secure Enclave versiegeln jeden Wert. Lesen braucht Touch ID, Apple Watch oder das Mac-Passwort. Nichts geht in eine Cloud.
- Mit welchen KI-Agenten funktioniert es?
- Mit jedem Agenten, der Shell-Befehle ausführt: Claude Code, Codex, Cursor, Aider und anderen. Claude Code bekommt zusätzlich einen Hook und fertige Regeln für seine
CLAUDE.md. - Was kostet es?
- Nichts. SecretBar ist Open Source unter der MIT-Lizenz.
- Welche macOS-Version brauche ich?
- macOS 14 oder neuer auf einem Mac mit Secure Enclave (Apple Chip oder T2). Der Post-Quanten-Speicher braucht macOS 26. Die Suche nach Bedeutung braucht macOS 27 mit Apple Intelligence.
- Kann ich meine Secrets auf einen neuen Mac umziehen?
- Ja.
secret exportschreibt eine Datei, verschlüsselt mit AES-256 und deinem Backup-Passwort.secret restoreliest sie auf dem neuen Mac.
Installation
Drei Zeilen. Dann hier unterschreiben.
- Der Befehl, beide Helfer und die zsh-Vervollständigung
$ brew install secretbar/tap/secretbar - Der Speicher, dann das erste Secret, in einem Dialog eingetippt
$ secret init && secret ask MY_TOKEN - Der Claude Code Hook, die Agent-Regeln und die Menüleisten-App
$ "$(brew --prefix secretbar)/libexec/install.sh" --claude-hook --app
macOS 14 oder neuer. Keine Abhängigkeiten außer den Systemwerkzeugen. Kostenlos und Open Source, MIT.