Ваші секрети живуть у ключовому сховищі ОС,
а не в підказці й не у вашому репозиторії
AgentsRoom зберігає API-ключі, токени та паролі до баз даних у локальному сейфі на вашій машині, зашифрованому через ключове сховище операційної системи. Ви посилаєтеся на них за іменем, а додаток підставляє значення, коли стартує команда або агент.
Досить вставляти токен у підказку лише тому, що це найшвидший спосіб розблокувати агента. Назвіть секрет один раз, далі всюди використовуйте {{secret:NAME}}, а значення нехай залишається там, де йому місце.
Як AgentsRoom робить секрет придатним для ваших команд і нечитабельним для агента, який його запитує.
У кожному проєкті зрештою з'являється кілька значень, які не можна нікому показувати: платіжний ключ, пароль до бази даних, токен для деплою, API-ключ для тестового середовища. Щойно в гру вступають AI-агенти для кодування, ці значення починають рухатися найгіршим із можливих способів. Їх вставляють у підказку, щоб розблокувати агента, зашивають у скрипт, який агент щойно написав, або кладуть у файл, який за три коміти потрапляє в репозиторій.
Менеджер секретів AgentsRoom дає їм одне місце для життя. Секрет: це ім'я та значення. Ви додаєте його один раз, і AgentsRoom шифрує його через ключове сховище операційної системи ще до того, як воно торкнеться диска. Увесь сейф: це один файл у вашій домашній теці, записаний із правами доступу лише для власника, і він ніколи не залишає машину, на якій був створений.
Далі ви більше ніколи не маєте справи зі значенням. Ви пишете {{secret:NAME}} у команді розробки або в середовищі агента, а AgentsRoom підставляє справжнє значення, коли ця команда чи цей агент стартує. Ваші агенти можуть перелічити імена й попросити підставити потрібне: цього досить для їхньої роботи, і самого значення вони не отримують.
Сейф, створений для машини, повної AI-агентів
Зашифровано операційною системою, згадується за іменем, підставляється в останній можливий момент.
Зашифровано ключовим сховищем вашої ОС
Кожне значення шифрується через Electron safeStorage: ключ шифрування тримає ключове сховище вашої операційної системи, а не AgentsRoom. Додаток зберігає шифротекст і просить систему його розшифрувати, точно так само, як інші програми, яким ви вже довіряєте свої облікові дані.
Один файл сейфа, лише для власника
Усі ваші секрети живуть в одному сейфі за шляхом ~/.agentsroom/secrets.json, записаному з правами доступу лише для власника (0600) і замінюваному атомарно за кожної зміни. Жодного напівзаписаного файлу після збою і жодного іншого облікового запису на машині, який зміг би його відкрити.
Посилання за іменем, ніколи за значенням
Збережений секрет використовується як {{secret:NAME}}: у командному рядку термінала розробки, у середовищі, яке отримує агент, будь-де, де ви інакше ввели б облікові дані. На екрані ви читаєте ім'я, і саме його можна показати колезі.
Підстановка під час запуску, у головному процесі
Підстановка відбувається в момент старту процесу, всередині головного процесу Electron. Отримане значення потрапляє в середовище команди, яку запускають, і більше нікуди: ні в журнал, ні в інтерфейс, ні у файл на диску.
Агенти бачать імена, а не значення
AI-агент може перелічити імена ваших секретів і попросити підставити потрібний у те, що він збирається запустити. Немає жодного шляху в коді, який повертав би значення агенту, шару інтерфейсу чи через MCP. Агент працює з посиланням, додаток працює із секретом.
Немає ключового сховища, немає збереження
Якщо машина не може запропонувати робоче ключове сховище ОС, AgentsRoom відмовляється зберігати секрет, замість того щоб відкотитися до відкритого тексту. Сейф, який тихо вироджується у звичайний файл, гірший за відсутність сейфа, тож такого відкату просто не існує.
Локальність на рівні задуму, а не налаштування за замовчуванням
Ваші секрети ніколи не надсилаються на сервери AgentsRoom. Немає перемикача синхронізації, який треба перевірити, немає хмарного сейфа, від якого треба відмовлятися, і немає резервної копії ваших ключів ніде, крім вашого власного диска. Сейф створюється на машині, шифрується ключем, який ключове сховище операційної системи тримає саме для цієї машини, і там і залишається. Сама лише копія файлу нічого не дасть: інша машина її не відкриє.
Розділення між використанням секрету і читанням секрету забезпечене кодом, а не вказівкою, написаною в підказці. Шар інтерфейсу, інструменти MCP і кожен агент говорять про секрети за іменем. Лише головний процес Electron перетворює посилання на значення, і тільки поки будує середовище процесу, який ви попросили запустити. Просити агента бути обережним з обліковими даними: це надія. Не мати функції, яка повертає облікові дані: це гарантія.
Саме тому розумно дозволити агенту працювати з платним API або справжньою базою даних. Агент знає, що існує секрет на ім'я STRIPE_SECRET_KEY, і може попросити підставити його в команду, яку хоче запустити. Він не може його вивести на екран, не може скопіювати у файл, який пише, і не може злити його в розмову, збережену десь ще.
Від вставленого токена до іменованого секрету
Три кроки, і значення більше ніколи не з'являється.
Додайте секрет один раз
Дайте йому ім'я і востаннє вставте значення. AgentsRoom шифрує його через ключове сховище ОС і записує в сейф за шляхом ~/.agentsroom/secrets.json, лише для власника та атомарно. Якщо на машині немає придатного ключового сховища, додаток про це скаже і відмовиться, замість того щоб записати відкритий текст.
Посилайтеся на нього як {{secret:NAME}}
Використовуйте посилання там, де раніше було значення: у команді, яка запускає ваш сервер розробки, або в середовищі агента, якому потрібен API-токен. У ваших налаштуваннях зберігається посилання, і на нього безпечно дивитися.
Нехай AgentsRoom підставить його під час запуску
Коли команда або агент стартує, головний процес міняє посилання на справжнє значення в середовищі цього процесу. Ваш інструментарій отримує те, що йому потрібно, а агент, який ним керує, як і раніше знав тільки ім'я.
Коли менеджер секретів перестає бути опційним
Ситуації, у яких вставлені облікові дані перетворюються на справжній інцидент.
Сервери розробки, яким потрібні справжні ключі
Ваш сервер розробки не стартує без платіжного ключа і пароля до бази даних. Поставте {{secret:NAME}} у команду запуску замість облікових даних, і цю команду можна спокійно лишати на екрані під час дзвінка, без миті паніки.
Агенти, які звертаються до платного API
Агенту потрібен токен, щоб під час роботи достукатися до стороннього API. Додайте секрет у його середовище за іменем: агент отримує робоче середовище, а токена немає ні в підказці, ні в розмові, ні в тому, що агент напише далі.
Ключі, які більше не потрапляють у репозиторій
Звична аварія: облікові дані, записані в конфігураційний файл, який згрібає наступний коміт. Посилання на секрети за іменем означає, що у файлі під контролем версій лежить ім'я, тож при відправленні гілки витікати нічому.
Одна машина, багато проєктів
Один сейф, захищений ключовим сховищем вашої ОС і доступний лише вашому обліковому запису, обслуговує кожен проєкт, який ви відкриваєте. Кожен проєкт посилається на потрібні йому імена, і жоден не тримає власної розкиданої копії облікових даних.
Як агент може використати секрет, якого не може прочитати?
Тому що використати облікові дані і прочитати облікові дані: це дві різні операції, і для агентів AgentsRoom реалізує лише першу. Сейф відкритий через MCP рівно одним інструментом, secrets_list, і він повертає імена. Далі агент пише {{secret:NAME}} у команді або в середовищі, яке йому потрібне, а підстановку виконує додаток, а не агент.
Свідомо бракує зворотного напрямку. Жоден інструмент MCP не повертає значення секрету, шар інтерфейсу ніколи його не отримує, і ніщо не показує його назад у розмові. Перетворення посилання на справжнє значення відбувається всередині головного процесу Electron, у момент запуску процесу, і результат потрапляє в середовище цього процесу і більше нікуди.
На практиці це означає, що агент може прогнати ваші тести на справжній базі даних, звернутися до платного API або задеплоїти на тестове середовище, і жодні облікові дані не потраплять у його контекст. Нічого не треба потім вимарювати, бо ніщо ніколи не було відкрите.
Відкрийте для себе AgentsRoom MCPЧасті запитання
Де зберігаються мої секрети?
В одному файлі сейфа за шляхом ~/.agentsroom/secrets.json у вашій домашній теці. Кожне значення шифрується через Electron safeStorage, тож ключ шифрування тримає ключове сховище вашої операційної системи. Файл записується з правами доступу лише для власника (0600) і замінюється атомарно, тож збій ніколи не лишає його напівзаписаним.
Чи може мій AI-агент прочитати мої секрети?
Ні. Агент може перелічити імена ваших секретів і попросити підставити потрібний у команду або середовище: цього йому досить, щоб виконати роботу. Немає жодного шляху в коді, який повертав би значення агенту, шару інтерфейсу чи через MCP. Підстановка відбувається лише в головному процесі Electron.
Чи синхронізуються мої секрети із серверами AgentsRoom?
Ніколи. Сейф за задумом локальний для машини. Секрети не надсилаються на сервери AgentsRoom, не зберігаються в хмарних резервних копіях і не передаються в мобільний додаток. Вони створені на вашій машині, зашифровані для вашої машини і там і залишаються.
Як використати секрет у команді?
Напишіть {{secret:NAME}} там, де мало бути значення: у команді термінала розробки або в середовищі агента. AgentsRoom підставляє справжнє значення, коли цей процес запускається, а в налаштуваннях лишається саме посилання.
Що станеться, якщо на моїй машині немає ключового сховища ОС?
AgentsRoom відмовиться зберігати секрет. Свідомо немає жодного запасного шляху, який записав би значення відкритим текстом на диск, бо сейф, що тихо вироджується у звичайний файл, дає впевненість у шифруванні без самого шифрування.
Чи замінює це файли середовища в моєму проєкті?
Це розв'язує ту частину проблеми, яка болить, щойно з'являються AI-агенти: тримати облікові дані поза файлами, підказками і розмовами. Ваш проєкт лишає собі все, що йому потрібно під час виконання, а саме значення живе в сейфі й підставляється під час запуску, замість того щоб лежати у файлі, який агент може прочитати, а коміт може згребти із собою.
Якщо хтось скопіює файл сейфа, чи зможе він його прочитати?
Не на іншій машині. Значення зашифровані ключем, який тримає ключове сховище вашої операційної системи, тож сам по собі файл: це шифротекст. До того ж сейф записаний із правами доступу лише для власника, тож інший обліковий запис на тій самій машині теж не зможе його відкрити.
Який інструмент MCP мої агенти використовують для секретів?
secrets_list, і він єдиний. Він повертає імена секретів, збережених на цій машині, тож агент може дізнатися, що існує, і потім послатися на потрібний як {{secret:NAME}} у команді розробки або в середовищі процесу, який він запускає. Жоден інструмент не повертає значення, тож агенту нічого виводити на екран, копіювати у файл, який він пише, чи зливати в розмову. Коли потрібного йому секрету бракує, він просить вас додати його в додатку, а не вставити в чат.
Вам також може сподобатися
З'єднання з базами даних
Зберігайте свої з'єднання з MySQL і MariaDB, діставайтеся бази даних у приватній підмережі через SSH-тунель або сесію AWS SSM і дозвольте своїм AI-агентам надсилати до неї запити через MCP. Лише для читання за замовчуванням, одна інструкція на виклик, обмежені набори результатів, і пароль ніколи не потрапляє до агента.
SSH-з'єднання
Зберігайте ваші SSH-з'єднання, відкривайте вбудований термінал через SSH і запускайте Claude Code, Codex або Antigravity CLI безпосередньо на вашому віддаленому сервері або VPS. Аутентифікація за ключем SSH або паролем, профілі з'єднань для кожного проєкту, окремий SSH-клієнт не потрібен.
Термінали для розробки
Менеджер терміналів і запуск процесів для кожного проєкту. Запускайте бекенд, фронтенд і воркери одним кліком, із секретами, що підставляються під час запуску, а не вводяться вручну.
AgentsRoom MCP
MCP-сервер, який дозволяє вашим агентам керувати самим AgentsRoom: проєктами, терміналами, беклогом і з'єднаннями, з усіма запобіжниками, що йдуть у комплекті.
Дайте агентам доступ, а не ваші ключі
Завантажте AgentsRoom, перенесіть свої API-ключі та паролі в сейф, зашифрований ключовим сховищем вашої ОС, і всюди посилайтеся на них за іменем.
Додаток-компаньйон: контролюйте своїх агентів на ходу
Використовуйте свого: Claude, Codex, Antigravity CLI або іншого AI-провайдера.
Надсилайте баги та запити прямо у свій публічний беклог.
Погляд на AgentsRoom в дії.