Secret
GitHub ↗

Протокол для секретов и ИИ-агентов · macOS

Ваш агент знает имя.
Но не значение.

SecretBar — команда и приложение в строке меню для Mac. Пароли, токены и API-ключи остаются в Secure Enclave. Агент просит по имени, человек подтверждает, процесс получает значение, а вывод возвращается с вымаранными значениями.

$ brew install secretbar/tap/secretbar
Читать протокол ↓
Стенограммасессия агента · shop · 14 нояб. 2026

agent › Мне нужен пароль от базы данных магазина.

$ 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. Агент видит имена и комментарии. Значения — никогда.
  2. Touch ID на вашем Mac. Значение попадает в окружение psql и больше никуда.
  3. Вывод возвращается замаскированным. Также в base64 и URL-кодировке.

Протокол

Шесть правил, по которым живёт значение.

Каждая функция SecretBar обеспечивает одно из них. Ни одно не зависит от того, хорошо ли ведёт себя агент.

  1. §1

    Ввод

    Человек вводит значение в скрытое окно macOS: secret ask NAME. Чат его не видит. secret gen создаёт случайное значение, которого не видит никто.

  2. §2

    Хранение

    Ключи в Secure Enclave запечатывают каждое значение: P-256 и постквантовый ML-KEM-768. Весь файл зашифрован ещё раз. В облако не уходит ничего.

  3. §3

    Доступ

    Каждое чтение требует Touch ID или Apple Watch. Льготное окно скользит 30 минут и закрывается при блокировке экрана. Аренда даёт агенту названные секреты до 24 часов после одного Touch ID.

  4. §4

    Использование

    secret run кладёт значение в окружение одного процесса. Не в argv, не в файл и не в чат. Файл .env хранит ссылки: secret:NAME.

  5. §5

    Вывод

    Каждое значение в stdout и stderr возвращается как ***, также в base64 и URL-кодировке. Хук для Claude Code останавливает cat .env, secret get и env до запуска.

  6. §6

    Учёт

    Журнал доступа хранит, кто, какое имя и когда прочитал: agent или human. Только имена.

Приложение в строке меню

Человеческая сторона протокола.

Главное окно SecretBar со списком секретов и карточкой SHOP_DB_PASSWORD
Рис. 1 — SecretBar. Демонстрационные данные.

⌥⌘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 часов.
Потеря Macsecret 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.

Установка

Три строки — и подпись.

  1. Команда, оба помощника и автодополнение для zsh
    $ brew install secretbar/tap/secretbar
  2. Хранилище, затем первый секрет, введённый в окне
    $ secret init && secret ask MY_TOKEN
  3. Хук для Claude Code, правила для агента и приложение в строке меню
    $ "$(brew --prefix secretbar)/libexec/install.sh" --claude-hook --app
Touch ID

macOS 14 или новее. Никаких зависимостей, кроме системных инструментов. Бесплатно и с открытым кодом, MIT.