Secret
GitHub ↗

Un protocollo per segreti e agenti IA · macOS

Il tuo agente conosce il nome.
Mai il valore.

SecretBar è un comando e un’app per la barra dei menu del Mac. Password, token e chiavi API restano nella Secure Enclave. L’agente chiede per nome, una persona conferma, il processo riceve il valore e l’output torna oscurato.

$ brew install secretbar/tap/secretbar
Leggi il protocollo ↓
Trascrizionesessione dell’agente · shop · 14 nov 2026

agent › Mi serve la password del database del negozio.

$ 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. L’agente vede nomi e commenti. Mai valori.
  2. Touch ID sul tuo Mac. Il valore va nell’ambiente di psql, e da nessun’altra parte.
  3. L’output torna mascherato. Anche in base64 e in codifica URL.

Il protocollo

Il valore segue sei regole.

Ogni funzione di SecretBar ne applica una. Nessuna dipende dal buon comportamento dell’agente.

  1. §1

    Inserimento

    Una persona digita il valore in una finestra nascosta di macOS: secret ask NAME. La chat non lo vede mai. secret gen crea un valore casuale che nessuno vede.

  2. §2

    Archiviazione

    Chiavi nella Secure Enclave sigillano ogni valore: P-256 e ML-KEM-768, post-quantistico. L’intero file è cifrato una seconda volta. Niente va nel cloud.

  3. §3

    Accesso

    Ogni lettura richiede Touch ID o Apple Watch. Il periodo di tolleranza scorre per 30 minuti e finisce quando lo schermo si blocca. Una concessione dà a un agente segreti indicati per nome fino a 24 ore, dopo un solo Touch ID.

  4. §4

    Uso

    secret run mette il valore nell’ambiente di un solo processo. Non in argv, in un file o nella chat. Un file .env contiene riferimenti: secret:NAME.

  5. §5

    Output

    Ogni valore in stdout e stderr torna come ***, anche in base64 e in codifica URL. Un hook per Claude Code ferma cat .env, secret get e env prima che partano.

  6. §6

    Registro

    Un registro accessi conserva chi ha letto quale nome e quando: agent o human. Solo nomi.

L’app per la barra dei menu

Il lato umano del protocollo.

Finestra principale di SecretBar con un elenco di segreti e la scheda di SHOP_DB_PASSWORD
Fig. 1 — SecretBar. Dati di esempio.

⌥⌘S da qualsiasi app, Spotlight, Siri e Comandi rapidi. Una scheda per ogni segreto con i file .env che lo usano. L’app non legge mai un valore: l’helper lo mette negli appunti e li svuota dopo 30 secondi.

  • Ricerca rapida: ↩ copia il riferimento, ⇧↩ il valore
  • + nella barra dei menu: un nuovo segreto, con il riferimento negli appunti
  • Attività: esecuzioni dell’agente e richieste di Touch ID
  • English, Deutsch, Français, Español, Italiano, Português, Polski, Русский

Modello di minaccia

Cosa ferma, e cosa no.

MinacciaFermaNon ferma
Un valore nella chatInserimento in finestra, generazione, output mascherato, l’hook.Un valore in una codifica personalizzata, per esempio base64(user:pass).
Un valore in psI valori passano per stdin e descrittori di file.secret set NAME VALUE con il valore come argomento.
Un processo legge a tua insaputaLa chiave della Secure Enclave funziona solo dopo Touch ID o Apple Watch, per ogni processo.Letture nel periodo di tolleranza: 30 minuti di inattività, 8 ore al massimo.
Perdita del Macsecret export: AES-256, PBKDF2 con 600.000 iterazioni.Nessuno può recuperare una password di backup dimenticata.

Domande

L’agente IA vede mai il valore di un segreto?
No. L’agente lavora con i nomi. Il valore va nell’ambiente del comando che ne ha bisogno e l’output torna con *** al posto del valore. Un hook per Claude Code ferma i comandi che stamperebbero un valore.
Dove sono conservati i segreti?
In un unico file cifrato sul tuo Mac. Chiavi nella Secure Enclave sigillano ogni valore. Una lettura richiede Touch ID, Apple Watch o la password del Mac. Niente va nel cloud.
Con quali agenti IA funziona?
Con qualsiasi agente che esegue comandi shell: Claude Code, Codex, Cursor, Aider e altri. Claude Code riceve anche un hook e regole pronte per il suo CLAUDE.md.
Quanto costa?
Niente. SecretBar è open source con licenza MIT.
Quale versione di macOS serve?
macOS 14 o successivo su un Mac con Secure Enclave (chip Apple o T2). L’archivio post-quantistico richiede macOS 26. La ricerca per significato richiede macOS 27 con Apple Intelligence.
Posso spostare i miei segreti su un nuovo Mac?
Sì. secret export scrive un file cifrato con AES-256 e la tua password di backup. secret restore lo legge sul nuovo Mac.

Installazione

Tre righe, poi firma qui.

  1. Il comando, entrambi gli helper e il completamento zsh
    $ brew install secretbar/tap/secretbar
  2. L’archivio, poi il primo segreto, digitato in una finestra
    $ secret init && secret ask MY_TOKEN
  3. L’hook per Claude Code, le regole per l’agente e l’app per la barra dei menu
    $ "$(brew --prefix secretbar)/libexec/install.sh" --claude-hook --app
Touch ID

macOS 14 o successivo. Nessuna dipendenza oltre agli strumenti di sistema. Gratuito e open source, MIT.