Secret
GitHub ↗

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/secretbar
Leer el protocolo ↓
Transcripciónsesión del agente · shop · 14 nov 2026

agent › 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

  1. El agente ve nombres y comentarios. Nunca valores.
  2. Touch ID en tu Mac. El valor va al entorno de psql y a ningún otro sitio.
  3. 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. §1

    Entrada

    Una persona escribe el valor en un diálogo oculto de macOS: secret ask NAME. El chat nunca lo ve. secret gen crea un valor aleatorio que nadie ve.

  2. §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. §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. §4

    Uso

    secret run pone el valor en el entorno de un solo proceso. No en argv, ni en un archivo, ni en el chat. Un archivo .env guarda referencias: secret:NAME.

  5. §5

    Salida

    Cada valor en stdout y stderr vuelve como ***, también en base64 y en codificación URL. Un hook para Claude Code detiene cat .env, secret get y env antes de que se ejecuten.

  6. §6

    Registro

    Un registro de accesos guarda quién leyó qué nombre y cuándo: agent o human. Solo nombres.

La app de la barra de menús

La parte humana del protocolo.

Ventana principal de SecretBar con una lista de secretos y la ficha de SHOP_DB_PASSWORD
Fig. 1 — SecretBar. Datos de demostración.

⌥⌘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.

AmenazaDetieneNo detiene
Un valor en el chatEntrada 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 psLos valores pasan por stdin y descriptores de archivo.secret set NAME VALUE con el valor como argumento.
Un proceso lee a tus espaldasLa 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 Macsecret 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 export escribe un archivo cifrado con AES-256 y tu contraseña de copia. secret restore lo lee en el Mac nuevo.

Instalación

Tres líneas. Luego, firma aquí.

  1. El comando, los dos asistentes y el autocompletado de zsh
    $ brew install secretbar/tap/secretbar
  2. El almacén y luego el primer secreto, escrito en un diálogo
    $ secret init && secret ask MY_TOKEN
  3. 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
Touch ID

macOS 14 o posterior. Sin dependencias más allá de las herramientas del sistema. Gratis y de código abierto, MIT.