veil CLI
Локальный приватный прокси для кодинг-агентов: подменяет имена, почты и секреты псевдонимами до отправки в модель
- 195 ★ репозитория
- Последний коммит
- Apache-2.0
Широкий доступ
Почему такой уровень
- Стоит на пути всего трафика агента к модели, хранит ключи и дает доступ к базам на чтение.
- Версия альфа: пределы защиты описаны, сбой прокси может раскрыть или исказить данные.
Установка
- Работает в
В терминале, через SkillFoxx CLI
npx skillfoxx add cli/veilОпределит агенты на машине, покажет уровень доступа и зафиксирует версию.
Другие способы установки
Доступ и проверки
Как мы проверяемШирокий доступИнструмент может менять данные, выполнять команды или работать с секретами.
- Стоит на пути всего трафика агента к модели, хранит ключи и дает доступ к базам на чтение.
- Версия альфа: пределы защиты описаны, сбой прокси может раскрыть или исказить данные.
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
veil стоит между агентом и провайдером модели на `127.0.0.1:8787`. Перед отправкой запроса он заменяет реальные имена, почты, телефоны, адреса, номера документов и секреты согласованными псевдонимами. Когда агент выполняет команду, обращается к базе или правит файл, veil возвращает реальные значения на место с корректным экранированием. Модель разбирает настоящую ошибку, но не видит данных людей. Команда `veil init ~/code/myapp --mcp` находит данные проекта, подключает Claude Code и добавляет инструмент `veil mcp-db`: базу, доступную только на чтение, к которой агент обращается по псевдонимам. Поддерживаются Claude Code, Codex CLI, Aider и DeepSeek Harness. Ключи хранятся в связке ключей ОС.
Для кого. Разработчикам, чьи агенты читают логи, дампы и базы с персональными данными и секретами.
Подходит, если
- В логах продакшена есть имена клиентов, а баг нужно разобрать с помощью агента.
- Агенту нужен доступ к базе, но модель не должна видеть настоящие записи.
- Секреты и номера карт из окружения не должны попадать к провайдеру модели.
- Команда ведет работу в Claude Code или Codex CLI и хочет единые правила приватности.
Не подходит, если
- Нужна гарантия, что данные никогда не покинут машину: это проект в стадии альфа с описанными пределами.
- Агент часто читает скриншоты: изображения проходят без сканирования.
- В данных нет ничего личного, а прокси добавит лишнюю точку отказа.
Пример запроса к агенту
Подключи veil к проекту, чтобы модель не видела реальных клиентов в логах и базе, и проверь это на одном запросе.Ограничения
veil находится в стадии альфа. Машина считается доверенной: хранилище, локальные транскрипты агента и телеметрия содержат настоящие значения. Агент с доступом к оболочке способен придумать преобразования, которых авторы не предусмотрели. Поиск по части псевдонима не найдет реальных данных. Значения короче 8 символов сопоставляются только дословно, свободный текст о третьих лицах требует необязательной модели NER (`veil-proxy[ner]`). Облачные провайдеры (Bedrock, Vertex, Microsoft Foundry) проверены на имитаторах, проверки на живых аккаунтах пока нет. Скриншоты не сканируются.
Как отключить. Остановите службу командой `brew services stop veil`, верните адрес провайдера в настройках агента, удалите пакет `pip uninstall veil-proxy` и записи MCP из Claude Code.
Частые вопросы
Как поставить veil?
Выполните `pip install veil-proxy`. Есть вариант `brew install lemonadesaltbagel/veil/veil` и установка из исходников через `uv sync`.
Как подключить базу данных?
Команда `veil init --mcp` регистрирует инструмент `veil mcp-db`. Вручную: `claude mcp add veil-db --scope local -- veil mcp-db --source N`, номер берут из `veil sources`.
Где хранятся ключи?
В связке ключей ОС: macOS Keychain, Linux Secret Service или Windows Credential Manager. Для CI есть `VEIL_VAULT_KEY` и `VEIL_TOKEN_SECRET`.
Какие клиенты поддерживаются?
Claude Code, Codex CLI, Aider и DeepSeek Harness.
Видит ли провайдер реальные значения?
По описанию нет: имена, почты, номера и секреты заменяются псевдонимами до выхода запроса. Скриншоты и другие пределы защиты оговорены в разделе Limitations.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
CLI-инструментыЛокальный прокси заменяет секреты и личные данные в запросах агентов до отправки провайдеру и возвращает их в ответе
Vigils стоит между ИИ-агентом и его инструментами: скрывает секреты, спрашивает разрешения и пишет неизменяемый журнал вызовов
Vahta дает агенту использовать ваши пароли и API-ключи через зашифрованное хранилище, не показывая сами значения
Утилита хранит ключи в системной связке и подставляет их в запрос на транспортном уровне, так что агент значения не видит.
Хук безопасности для кодинг-агентов: оценка опасности каждого вызова с контекстом сессии, поиск инъекций в ответах и скиллах
Локальная панель для Claude Code, Codex CLI и OpenCode: что грузит агент, сколько это токенов, и проверка MCP-серверов
Коротко о README
Проект на Python работает как локальный прокси с хранилищем и MCP-инструментом для чтения баз. Есть сквозные тесты с реальным Claude Code, результаты приведены в разделе `Prove it yourself`.