Cozempic
Ruya-AI/cozempicИнструмент для обрезки раздутых сессий Claude Code: 18 стратегий очистки, защита Agent Teams от потери контекста, автоматический фоновый демон. Без внешних зависимостей, только Python 3.10+ stdlib.
Установка
git clone https://github.com/Ruya-AI/cozempic.gitREADME
Cozempic
35 000+ активных пользователей доверяют Cozempic поддержание лёгкости сессий Claude Code.
Очистка контекста для Claude Code — удаляет балласт, сохраняет всё важное, защищает Agent Teams от потери контекста.
Что делает
Сессии Claude Code накапливают мусор: индикаторы прогресса, блоки размышлений, устаревшие чтения файлов, дублирующиеся инъекции CLAUDE.md, base64-скриншоты, раздутые выводы инструментов и метаданные. Типичная сессия весит 8–46 МБ — большая часть это шум, который раздувает каждый API-вызов.
Cozempic удаляет его с помощью 17 компонуемых стратегий в 3 уровнях обрезки, оставляя нетронутыми реальный диалог, принятые решения и рабочий контекст. Фоновый демон-охранник запускается автоматически — установил один раз и забыл.
Ключевые возможности
- 18 стратегий обрезки — мягкая (5), стандартная (11), агрессивная (18)
- Демон-охранник — автозапуск через хук
SessionStart, непрерывный мониторинг и обрезка compact-summary-collapse— экономия 85–95% за счёт удаления сообщений до точки компакции, уже включённых в сводку- Защита Agent Teams — сохраняет состояние команды через компакцию, реактивное восстановление при переполнении
- Поведенческий дайджест — извлекает ваши поправки («не делай X»), сохраняет их в систему памяти Claude Code, чтобы они пережили компакцию
- 8 проверок
doctor— диагностика и автоисправление повреждений сессии, осиротевших результатов инструментов, зависших команд - Токен-ориентированная диагностика — точное количество токенов из полей
usage, процент попаданий в кэш, индикатор заполненности контекста - Автоопределение контекста 1M — корректные пороги для моделей 200K и 1M
- Автообновление — ежедневная проверка PyPI, обновление на месте
Нет внешних зависимостей. Только стандартная библиотека Python 3.10+.
Установка
Выберите удобный пакетный менеджер:
# pip (Python ≥ 3.10)
pip install cozempic
# pipx — изолированная пользовательская установка, всегда доступна в PATH
pipx install cozempic
# uv / uvx — без установки, запуск по требованию
uvx cozempic --help
# Homebrew (macOS / Linux)
brew install Ruya-AI/cozempic/cozempic
# Nix flake
nix profile install github:Ruya-AI/cozempic?dir=packaging/nixПакеты AUR (yay -S cozempic) и MacPorts (port install py-cozempic) находятся в процессе публикации — статус и исходники PKGBUILD/Portfile см. в packaging/README.md.
Всё. Cozempic автоматически инициализируется при первом использовании — хуки подключаются глобально, демон-охранник запускается при каждой сессии Claude Code. Ручная настройка не нужна. Отключить автоинициализацию: COZEMPIC_NO_GLOBAL_INIT=1.
Как плагин Claude Code
Установите cozempic любым из способов выше, затем внутри Claude Code:
/plugin marketplace add Ruya-AI/cozempic
/plugin install cozempic
Это добавит MCP-инструменты, скиллы (/cozempic:diagnose, /cozempic:treat и др.) и автоматически подключит хуки.
Быстрый старт
# Автоопределение и диагностика текущей сессии
cozempic current --diagnose
# Пробный запуск стандартного рецепта
cozempic treat current
# Применить с резервной копией
cozempic treat current --execute
# Агрессивная обрезка конкретной сессии
cozempic treat <session_id> -rx aggressive --execute
# Проверить сессию на повреждения
cozempic doctor
# Просмотреть правила поведенческого дайджеста
cozempic digest show
# Показать все стратегии и рецепты
cozempic formularyСтратегии
| # | Стратегия | Уровень | Что делает | Ожидаемый эффект |
|---|---|---|---|---|
| 1 | compact-summary-collapse | мягкий | Удаляет все сообщения до точки компакции (уже в сводке) | 85–95% |
| 2 | attribution-snapshot-strip | мягкий | Удаляет записи метаданных attribution-snapshot | 0–2% |
| 3 | progress-collapse | мягкий | Сворачивает последовательные и одиночные сообщения-индикаторы прогресса | 40–48% |
| 4 | file-history-dedup | мягкий | Дедуплицирует сообщения file-history-snapshot | 3–6% |
| 5 | metadata-strip | мягкий | Удаляет статистику использования токенов, stop_reason, стоимость | 1–3% |
| 6 | thinking-blocks | стандартный | Удаляет/обрезает блоки размышлений и подписи | 2–5% |
| 7 | tool-output-trim | стандартный | Обрезает большие результаты инструментов (>8 КБ или >100 строк), с учётом микрокомпакции | 1–8% |
| 8 | tool-result-age | стандартный | Компактирует старые результаты инструментов по возрасту — минифицирует средние, заглушает старые | 10–40% |
| 9 | stale-reads | стандартный | Удаляет чтения файлов, перекрытые последующими правками | 0,5–2% |
| 10 | system-reminder-dedup | стандартный | Дедуплицирует повторяющиеся теги system-reminder | 0,1–3% |
| 11 | tool-use-result-strip | стандартный | Удаляет поле-обёртку toolUseResult (Edit-диффы, никогда не отправляются в API) | 5–50% |
| 12 | image-strip | агрессивный | Удаляет старые base64-блоки изображений, оставляет последние 20% | 1–40% |
| 13 | http-spam | агрессивный | Сворачивает последовательные HTTP-запросы | 0–2% |
| 14 | error-retry-collapse | агрессивный | Сворачивает повторяющиеся последовательности ошибок с повторными попытками | 0–5% |
| 15 | background-poll-collapse | агрессивный | Сворачивает повторяющиеся сообщения опроса | 0–1% |
| 16 | document-dedup | агрессивный | Дедуплицирует большие блоки документов (инъекция CLAUDE.md) | 0–44% |
| 17 | mega-block-trim | агрессивный | Обрезает любой блок контента свыше 32 КБ | страховочная сетка |
| 18 | envelope-strip | агрессивный | Удаляет постоянные поля обёртки (cwd, version, slug) | 2–4% |
Рецепты
| Рецепт | Стратегий | Риск | Типичная экономия |
|---|---|---|---|
gentle | 5 | Минимальный | 85–95% (при наличии границы компакции) |
standard | 11 | Низкий | 25–45% |
aggressive | 18 | Умеренный | 35–60% |
Пробный запуск — режим по умолчанию. Ничего не изменяется до передачи флага --execute. Резервные копии создаются всегда.
Guard — непрерывная защита
Демон-охранник мониторит сессию и выполняет обрезку автоматически:
# Автозапуск через хук SessionStart после cozempic init
# Или запустить вручную:
cozempic guard --daemon4-уровневая проактивная обрезка (каждые 30 с):
| Уровень | Порог | Действие | Перезагрузка? |
|---|---|---|---|
| Мягкий | 25% | мягкая очистка файлов | Нет |
| Стандартный | 50% | стандартная обрезка | Нет |
| Агрессивный | 75% | агрессивная обрезка | Нет |
| Критический | 90% | принудительная компакция | Да |