Un protocole pour les secrets et les agents IA · macOS
Votre agent connaît le nom.
Jamais la valeur.
SecretBar est une commande et une app de barre des menus pour le Mac. Mots de passe, jetons et clés d’API restent dans la Secure Enclave. L’agent demande par le nom, un humain confirme, le processus reçoit la valeur, et la sortie revient caviardée.
$ brew install secretbar/tap/secretbaragent › Il me faut le mot de passe de la base de données de la boutique.
$ 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
- L’agent voit les noms et les commentaires. Jamais les valeurs.
- Touch ID sur votre Mac. La valeur va dans l’environnement de psql, et nulle part ailleurs.
- La sortie revient masquée. Aussi en base64 et en encodage URL.
Le protocole
La valeur obéit à six règles.
Chaque fonction de SecretBar en applique une. Aucune ne compte sur la bonne conduite de l’agent.
- §1
Saisie
Un humain tape la valeur dans une boîte de dialogue macOS masquée :
secret ask NAME. Le chat ne la voit jamais.secret gencrée une valeur aléatoire que personne ne voit. - §2
Stockage
Des clés de la Secure Enclave scellent chaque valeur : P-256 et ML-KEM-768, post-quantique. Le fichier entier est chiffré une seconde fois. Rien ne part dans un cloud.
- §3
Accès
Toute lecture exige Touch ID ou l’Apple Watch. Le délai de grâce glisse sur 30 minutes et prend fin au verrouillage de l’écran. Un bail donne à un agent des secrets nommés pour 24 heures au plus, après un seul Touch ID.
- §4
Usage
secret runplace la valeur dans l’environnement d’un seul processus. Ni dans argv, ni dans un fichier, ni dans le chat. Un fichier.envcontient des références :secret:NAME. - §5
Sortie
Chaque valeur dans stdout et stderr revient sous la forme
***, aussi en base64 et en encodage URL. Un hook Claude Code bloquecat .env,secret getetenvavant leur exécution. - §6
Traçabilité
Un journal d’accès garde qui a lu quel nom, et quand :
agentouhuman. Les noms seulement.
L’app de barre des menus
Le versant humain du protocole.
⌥⌘S depuis n’importe quelle app, Spotlight, Siri et Raccourcis. Une fiche par secret avec les fichiers .env qui l’utilisent. L’app ne lit jamais une valeur : l’assistant la place dans le presse-papiers et l’efface après 30 secondes.
- Recherche rapide : ↩ copie la référence, ⇧↩ la valeur
- + dans la barre des menus : un nouveau secret, sa référence dans le presse-papiers
- Activité : exécutions de l’agent et demandes Touch ID
- English, Deutsch, Français, Español, Italiano, Português, Polski, Русский
Modèle de menace
Ce qu’il arrête, et ce qu’il n’arrête pas.
| Menace | Arrête | N’arrête pas |
|---|---|---|
| Une valeur dans le chat | Saisie par dialogue, génération, sortie masquée, le hook. | Une valeur dans un encodage maison, par exemple base64(user:pass). |
Une valeur dans ps | Les valeurs passent par stdin et des descripteurs de fichiers. | secret set NAME VALUE avec la valeur en argument. |
| Un processus lit dans votre dos | La clé de la Secure Enclave ne fonctionne qu’après Touch ID ou l’Apple Watch, pour tout processus. | Les lectures pendant le délai de grâce : 30 minutes d’inactivité, 8 heures au plus. |
| Perte du Mac | secret export : AES-256, PBKDF2 avec 600 000 itérations. | Personne ne peut récupérer un mot de passe de sauvegarde oublié. |
Questions
- L’agent IA voit-il un jour la valeur d’un secret ?
- Non. L’agent travaille avec des noms. La valeur va dans l’environnement de la commande qui en a besoin, et la sortie revient avec
***à la place de la valeur. Un hook Claude Code bloque les commandes qui afficheraient une valeur. - Où les secrets sont-ils stockés ?
- Dans un seul fichier chiffré sur votre Mac. Des clés de la Secure Enclave scellent chaque valeur. Une lecture exige Touch ID, l’Apple Watch ou le mot de passe du Mac. Rien ne part dans un cloud.
- Avec quels agents IA fonctionne-t-il ?
- Avec tout agent qui lance des commandes shell : Claude Code, Codex, Cursor, Aider et d’autres. Claude Code reçoit en plus un hook et des règles prêtes pour son
CLAUDE.md. - Combien ça coûte ?
- Rien. SecretBar est open source sous licence MIT.
- Quelle version de macOS faut-il ?
- macOS 14 ou ultérieur sur un Mac avec Secure Enclave (puce Apple ou T2). Le stockage post-quantique exige macOS 26. La recherche par le sens exige macOS 27 avec Apple Intelligence.
- Puis-je transférer mes secrets vers un nouveau Mac ?
- Oui.
secret exportécrit un fichier chiffré avec AES-256 et votre mot de passe de sauvegarde.secret restorele lit sur le nouveau Mac.
Installation
Trois lignes, puis signez ici.
- La commande, les deux assistants et la complétion zsh
$ brew install secretbar/tap/secretbar - Le stockage, puis le premier secret, saisi dans une boîte de dialogue
$ secret init && secret ask MY_TOKEN - Le hook Claude Code, les règles de l’agent et l’app de barre des menus
$ "$(brew --prefix secretbar)/libexec/install.sh" --claude-hook --app
macOS 14 ou ultérieur. Aucune dépendance hors des outils du système. Gratuit et open source, MIT.