Протокол для секретов и ИИ-агентов · macOS
Ваш агент знает имя.
Но не значение.
SecretBar — команда и приложение в строке меню для Mac. Пароли, токены и API-ключи остаются в Secure Enclave. Агент просит по имени, человек подтверждает, процесс получает значение, а вывод возвращается с вымаранными значениями.
$ brew install secretbar/tap/secretbaragent › Мне нужен пароль от базы данных магазина.
$ 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
- Агент видит имена и комментарии. Значения — никогда.
- Touch ID на вашем Mac. Значение попадает в окружение psql и больше никуда.
- Вывод возвращается замаскированным. Также в base64 и URL-кодировке.
Протокол
Шесть правил, по которым живёт значение.
Каждая функция SecretBar обеспечивает одно из них. Ни одно не зависит от того, хорошо ли ведёт себя агент.
- §1
Ввод
Человек вводит значение в скрытое окно macOS:
secret ask NAME. Чат его не видит.secret genсоздаёт случайное значение, которого не видит никто. - §2
Хранение
Ключи в Secure Enclave запечатывают каждое значение: P-256 и постквантовый ML-KEM-768. Весь файл зашифрован ещё раз. В облако не уходит ничего.
- §3
Доступ
Каждое чтение требует Touch ID или Apple Watch. Льготное окно скользит 30 минут и закрывается при блокировке экрана. Аренда даёт агенту названные секреты до 24 часов после одного Touch ID.
- §4
Использование
secret runкладёт значение в окружение одного процесса. Не в argv, не в файл и не в чат. Файл.envхранит ссылки:secret:NAME. - §5
Вывод
Каждое значение в stdout и stderr возвращается как
***, также в base64 и URL-кодировке. Хук для Claude Code останавливаетcat .env,secret getиenvдо запуска. - §6
Учёт
Журнал доступа хранит, кто, какое имя и когда прочитал:
agentилиhuman. Только имена.
Приложение в строке меню
Человеческая сторона протокола.
⌥⌘S из любого приложения, Spotlight, Siri и Команды. Карточка для каждого секрета с файлами .env, которые его используют. Приложение никогда не читает значение: помощник кладёт его в буфер обмена и очищает буфер через 30 секунд.
- Быстрый поиск: ↩ копирует ссылку, ⇧↩ значение
- + в строке меню: новый секрет, его ссылка уже в буфере обмена
- Активность: запуски агента и запросы Touch ID
- English, Deutsch, Français, Español, Italiano, Português, Polski, Русский
Модель угроз
Что он останавливает, а что нет.
| Угроза | Останавливает | Не останавливает |
|---|---|---|
| Значение в чате | Ввод в окне, генерация, маскированный вывод, хук. | Значение в собственной кодировке, например base64(user:pass). |
Значение в ps | Значения идут через stdin и файловые дескрипторы. | secret set NAME VALUE со значением в аргументе. |
| Процесс читает за вашей спиной | Ключ Secure Enclave работает только после Touch ID или Apple Watch, для любого процесса. | Чтение внутри льготного окна: 30 минут простоя, не более 8 часов. |
| Потеря Mac | secret export: AES-256, PBKDF2 с 600 000 итераций. | Забытый пароль резервной копии не восстановит никто. |
Вопросы
- Видит ли ИИ-агент значение секрета?
- Нет. Агент работает с именами. Значение попадает в окружение команды, которой оно нужно, а вывод возвращается с
***вместо значения. Хук для Claude Code останавливает команды, которые вывели бы значение. - Где хранятся секреты?
- В одном зашифрованном файле на вашем Mac. Ключи в Secure Enclave запечатывают каждое значение. Для чтения нужен Touch ID, Apple Watch или пароль Mac. В облако не уходит ничего.
- С какими ИИ-агентами он работает?
- С любым агентом, который запускает команды shell: Claude Code, Codex, Cursor, Aider и другими. Claude Code получает ещё хук и готовые правила для
CLAUDE.md. - Сколько это стоит?
- Нисколько. SecretBar — открытый код под лицензией MIT.
- Какая версия macOS нужна?
- macOS 14 или новее на Mac с Secure Enclave (Apple silicon или T2). Постквантовому хранилищу нужна macOS 26. Поиску по смыслу нужна macOS 27 с Apple Intelligence.
- Можно ли перенести секреты на новый Mac?
- Да.
secret exportпишет один файл, зашифрованный AES-256 и вашим паролем резервной копии.secret restoreчитает его на новом Mac.
Установка
Три строки — и подпись.
- Команда, оба помощника и автодополнение для zsh
$ brew install secretbar/tap/secretbar - Хранилище, затем первый секрет, введённый в окне
$ secret init && secret ask MY_TOKEN - Хук для Claude Code, правила для агента и приложение в строке меню
$ "$(brew --prefix secretbar)/libexec/install.sh" --claude-hook --app
macOS 14 или новее. Никаких зависимостей, кроме системных инструментов. Бесплатно и с открытым кодом, MIT.