
Держите приватные данные, внутреннюю инфраструктуру и секреты вне облачных агентов для программирования, не нарушая свой рабочий процесс.
Держите приватные данные, внутреннюю инфраструктуру и секреты вне облачных кодирующих агентов, не нарушая свой рабочий процесс.
Установка · Быстрый старт · Политики · Мониторинг · Pi / OMP · Безопасность
Cover — это двунаправленный прокси для обеспечения приватности AI-агентов, пишущих код. Он локально заменяет совпавшие конфиденциальные значения на реалистичные детерминированные подстановки до того, как запрос покинет вашу машину, а затем переводит соответствующие подделки в обычных и потоковых ответах обратно в оригиналы. Модель получает связный контекст; ваш агент и инструменты продолжают работать с реальным окружением.
Используйте обратимые правила pseudonymize или placeholder, когда диалог должен продолжать работать от начала до конца. Используйте односторонние правила mask или redact, когда восстановление не требуется, block — чтобы остановить запрос локально, и allow — для явного исключения.
Поддерживаемые клиенты включают Codex, Claude Code, Cursor, Pi / Oh My Pi, а также SDK и роутеры, совместимые с OpenAI или Anthropic.
Установщик скачивает релиз для вашей ОС и процессора, проверяет его по
опубликованным контрольным суммам SHA-256, атомарно устанавливает его в
~/.local/bin/cover, настраивает выбранные клиенты и запускает прокси.
curl -fsSL https://raw.githubusercontent.com/DavidCarliez/cover/main/scripts/install.sh | bash
Go-инструментарий или Git-репозиторий не требуются. Вам нужны только curl, архиватор
(tar в Linux/macOS или unzip в Windows) и sha256sum,
shasum или openssl для проверки.
Готовые архивы для Linux, macOS и Windows и их контрольные суммы доступны на GitHub Releases.
Для неинтерактивной установки:
curl -fsSL https://raw.githubusercontent.com/DavidCarliez/cover/main/scripts/install.sh | \
COVER_AGENTS=openai,claude bash
Закрепите релиз или установите только бинарный файл с переменными окружения, применёнными к процессу bash:
curl -fsSL https://raw.githubusercontent.com/DavidCarliez/cover/main/scripts/install.sh | \
COVER_VERSION=v0.1.0 COVER_SKIP_SETUP=1 bash
git clone https://github.com/DavidCarliez/cover.git
cd cover
go build -o cover ./cmd/cover
install -m 0755 cover ~/.local/bin/cover
Основной бинарный файл не имеет зависимости от cgo. Стандартная кросс-компиляция Go работает:
GOOS=linux GOARCH=arm64 go build -o cover-linux-arm64 ./cmd/cover
GOOS=windows GOARCH=amd64 go build -o cover.exe ./cmd/cover
| Область | Функциональность |
|---|---|
| Политики | Декларативные правила с действиями allow, placeholder, pseudonymize, mask, redact и block |
| Реалистичные замены | Детерминированные генераторы для IP-адресов, хостов, доменов, email, имён пользователей, паролей, UUID, URL, псевдонимов, числовых идентификаторов, IBAN и телефонных номеров |
| Контекстно-зависимые правила | Ключи JSON внутри строк результатов инструментов, HTTP-заголовки, cookie, параметры запросов и поля форм, а также регулярные выражения и встроенные детекторы |
| Стабильные идентификаторы | HMAC-псевдонимы, привязанные к ключу установки, остаются согласованными между запросами, сессиями и перезапусками |
| Безопасность сопоставлений | Ограниченные, изолированные по сессиям, хранящиеся только в памяти обратимые сопоставления с TTL и ограничениями по объёму |
| Инспекция | cover inspect показывает защищённый JSON без обращения к LLM |
| Диагностика | cover doctor проверяет политику, работоспособность демона, локальное поведение fail-closed и маршрутизацию Codex |
| Мониторинг | Представления аудита и мониторинга только с метаданными, а также явная инспекция перехваченного и пересланного содержимого только в реальном времени |
| Усиление прокси | Слушатели по умолчанию на loopback, ограничения на тело и поток, обобщённые безопасные ошибки и fail-closed парсинг |
| Совместимость со стримингом | Восстановление OpenAI Responses, Chat Completions и Anthropic SSE через delta-события, heartbeat и чередующиеся каналы; JSON-безопасные аргументы инструментов |
| Совместимость с Codex | API Responses и конфигурация маршрутизатора, проверки сжатия и неизменяемые поля encrypted_content |
| Опциональный семантический проход | Локальный детектор llama.cpp может проверять свободный текст, который пропускают регулярные выражения |
cover init # write ~/.config/cover/config.yaml
cover start --detach # run in the background
cover doctor # verify the local setup
cover test # local redaction round trip, no network call
cover monitor # watch privacy-safe request metadata
cover init запрашивает OpenAI, Anthropic или пользовательский upstream. Полная
конфигурация описана в configs/config.example.yaml.
| Команда | Назначение |
|---|---|
cover install | Настроить клиентов, экспорт оболочки и фоновый прокси |
cover init | Создать файл конфигурации |
cover start [--detach] | Запустить Cover на переднем плане или в фоне |
cover stop | Остановить фоновый процесс |
cover restart | Перезапустить его в фоне |
cover status [--json] | Показать статус процесса, слушателя и отредактированного upstream |
cover version [--json] | Показать версию сборки, коммит и дату |
cover update [--version vX.Y.Z] | Установить проверенный релиз GitHub; перезапустить и проверить работоспособность, если запущен (Linux/macOS) |
cover update --rollback | Восстановить предыдущий бинарный файл, сохранив конфигурацию |
cover env | Вывести экспорт оболочки для настроенных клиентов |
cover test | Запустить синтетическую локальную проверку редактирования и восстановления |
cover inspect request.json | Предварительно показать, что именно Cover будет пересылать |
cover doctor [--json] | Запустить проверки конфигурации, приватности, демона и маршрутизации |
cover monitor | Показать недавние безопасные метаданные и отслеживать новые события |
cover monitor --show-content | Показать одну пару чувствительный оригинал → замена на строку; добавьте --json для полных событий |
cover models pull | Загрузить дополнительную среду выполнения и модель локального детектора |
cover models status | Сообщить об установке и конфигурации локального детектора |
cover completion | Сгенерировать скрипты автодополнения оболочки |