Документация и быстрый старт

Каждая команда ниже реальная и готова к копированию — это точный путь от нуля до работающего аудита.

1. Установите CLI

Публикации на crates.io пока нет, поэтому сборка из исходников через cargo — единственный рабочий способ установки сегодня. Причины и информация о готовых бинарниках — в README CLI.

cargo install --git https://github.com/ChevvyOkK/contextguard contextguard

2. Запустите первый аудит

Разбирает все локальные транскрипты сессий Claude Code на этой машине и показывает стоимость, cache hit rate и утечки токенов. Ничего не покидает диск.

contextguard

3. Узнайте, что реально занимает контекстное окно

Флагманская команда: разбирает контекстное окно сессии по источникам — системный промпт, описания MCP-инструментов, результаты инструментов, история диалога — и называет конкретное, оценённое в деньгах действие, например какие неиспользуемые MCP-серверы отключить.

contextguard context

4. Проверьте CLAUDE.md

Находит шаблонные фразы, дублирующиеся строки и устаревшие ссылки в CLAUDE.md, оценивает стоимость каждой в месяц и (с флагом --fix) показывает diff перед записью.

contextguard lint --fix

5. Установите плагин для защиты в реальном времени

В отличие от CLI, плагин стоит прямо в hook'ах Claude Code и действует во время сессии — обрезает шумный вывод Bash, ограничивает разросшиеся результаты Grep и (по желанию) предупреждает, если агент похоже застрял. Он никогда не блокирует вызов инструмента, пока вы явно это не включите.

/plugin marketplace add ChevvyOkK/contextguard-plugin
/plugin install contextguard@contextguard

6. Отправляйте агрегаты в дашборд (необязательно)

Отправляет одну агрегированную строку в день — количество токенов по категориям, число сессий, оценку стоимости. Никогда — код, промпты, имена инструментов или пути к файлам. Всё выше этой строки работает без аккаунта.

contextguard --push --api-url https://your-dashboard.example.com --api-key cg_live_...