AgentSecrets CLI
Утилита хранит ключи в системной связке и подставляет их в запрос на транспортном уровне, так что агент значения не видит.
- 197 ★ репозитория
- Последний коммит
- MIT
Широкий доступ
Почему такой уровень
- Утилита хранит реальные ключи API и подставляет их в запросы к внешним сервисам от имени агента.
- Прокси с неверным списком доменов отправит ключ не туда.
Установка
- Работает в
Ручная установка
brew install The-17/tap/agentsecretsПервый вариант README для macOS и Linux. Другие: npm, pip и `go install`.
Доступ и проверки
Как мы проверяемШирокий доступИнструмент может менять данные, выполнять команды или работать с секретами.
- Утилита хранит реальные ключи API и подставляет их в запросы к внешним сервисам от имени агента.
- Прокси с неверным списком доменов отправит ключ не туда.
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Агент указывает только имя ключа, например `agentsecrets call --bearer GITHUB_TOKEN`. Прокси достает значение вне агента, подставляет его в запрос и возвращает только ответ API, а значение не попадает в контекст, логи и трассы модели. Есть шесть способов подстановки: bearer, заголовок, параметр запроса, basic, поле JSON и поле формы. Шифрование идет на клиенте (X25519, AES-256-GCM, Argon2id), сервер хранит шифртекст. Домены разрешаются списком через `agentsecrets workspace allowlist add`, а журнал аудита связан хэш-цепочкой SHA-256 без поля значения. `agentsecrets mcp install` подключает MCP для Claude Desktop и Cursor.
Для кого. Командам, чьи агенты ходят во внешние API с реальными ключами и которым нужно, чтобы ключ не попал в промпт или лог.
Подходит, если
- Агент дергает Stripe или GitHub, и токен нельзя показывать модели.
- Среды dev, staging и prod переключают одной командой, не пересылая ключи в открытом виде.
- Для каждого агента нужны отдельные права: разрешенные домены и методы.
- Нужно видеть, кто и когда вызывал API, без записи самих значений.
Не подходит, если
- Проект целиком локальный, внешних API нет.
- Нужен менеджер паролей для людей, а не прокси для агентов.
- Агенту надо отдавать значение ключа в код, а не подставлять в запрос.
Пример запроса к агенту
Вызови баланс Stripe через AgentSecrets по ключу STRIPE_KEY и покажи только ответ, без значения ключа.Ограничения
Прокси подставляет ключи только для разрешенных доменов, поэтому каждый домен вносят в список вручную. SDK для JS и TypeScript заявлен как будущий, Python SDK есть. У клиентов нет метода `get()`: значение ключа получить нельзя, и это задумано. После обновления может понадобиться `agentsecrets doctor`, он чинит регистрацию бинарника и демона связки. Облачная синхронизация команды использует собственный сервер проекта.
Как отключить. Выполните `agentsecrets proxy stop`, затем `brew uninstall agentsecrets` или `npm uninstall -g @the-17/agentsecrets`. Записи MCP и ключи в системной связке удалите отдельно.
Частые вопросы
Как поставить?
Через Homebrew `brew install The-17/tap/agentsecrets`, npm `npm install -g @the-17/agentsecrets`, pip `pip install agentsecrets-cli` или `go install`, с фиксированной версией для безопасности цепочки поставок.
Как подключить к Claude Desktop или Cursor?
Выполните `agentsecrets mcp install`. Для остальных агентов запустите `agentsecrets proxy start` и направьте HTTP-клиент на прокси.
Что делать, если после обновления не работает связка?
Запустите `agentsecrets doctor`: команда проверит цепочку доверия, состояние демона и исправит расхождения регистрации.
Что хранит сервер?
Только шифртекст. Расшифровать его сервер не может, потому что шифрование выполняется на клиенте.
Какие способы подстановки поддерживаются?
Шесть: bearer, заголовок, параметр запроса, basic, поле JSON и поле формы. Выбор задают флагом вызова, например `--bearer`.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
CLI-инструментыagent-secrets выдает ИИ-агенту ключи на время: шифрование age, аренда секрета с TTL, журнал доступа и аварийный отзыв.
Vahta дает агенту использовать ваши пароли и API-ключи через зашифрованное хранилище, не показывая сами значения
Mac-хранилище ключей для агентов: Sallyport выполняет HTTP и SSH с вашими ключами по MCP, а сам ключ агент не получает
Vigils стоит между ИИ-агентом и его инструментами: скрывает секреты, спрашивает разрешения и пишет неизменяемый журнал вызовов
AgentGuard проверяет действия кодинг-агента до запуска и сканирует чужие скиллы на секреты, бэкдоры и промпт-инъекции.
CLI на Go запускает агента в песочнице ОС: скиллы и секреты доступны через мост, а файлы и сеть изолированы.
Коротко о README
Проект сочетает хранилище, прокси и журнал аудита и держит модель, где значение ключа отсутствует в каждом месте, где его могли бы украсть. Подсистема Keychain-Auth привязывает доступ к хэшу вызывающего бинарника.