Protokół dla sekretów i agentów AI · macOS
Twój agent zna nazwę.
Nigdy wartości.
SecretBar to polecenie i aplikacja na pasek menu dla Maca. Hasła, tokeny i klucze API zostają w Secure Enclave. Agent prosi po nazwie, człowiek potwierdza, proces dostaje wartość, a wyjście wraca zaczernione.
$ brew install secretbar/tap/secretbaragent › Potrzebuję hasła do bazy danych sklepu.
$ 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
- Agent widzi nazwy i komentarze. Nigdy wartości.
- Touch ID na Twoim Macu. Wartość trafia do środowiska psql i nigdzie indziej.
- Wyjście wraca zamaskowane. Także w base64 i w kodowaniu URL.
Protokół
Sześć zasad, których trzyma się wartość.
Każda funkcja SecretBar egzekwuje jedną z nich. Żadna nie zależy od dobrego zachowania agenta.
- §1
Wprowadzanie
Człowiek wpisuje wartość w ukrytym oknie macOS:
secret ask NAME. Czat nigdy jej nie widzi.secret gentworzy losową wartość, której nikt nie widzi. - §2
Przechowywanie
Klucze w Secure Enclave pieczętują każdą wartość: P-256 i postkwantowy ML-KEM-768. Cały plik jest szyfrowany jeszcze raz. Nic nie trafia do chmury.
- §3
Dostęp
Każdy odczyt wymaga Touch ID lub Apple Watch. Okres karencji przesuwa się o 30 minut i kończy się po zablokowaniu ekranu. Dzierżawa daje agentowi wskazane sekrety do 24 godzin, po jednym Touch ID.
- §4
Użycie
secret runwstawia wartość do środowiska jednego procesu. Nie do argv, pliku ani czatu. Plik.envzawiera odwołania:secret:NAME. - §5
Wyjście
Każda wartość w stdout i stderr wraca jako
***, także w base64 i w kodowaniu URL. Hook dla Claude Code zatrzymujecat .env,secret getienv, zanim się uruchomią. - §6
Ślad
Dziennik dostępu zapisuje, kto i kiedy odczytał którą nazwę:
agentlubhuman. Tylko nazwy.
Aplikacja na pasek menu
Ludzka strona protokołu.
⌥⌘S z każdej aplikacji, Spotlight, Siri i Skróty. Karta dla każdego sekretu z plikami .env, które go używają. Aplikacja nigdy nie czyta wartości: pomocnik kładzie ją w schowku i czyści go po 30 sekundach.
- Szybkie wyszukiwanie: ↩ kopiuje odwołanie, ⇧↩ wartość
- + na pasku menu: nowy sekret, jego odwołanie w schowku
- Aktywność: uruchomienia agenta i prośby o Touch ID
- English, Deutsch, Français, Español, Italiano, Português, Polski, Русский
Model zagrożeń
Co zatrzymuje, a czego nie.
| Zagrożenie | Zatrzymuje | Nie zatrzymuje |
|---|---|---|
| Wartość w czacie | Wprowadzanie w oknie, generowanie, maskowane wyjście, hook. | Wartość we własnym kodowaniu, na przykład base64(user:pass). |
Wartość w ps | Wartości idą przez stdin i deskryptory plików. | secret set NAME VALUE z wartością jako argumentem. |
| Proces czyta za Twoimi plecami | Klucz Secure Enclave działa tylko po Touch ID lub Apple Watch, dla każdego procesu. | Odczyty w okresie karencji: 30 minut bezczynności, najwyżej 8 godzin. |
| Utrata Maca | secret export: AES-256, PBKDF2 z 600 000 iteracji. | Nikt nie odzyska zapomnianego hasła kopii zapasowej. |
Pytania
- Czy agent AI kiedykolwiek widzi wartość sekretu?
- Nie. Agent pracuje na nazwach. Wartość trafia do środowiska polecenia, które jej potrzebuje, a wyjście wraca z
***zamiast wartości. Hook dla Claude Code zatrzymuje polecenia, które wypisałyby wartość. - Gdzie są przechowywane sekrety?
- W jednym zaszyfrowanym pliku na Twoim Macu. Klucze w Secure Enclave pieczętują każdą wartość. Odczyt wymaga Touch ID, Apple Watch lub hasła Maca. Nic nie trafia do chmury.
- Z jakimi agentami AI działa?
- Z każdym agentem, który uruchamia polecenia powłoki: Claude Code, Codex, Cursor, Aider i innymi. Claude Code dostaje dodatkowo hook i gotowe reguły do swojego
CLAUDE.md. - Ile to kosztuje?
- Nic. SecretBar jest open source na licencji MIT.
- Jakiej wersji macOS potrzebuję?
- macOS 14 lub nowszego na Macu z Secure Enclave (układ Apple lub T2). Magazyn postkwantowy wymaga macOS 26. Wyszukiwanie po znaczeniu wymaga macOS 27 z Apple Intelligence.
- Czy mogę przenieść sekrety na nowego Maca?
- Tak.
secret exportzapisuje jeden plik zaszyfrowany AES-256 i Twoim hasłem kopii zapasowej.secret restoreodczytuje go na nowym Macu.
Instalacja
Trzy linijki. Potem podpis tutaj.
- Polecenie, oba pomocniki i uzupełnianie dla zsh
$ brew install secretbar/tap/secretbar - Magazyn, potem pierwszy sekret, wpisany w oknie
$ secret init && secret ask MY_TOKEN - Hook dla Claude Code, reguły dla agenta i aplikacja na pasek menu
$ "$(brew --prefix secretbar)/libexec/install.sh" --claude-hook --app
macOS 14 lub nowszy. Bez zależności poza narzędziami systemu. Darmowe i open source, MIT.