Vigils CLI
Vigils стоит между ИИ-агентом и его инструментами: скрывает секреты, спрашивает разрешения и пишет неизменяемый журнал вызовов
- 74 ★ репозитория
- Последний коммит
- Apache-2.0
Широкий доступ
Почему такой уровень
- Меняет настройки Claude Code, Codex, Cursor и других агентов: ставит хуки и переписывает запуск stdio-серверов MCP через шлюз
- Через шлюз проходят все вызовы инструментов и их результаты, а ключи и подсказки видит локальный процесс
- Опционально ставит прокси к API моделей и расширение браузера, которое читает вводимый текст на сайтах ИИ
Установка
- Работает в
Ручная установка
curl -fsSL https://vigils.ai/install.sh | shСтавит CLI vigil-hub в ~/.local/bin без правки настроек агентов. Для Windows есть irm https://vigils.ai/install.ps1 | iex. Скрипт стоит прочитать до запуска.
Доступ и проверки
Как мы проверяемШирокий доступИнструмент может менять данные, выполнять команды или работать с секретами.
- Меняет настройки Claude Code, Codex, Cursor и других агентов: ставит хуки и переписывает запуск stdio-серверов MCP через шлюз
- Через шлюз проходят все вызовы инструментов и их результаты, а ключи и подсказки видит локальный процесс
- Опционально ставит прокси к API моделей и расширение браузера, которое читает вводимый текст на сайтах ИИ
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Vigils работает локально и ничего не отправляет наружу. Шлюз `vigil-hub` проксирует MCP-серверы по stdio и HTTP и пропускает каждый вызов через цепочку: скрытие секретов, межсетевой экран, подтверждение, песочница, журнал. Экран по умолчанию запрещает все, что не разрешено правилом на встроенном языке политик. Каждый вызов инструмента записывается в журнал SQLite с цепочкой хешей SHA-256, и подмену записи видно при проверке. Опасные действия, такие как запись файлов, сетевые запросы и удаление, ждут решения человека в очереди подтверждений с разрешениями на один раз или на сессию. Движок скрытия находит больше 17 классов секретов и персональных данных, включая токены GitHub, ключи Stripe и строки подключения к базам, и заменяет их до того, как текст дойдет до модели, журнала или экрана. Команда `vigil-hub setup --all` ставит хуки перед запуском инструментов в Claude Code, Codex CLI, Gemini CLI и Cursor и перенаправляет stdio-серверы MCP еще у десятка агентов через шлюз. По умолчанию действует режим наблюдения: серверы работают как раньше, а блокировка сырого секрета, очистка результатов и журнал включены. Для запрета по умолчанию добавляют `--enforce`. Есть настольное приложение на Tauri и расширение Chrome, которое скрывает секреты перед вставкой в ChatGPT, Claude, Gemini и Perplexity.
Для кого. Разработчикам, которые разрешают агентам запускать команды и MCP-серверы и хотят видеть и ограничивать, что агент делает с файлами, сетью и ключами.
Подходит, если
- В окружении лежат токены GitHub и ключи облака, и хочется, чтобы агент не мог унести их в запрос к модели
- Нужен журнал вызовов агента, в котором подмену записи заметит проверка цепочки хешей
- Удаление и запись файлов должны ждать вашего подтверждения и не выполняться молча
- Подключено несколько MCP-серверов, и важно заметить момент, когда у инструмента меняется описание
Не подходит, если
- Нужна защита на уровне сети или контейнера для всей машины: Vigils работает с событиями агентов и MCP-серверов
- На машине нельзя запускать фоновые процессы и править настройки агентов
- Вы ждете замены антивируса: полная защита от инъекций промпта проект не обещает
Пример запроса к агенту
Поставь Vigils, запусти `vigil-hub demo` и покажи, как секрет заменяется на заглушку, потом подключи защиту к Claude Code в режиме наблюденияОграничения
- Ранние релизы не подписаны сертификатом ОС, система может показать предупреждение при первом запуске. Для проверки у каждого файла есть SHA-256 и подтверждение сборки.
- Codex пропускает сторонние хуки, пока вы не одобрите их командой `/hooks`, до этого Vigils показывает агента как ожидающего доверия.
- Движок ML скачивает от 0,8 до 1,5 ГБ моделей при первом запуске и на Mac работает только на Apple Silicon. Версия по умолчанию использует правила без моделей.
- Песочница Wasm в выпущенных сборках отключена, на Linux изоляция идет через Landlock.
Как отключить. Выполните `vigil-hub setup --all --uninstall`: команда убирает только записи Vigils и возвращает настройки агентов в прежний вид. В настольном приложении то же делает кнопка отката. Бинарники лежат в `~/.local/bin` или `%LOCALAPPDATA%\Vigils\bin`, их можно удалить вручную.
Частые вопросы
Как поставить Vigils?
Установите CLI командой `curl -fsSL https://vigils.ai/install.sh | sh` на macOS и Linux или `irm https://vigils.ai/install.ps1 | iex` в PowerShell. Скрипт только кладет бинарники, настройки агентов не меняет. Защиту включает `vigil-hub setup --all`.
Какие агенты защищает Vigils?
Хуки перед запуском инструментов ставятся в Claude Code, Codex CLI, Gemini CLI и Cursor. Серверы MCP через шлюз проходят у этих агентов и у Windsurf, Kimi CLI, ZCode, pi, Grok CLI, OpenCode, CodeBuddy и Cline.
Уходят ли мои данные в облако?
Нет, подсказки, секреты и журнал остаются на машине. Обращение в сеть нужно только для установки и для загрузки моделей скрытия в ML-режиме, скачанные файлы проверяются по SHA-256.
Чем режим наблюдения отличается от `--enforce`?
В режиме наблюдения серверы работают как раньше, а блокировка сырых секретов, очистка результатов и журнал включены. Флаг `--enforce` добавляет запрет по умолчанию для вызовов, которых нет в правилах.
Можно ли проверить, что Vigils поймал?
Да: `vigil-hub inspect protection` показывает заблокированные секреты, очищенные утечки и состояние цепочки хешей, а `vigil-hub demo --tamper` наглядно показывает, как проверка находит подмену журнала.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
CLI-инструментыХук безопасности для кодинг-агентов: оценка опасности каждого вызова с контекстом сессии, поиск инъекций в ответах и скиллах
MCP-сервер памяти для агентов и бесплатный шлюз, который останавливает опасные команды до запуска
Clawvisor ставит шлюз между агентом и API: агент заявляет задачу, человек одобряет объем, ключи подставляет шлюз и ведет журнал.
Плагин и сервер подтверждений для Claude Code и Codex: опасный вызов инструмента ждет вашего решения до запуска
AgentShield проверяет папку .claude на ключи в открытом виде, широкие разрешения, опасные хуки и небезопасные MCP-серверы и ставит оценку от A до F
Vahta дает агенту использовать ваши пароли и API-ключи через зашифрованное хранилище, не показывая сами значения
Сравнение с похожими
Карточки с тем же главным запросом: чем они отличаются.
| Инструмент | Официальный | Звезды репозитория | Главное отличие |
|---|---|---|---|
| Vigils (эта карточка) | нет | 74 | |
| HOL Guard | да | 1 094 | хуки на команды агента и проверка пакетов, без шлюза MCP с очисткой результатов и расширения браузера |
| Destructive Command Guard | нет | 6 349 | блокирует опасные команды оболочки, секреты и MCP не охватывает |
Коротко о README
Страница проекта подает Vigils как локальную панель управления для ИИ-агентов с четырьмя гарантиями: видеть действия, одобрять опасное, не пускать секреты в подсказки и журналы, изолировать выполнение. Дальше перечислены возможности: журнал, экран, подтверждения, скрытие секретов, шлюз MCP, настольное приложение и расширение. Раздел установки сравнивает сборки с правилами и ML-движком, объясняет проверку загрузок. Быстрый старт ведет от установки к демонстрации за минуту и команде setup.