Claude Info
AI и агенты

Cozempic

Ruya-AI/cozempic

Инструмент для обрезки раздутых сессий Claude Code: 18 стратегий очистки, защита Agent Teams от потери контекста, автоматический фоновый демон. Без внешних зависимостей, только Python 3.10+ stdlib.

Установка

terminal
bash
git clone https://github.com/Ruya-AI/cozempic.git

README

Cozempic

Downloads Version License

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+.

Установка

Выберите удобный пакетный менеджер:

bash
# 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 и др.) и автоматически подключит хуки.

Быстрый старт

bash
# Автоопределение и диагностика текущей сессии
cozempic current --diagnose

# Пробный запуск стандартного рецепта
cozempic treat current

# Применить с резервной копией
cozempic treat current --execute

# Агрессивная обрезка конкретной сессии
cozempic treat <session_id> -rx aggressive --execute

# Проверить сессию на повреждения
cozempic doctor

# Просмотреть правила поведенческого дайджеста
cozempic digest show

# Показать все стратегии и рецепты
cozempic formulary

Стратегии

#СтратегияУровеньЧто делаетОжидаемый эффект
1compact-summary-collapseмягкийУдаляет все сообщения до точки компакции (уже в сводке)85–95%
2attribution-snapshot-stripмягкийУдаляет записи метаданных attribution-snapshot0–2%
3progress-collapseмягкийСворачивает последовательные и одиночные сообщения-индикаторы прогресса40–48%
4file-history-dedupмягкийДедуплицирует сообщения file-history-snapshot3–6%
5metadata-stripмягкийУдаляет статистику использования токенов, stop_reason, стоимость1–3%
6thinking-blocksстандартныйУдаляет/обрезает блоки размышлений и подписи2–5%
7tool-output-trimстандартныйОбрезает большие результаты инструментов (>8 КБ или >100 строк), с учётом микрокомпакции1–8%
8tool-result-ageстандартныйКомпактирует старые результаты инструментов по возрасту — минифицирует средние, заглушает старые10–40%
9stale-readsстандартныйУдаляет чтения файлов, перекрытые последующими правками0,5–2%
10system-reminder-dedupстандартныйДедуплицирует повторяющиеся теги system-reminder0,1–3%
11tool-use-result-stripстандартныйУдаляет поле-обёртку toolUseResult (Edit-диффы, никогда не отправляются в API)5–50%
12image-stripагрессивныйУдаляет старые base64-блоки изображений, оставляет последние 20%1–40%
13http-spamагрессивныйСворачивает последовательные HTTP-запросы0–2%
14error-retry-collapseагрессивныйСворачивает повторяющиеся последовательности ошибок с повторными попытками0–5%
15background-poll-collapseагрессивныйСворачивает повторяющиеся сообщения опроса0–1%
16document-dedupагрессивныйДедуплицирует большие блоки документов (инъекция CLAUDE.md)0–44%
17mega-block-trimагрессивныйОбрезает любой блок контента свыше 32 КБстраховочная сетка
18envelope-stripагрессивныйУдаляет постоянные поля обёртки (cwd, version, slug)2–4%

Рецепты

РецептСтратегийРискТипичная экономия
gentle5Минимальный85–95% (при наличии границы компакции)
standard11Низкий25–45%
aggressive18Умеренный35–60%

Пробный запуск — режим по умолчанию. Ничего не изменяется до передачи флага --execute. Резервные копии создаются всегда.

Guard — непрерывная защита

Демон-охранник мониторит сессию и выполняет обрезку автоматически:

bash
# Автозапуск через хук SessionStart после cozempic init
# Или запустить вручную:
cozempic guard --daemon

4-уровневая проактивная обрезка (каждые 30 с):

УровеньПорогДействиеПерезагрузка?
Мягкий25%мягкая очистка файловНет
Стандартный50%стандартная обрезкаНет
Агрессивный75%агрессивная обрезкаНет
Критический90%принудительная компакцияДа

Похожие скиллы