Um protocolo para segredos e agentes de IA · macOS
O seu agente conhece o nome.
Nunca o valor.
O SecretBar é um comando e uma app da barra de menus para o Mac. Palavras-passe, tokens e chaves de API ficam na Secure Enclave. O agente pede pelo nome, uma pessoa confirma, o processo recebe o valor e a saída volta rasurada.
$ brew install secretbar/tap/secretbaragent › Preciso da palavra-passe da base de dados da loja.
$ 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
- O agente vê nomes e comentários. Nunca valores.
- Touch ID no seu Mac. O valor vai para o ambiente do psql e para mais lado nenhum.
- A saída volta mascarada. Também em base64 e em codificação URL.
O protocolo
O valor segue seis regras.
Cada funcionalidade do SecretBar impõe uma delas. Nenhuma depende do bom comportamento do agente.
- §1
Introdução
Uma pessoa escreve o valor numa caixa de diálogo oculta do macOS:
secret ask NAME. O chat nunca o vê.secret gencria um valor aleatório que ninguém vê. - §2
Armazenamento
Chaves na Secure Enclave selam cada valor: P-256 e ML-KEM-768, pós-quântico. O ficheiro inteiro é cifrado de novo. Nada vai para a nuvem.
- §3
Acesso
Cada leitura requer Touch ID ou Apple Watch. O período de tolerância desliza durante 30 minutos e termina quando o ecrã bloqueia. Uma concessão dá a um agente segredos indicados pelo nome até 24 horas, após um único Touch ID.
- §4
Utilização
secret runcoloca o valor no ambiente de um único processo. Não em argv, num ficheiro ou no chat. Um ficheiro.envguarda referências:secret:NAME. - §5
Saída
Cada valor em stdout e stderr volta como
***, também em base64 e em codificação URL. Um hook para Claude Code bloqueiacat .env,secret geteenvantes de correrem. - §6
Registo
Um registo de acessos guarda quem leu que nome e quando:
agentouhuman. Só nomes.
A app da barra de menus
O lado humano do protocolo.
⌥⌘S a partir de qualquer app, Spotlight, Siri e Atalhos. Um cartão por segredo com os ficheiros .env que o usam. A app nunca lê um valor: o auxiliar coloca-o na área de transferência e limpa-o ao fim de 30 segundos.
- Pesquisa rápida: ↩ copia a referência, ⇧↩ o valor
- + na barra de menus: um segredo novo, com a referência na área de transferência
- Atividade: execuções do agente e pedidos de Touch ID
- English, Deutsch, Français, Español, Italiano, Português, Polski, Русский
Modelo de ameaças
O que trava, e o que não trava.
| Ameaça | Trava | Não trava |
|---|---|---|
| Um valor no chat | Introdução por diálogo, geração, saída mascarada, o hook. | Um valor numa codificação própria, por exemplo base64(user:pass). |
Um valor no ps | Os valores passam por stdin e descritores de ficheiro. | secret set NAME VALUE com o valor como argumento. |
| Um processo lê nas suas costas | A chave da Secure Enclave só funciona após Touch ID ou Apple Watch, para qualquer processo. | Leituras dentro do período de tolerância: 30 minutos inativo, 8 horas no máximo. |
| Perda do Mac | secret export: AES-256, PBKDF2 com 600 000 iterações. | Ninguém consegue recuperar uma palavra-passe de cópia esquecida. |
Perguntas
- O agente de IA alguma vez vê o valor de um segredo?
- Não. O agente trabalha com nomes. O valor vai para o ambiente do comando que precisa dele e a saída volta com
***em vez do valor. Um hook para Claude Code bloqueia os comandos que mostrariam um valor. - Onde ficam guardados os segredos?
- Num único ficheiro cifrado no seu Mac. Chaves na Secure Enclave selam cada valor. Uma leitura requer Touch ID, Apple Watch ou a palavra-passe do Mac. Nada vai para a nuvem.
- Com que agentes de IA funciona?
- Com qualquer agente que execute comandos de shell: Claude Code, Codex, Cursor, Aider e outros. O Claude Code recebe ainda um hook e regras prontas para o seu
CLAUDE.md. - Quanto custa?
- Nada. O SecretBar é open source, com licença MIT.
- Que versão do macOS é necessária?
- macOS 14 ou posterior num Mac com Secure Enclave (chip Apple ou T2). O armazenamento pós-quântico requer macOS 26. A pesquisa por significado requer macOS 27 com Apple Intelligence.
- Posso passar os meus segredos para um Mac novo?
- Sim.
secret exportescreve um ficheiro cifrado com AES-256 e a sua palavra-passe de cópia.secret restorelê-o no novo Mac.
Instalação
Três linhas, depois assine aqui.
- O comando, os dois auxiliares e o preenchimento automático do zsh
$ brew install secretbar/tap/secretbar - O armazenamento e depois o primeiro segredo, escrito numa caixa de diálogo
$ secret init && secret ask MY_TOKEN - O hook para Claude Code, as regras do agente e a app da barra de menus
$ "$(brew --prefix secretbar)/libexec/install.sh" --claude-hook --app
macOS 14 ou posterior. Sem dependências além das ferramentas do sistema. Gratuito e open source, MIT.