2password CLI
Обертка над 1Password CLI: агент находит, использует и сохраняет секреты, не видя значений, и реже просит одобрения
- 305 ★ репозитория
- Последний коммит
Широкий доступ
Почему такой уровень
- Утилита открывает агенту доступ к хранилищам 1Password и позволяет создавать и обновлять записи
- Команды run и env run передают открытый секрет дочернему процессу, который способен его вывести
- Сервисный аккаунт работает без подтверждений, поэтому его хранилище стоит делать отдельным и небольшим
Установка
В терминале, через SkillFoxx CLI
npx skillfoxx add cli/2passwordОпределит агенты на машине, покажет уровень доступа и зафиксирует версию.
Другие способы установки
Доступ и проверки
Как мы проверяемШирокий доступИнструмент может менять данные, выполнять команды или работать с секретами.
- Утилита открывает агенту доступ к хранилищам 1Password и позволяет создавать и обновлять записи
- Команды run и env run передают открытый секрет дочернему процессу, который способен его вывести
- Сервисный аккаунт работает без подтверждений, поэтому его хранилище стоит делать отдельным и небольшим
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
2password — командная строка поверх 1Password CLI (op) для кодинг-агентов. Агент работает с секретами через ссылки вида op://Хранилище/Запись/поле и самих значений не видит. Весь вывод идет в JSON, а вместе с утилитой ставится скилл с правилами для агента: не печатать, не пересказывать и не логировать секреты. `2password find` ищет записи по нескольким запросам сразу и возвращает только ссылки op://. `2password env run` запускает программу с секретами из шаблона .env.tpl, и открытый текст на диск не попадает. `2password create api-credential` сохраняет новый ключ из буфера обмена или со стандартного ввода, затем перечитывает запись и проверяет ее. Отдельные команды наводят порядок в хранилище: обновляют пароль входа, перечисляют поля записей без значений и находят дубликаты и устаревшие логины. Пакетные запросы дают одно подтверждение 1Password на команду, а с сервисным аккаунтом, у которого свое хранилище для агента, подтверждения не нужны совсем.
Для кого. Разработчикам, которые держат ключи в 1Password и дают кодинг-агенту запускать команды проекта.
Подходит, если
- Агенту нужно запустить сервер разработки с ключами OpenAI и Stripe из 1Password, не показывая ему сами ключи
- В проекте лежит шаблон .env.tpl со ссылками op://, и его надо раскрывать при запуске без открытого текста на диске
- Надо сохранить в нужное хранилище новый API-ключ, который программа печатает или который лежит в буфере обмена
- Требуется провести аудит хранилища: найти дубликаты названий, непомеченные машинные учетные данные и старые логины
- Надоели подтверждения 1Password на каждую команду агента, и нужен отдельный сервисный аккаунт с его хранилищем
Не подходит, если
- Секреты хранятся не в 1Password: утилита оборачивает только его CLI
- Нужно выводить значения секрета агенту: для этого есть только две команды чтения, и они задуманы как крайняя мера
- Нужна полностью автоматическая работа без сервисного аккаунта: в обычном режиме каждая команда просит одно подтверждение
Пример запроса к агенту
Найди в 1Password ключ OpenAI и запусти `bun dev` с ним в окружении, значение мне и себе не показывайОграничения
Нужны Bun и 1Password CLI. Только команды `2password read` и `2password env resolve` намеренно возвращают или материализуют секрет. Команды `2password run` и `2password env run` значение не печатают, но передают его в окружение дочернего процесса, и тот способен его вывести. Применяйте их только для программ, которым доверяете этот ключ, и не запускайте с ними отладочные команды, печатающие окружение.
Запись нового ключа при сбое не повторяется автоматически: сначала проверьте поиском, не прошла ли она. Ключ нельзя передать аргументом командной строки, только через буфер обмена или стандартный ввод.
Как отключить. Удалите глобальный пакет командой `bun remove -g 2password` и скилл из папки скиллов вашего агента. Если настраивали сервисный аккаунт, отзовите его токен в 1Password и удалите сохраненный токен с машины.
Частые вопросы
Как поставить 2password для агента?
Установите утилиту командой `bun add -g 2password`, а скилл с правилами для агента командой `bunx skills add kitlangton/2password`. Все команды перечислит `2password --help`.
Как запустить программу с секретами из 1Password?
Одной командой `2password run --env "OPENAI_API_KEY=op://Personal/OpenAI API Key/credential" -- bun dev` либо через шаблон: `2password env run .env.tpl -- bun dev`.
Как сохранить новый ключ, чтобы агент его не увидел?
Командой `2password create api-credential --title "OpenAI API Key" --vault Personal --clipboard` или передав значение через канал с флагом --stdin. Флаг --vault обязателен. Запись с уже существующим названием утилита отклонит и ничего не перезапишет.
Как убрать всплывающие окна подтверждения 1Password?
Настройте сервисный аккаунт: `2password service-account setup --vault Automation --create-vault --write --save-vault Personal`. Токен хранится в связке ключей macOS или, на Windows, в файле, зашифрованном DPAPI. После этого команды проходят без запросов.
Что возвращает поиск и можно ли через него получить значение?
Для каждого совпадения поиск отдает ссылку op://, название и вид записи, значения никогда. Если запрос ничего не нашел, в ответе будут похожие названия, включая опечатки.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
CLI-инструментыMCP-сервер и CLI для реверс-инжиниринга: агент разбирает бинарные файлы, JavaScript-приложения, APK и сайты на вашей машине и приводит доказательства
Девять скиллов, через которые агент запускает пентест Strix, разбирает найденные уязвимости и встраивает проверку в CI
Роутер скиллов для авторизованного реверс-инжиниринга, пентеста, CTF и разбора угроз: подбирает методику под задачу и проверяет доступные инструменты
Скилл аудита безопасности кода от Cloudflare: агент проходит разведку, охоту по покрытию и независимую проверку находок и выдает структурированный отчет
Библиотека скиллов по кибербезопасности: форензика, реагирование на инциденты, пентест, облака и анализ вредоносов с привязкой к MITRE ATT&CK и NIST
Открытый стек NVIDIA для запуска OpenClaw, Hermes и LangChain Deep Agents в песочницах OpenShell с сетевыми политиками и управляемым инференсом
Сравнение с похожими
Записи с тем же главным запросом: чем они отличаются.
Коротко о README
README короткий: требования, две команды установки и примеры основных команд. Отдельный раздел о безопасности перечисляет все команды, которые вообще могут вернуть значение секрета.