Un protocolo para secretos y agentes de IA · macOS
Tu agente conoce el nombre.
Nunca el valor.
SecretBar es un comando y una app de la barra de menús para el Mac. Las contraseñas, los tokens y las claves de API se quedan en la Secure Enclave. El agente pide por nombre, una persona confirma, el proceso recibe el valor y la salida vuelve censurada.
$ brew install secretbar/tap/secretbaragent › Necesito la contraseña de la base de datos de la tienda.
$ 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
- El agente ve nombres y comentarios. Nunca valores.
- Touch ID en tu Mac. El valor va al entorno de psql y a ningún otro sitio.
- La salida vuelve enmascarada. También en base64 y en codificación URL.
El protocolo
El valor sigue seis reglas.
Cada función de SecretBar aplica una de ellas. Ninguna depende de que el agente se porte bien.
- §1
Entrada
Una persona escribe el valor en un diálogo oculto de macOS:
secret ask NAME. El chat nunca lo ve.secret gencrea un valor aleatorio que nadie ve. - §2
Almacenamiento
Claves de la Secure Enclave sellan cada valor: P-256 y ML-KEM-768, poscuántico. Todo el archivo se cifra otra vez. Nada va a la nube.
- §3
Acceso
Cada lectura requiere Touch ID o el Apple Watch. El periodo de gracia se desliza durante 30 minutos y termina al bloquearse la pantalla. Una concesión da a un agente secretos con nombre durante 24 horas como máximo, tras un solo Touch ID.
- §4
Uso
secret runpone el valor en el entorno de un solo proceso. No en argv, ni en un archivo, ni en el chat. Un archivo.envguarda referencias:secret:NAME. - §5
Salida
Cada valor en stdout y stderr vuelve como
***, también en base64 y en codificación URL. Un hook para Claude Code detienecat .env,secret getyenvantes de que se ejecuten. - §6
Registro
Un registro de accesos guarda quién leyó qué nombre y cuándo:
agentohuman. Solo nombres.
La app de la barra de menús
La parte humana del protocolo.
⌥⌘S desde cualquier app, Spotlight, Siri y Atajos. Una ficha por secreto con los archivos .env que lo usan. La app nunca lee un valor: el asistente lo copia al portapapeles y lo borra a los 30 segundos.
- Búsqueda rápida: ↩ copia la referencia, ⇧↩ el valor
- + en la barra de menús: un secreto nuevo, con su referencia en el portapapeles
- Actividad: ejecuciones del agente y solicitudes de Touch ID
- English, Deutsch, Français, Español, Italiano, Português, Polski, Русский
Modelo de amenazas
Lo que detiene, y lo que no.
| Amenaza | Detiene | No detiene |
|---|---|---|
| Un valor en el chat | Entrada por diálogo, generación, salida enmascarada, el hook. | Un valor dentro de una codificación propia, por ejemplo base64(user:pass). |
Un valor en ps | Los valores pasan por stdin y descriptores de archivo. | secret set NAME VALUE con el valor como argumento. |
| Un proceso lee a tus espaldas | La clave de la Secure Enclave solo funciona tras Touch ID o el Apple Watch, para cualquier proceso. | Lecturas dentro del periodo de gracia: 30 minutos sin uso, 8 horas como máximo. |
| Pérdida del Mac | secret export: AES-256, PBKDF2 con 600 000 iteraciones. | Nadie puede recuperar una contraseña de copia olvidada. |
Preguntas
- ¿Ve alguna vez el agente de IA el valor de un secreto?
- No. El agente trabaja con nombres. El valor va al entorno del comando que lo necesita y la salida vuelve con
***en lugar del valor. Un hook para Claude Code detiene los comandos que mostrarían un valor. - ¿Dónde se guardan los secretos?
- En un solo archivo cifrado en tu Mac. Claves de la Secure Enclave sellan cada valor. Una lectura requiere Touch ID, el Apple Watch o la contraseña del Mac. Nada va a la nube.
- ¿Con qué agentes de IA funciona?
- Con cualquier agente que ejecute comandos de shell: Claude Code, Codex, Cursor, Aider y otros. Claude Code recibe además un hook y reglas listas para su
CLAUDE.md. - ¿Cuánto cuesta?
- Nada. SecretBar es de código abierto, con licencia MIT.
- ¿Qué versión de macOS necesito?
- macOS 14 o posterior en un Mac con Secure Enclave (chip de Apple o T2). El almacén poscuántico necesita macOS 26. La búsqueda por significado necesita macOS 27 con Apple Intelligence.
- ¿Puedo pasar mis secretos a un Mac nuevo?
- Sí.
secret exportescribe un archivo cifrado con AES-256 y tu contraseña de copia.secret restorelo lee en el Mac nuevo.
Instalación
Tres líneas. Luego, firma aquí.
- El comando, los dos asistentes y el autocompletado de zsh
$ brew install secretbar/tap/secretbar - El almacén y luego el primer secreto, escrito en un diálogo
$ secret init && secret ask MY_TOKEN - El hook para Claude Code, las reglas del agente y la app de la barra de menús
$ "$(brew --prefix secretbar)/libexec/install.sh" --claude-hook --app
macOS 14 o posterior. Sin dependencias más allá de las herramientas del sistema. Gratis y de código abierto, MIT.