Cozempic CLI
CLI чистит сессии Claude Code от балласта, следит за контекстом фоновым сторожем и сохраняет состояние «Agent Teams»
- 427 ★ репозитория
- Последний коммит
- MIT
Широкий доступ
Почему такой уровень
- Прописывает хуки в настройки Claude Code глобально и запускает фоновый процесс при каждой сессии
- Переписывает файлы сессий и завершает процесс Claude Code, чтобы возобновить его после чистки
- Сам обновляется из PyPI, поэтому новый код приходит без вашего просмотра, и отправляет анонимные счетчики использования
Установка
- Работает в
Ручная установка
uv tool install cozempicПостоянная установка, команда всегда в PATH. Подходят и `pipx install cozempic`, `npm install -g cozempic`, `pip install cozempic`.
Доступ и проверки
Как мы проверяемШирокий доступИнструмент может менять данные, выполнять команды или работать с секретами.
- Прописывает хуки в настройки Claude Code глобально и запускает фоновый процесс при каждой сессии
- Переписывает файлы сессий и завершает процесс Claude Code, чтобы возобновить его после чистки
- Сам обновляется из PyPI, поэтому новый код приходит без вашего просмотра, и отправляет анонимные счетчики использования
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Cozempic чистит сессии Claude Code от балласта. Файл сессии за время работы разрастается: в нем копятся записи о ходе работы, блоки размышлений, устаревшие чтения файлов, повторные вставки CLAUDE.md, скриншоты в base64 и объемные ответы инструментов. Cozempic убирает этот шум 18 стратегиями трех наборов (`gentle`, `standard`, `aggressive`) и не трогает саму переписку и принятые решения. По умолчанию команды работают вхолостую: `cozempic treat current` показывает, сколько получится освободить, а запись начинается только с флагом `--execute` и после резервной копии. Фоновый сторож `cozempic guard` следит за заполнением контекста. На отметках 25, 55 и 80 процентов он включает все более сильные наборы стратегий, а в интерактивной сессии сначала предупреждает и перезапускает сессию только в паузе между ходами. Для «Agent Teams» Cozempic сохраняет состояние команды перед сжатием и восстанавливает его после переполнения. Модуль digest выбирает из ваших реплик поправки вида «не делай X» и записывает их в память Claude Code, чтобы они пережили сжатие. Команда `cozempic doctor` ищет и чинит повреждения сессий.
Для кого. Для разработчиков, которые подолгу работают в одних сессиях Claude Code, упираются в автосжатие или запускают команды агентов и не хотят терять контекст.
Подходит, если
- Сессия Claude Code разрослась до десятков мегабайт, и каждый запрос тянет за собой записи о ходе работы, старые чтения файлов и дубли CLAUDE.md
- Вы часто упираетесь в автосжатие и хотите срезать балласт заранее, чтобы переписка осталась нетронутой
- Работает команда агентов, и автосжатие стирает ее координационное состояние
- Сессия не возобновляется или падает с ошибкой 400 из-за потерянных результатов инструментов: `cozempic doctor --fix` чинит такие случаи
- Нужно понять, что раздувает сессию: `cozempic current --diagnose` показывает источники балласта и число токенов
Не подходит, если
- Вы работаете не в Claude Code: Cozempic рассчитан на его файлы сессий
- Вам не нужны фоновые процессы: после первого запуска хуки и сторож включаются глобально, пока не задана `COZEMPIC_NO_GLOBAL_INIT=1`
- Версию программ на машине надо держать неизменной без проверки: пакет по умолчанию обновляется сам, и версию придется закреплять вручную
- Сессия короткая и далека от лимита контекста: чистить в ней нечего
Пример запроса к агенту
Покажи, что раздувает мою текущую сессию Claude Code, и сделай пробную чистку набором standard без записиОграничения
- Cozempic правит файлы сессий Claude Code, а их формат меняется между версиями клиента. Поэтому пакет по умолчанию сам обновляется из PyPI. Остановить обновления можно переменной `COZEMPIC_NO_AUTO_UPDATE=1`, закрепить версию переменной `COZEMPIC_PIN`.
- Перезагрузка завершает процесс Claude Code и возобновляет сессию. Сторож откладывает ее, если идут «Workflow», фоновый субагент, команда агентов или открытый вызов инструмента. В tmux и screen сессия возобновляется в той же панели, в обычном терминале открывается новое окно.
- Нужен Python 3.10 или новее, внешних зависимостей нет. Запуск через uvx без установки подходит для пробы, но сторож из временной среды сам не стартует.
- Разработчик собирает анонимные счетчики использования; отключить их можно переменной `COZEMPIC_NO_TELEMETRY=1`.
Как отключить. Команда `cozempic uninstall` отменяет init: снимает хуки и слэш-команду. Флаги `--project`, `--all` и `--purge` выбирают объем удаления. Сам пакет удаляется тем способом, которым вы его ставили: `pipx uninstall cozempic`, `uv tool uninstall cozempic` или `npm uninstall -g cozempic`.
Частые вопросы
Как поставить Cozempic для Claude Code?
Выполните `uv tool install cozempic`, `pipx install cozempic` или `npm install -g cozempic`. Хуки и сторож подключаются при первом использовании. Чтобы получить еще инструменты MCP и скиллы вида /cozempic:diagnose, внутри Claude Code выполните `/plugin marketplace add Ruya-AI/cozempic` и `/plugin install cozempic`.
Безопасно ли запускать cozempic treat?
Команда по умолчанию работает вхолостую и ничего не меняет, пока нет флага `--execute`. Перед правкой создается копия .jsonl.bak с отметкой времени, запись атомарная, а итоговые сводки сжатия и границы компактификации никогда не удаляются.
Как отключить автообновление и фоновые хуки Cozempic?
`COZEMPIC_NO_AUTO_UPDATE=1` останавливает автообновление, а хуки и сторожевой процесс продолжают работать, `COZEMPIC_PIN` закрепляет проверенную версию, а `COZEMPIC_NO_GLOBAL_INIT=1` оставляет только ручной режим командной строки без хуков и демона.
Чем Cozempic отличается от автосжатия в Claude Code?
Автосжатие пересказывает историю с потерями. Cozempic срезает балласт 18 стратегиями и оставляет разговор нетронутым, причем сторож предупреждает заранее: подсказки идут на 25, 55 и 80 процентах контекста.
Как вернуть сессию в состояние до чистки?
Перед каждой записью Cozempic кладет рядом резервную копию .jsonl.bak. Подставьте ее вместо файла сессии. Команда `cozempic doctor` при этом предупредит о старых копиях, которые занимают место, и удалит их с флагом `--fix`.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
CLI-инструментыСреда для Claude Code, которая держит контекст между сессиями через хуки, леджеры и передачи, оркеструет агентов и экономит токены
Шаблон CLAUDE.md из 7 правил и команды передачи сессий, чтобы Claude Code не терял числа и решения при сжатии контекста
Плагин самообучения для Claude Code, Codex и OpenCode: превращает исправления в правила, которым агент следует в следующих сессиях
Слой оркестрации для Claude Code, Cursor и Codex: совет из 495 персон-экспертов выносит вердикт с именованным несогласием, плюс сотни скиллов и команд
Оркестрация нескольких агентов для Claude Code: команды, роли, автопилот и распределение задач между скиллами и субагентами
Операционный слой для Claude Code и Codex: единая команда /do, память проекта между сессиями, защитные хуки, телеметрия расходов и параллельные агенты
Сравнение с похожими
Записи с тем же главным запросом: чем они отличаются.
| Запись | Официальный | Авторизация | Звезды репозитория | Главное отличие |
|---|---|---|---|---|
| Cozempic (эта запись) | нет | 427 | ||
| Token Optimizer | нет | 2 780 | режет лишние токены и показывает стоимость, у Cozempic главный инструмент чистка файла сессии 18 стратегиями | |
| Context Mode | нет | не нужна | 32 711 | держит большой вывод инструментов вне контекста, Cozempic чистит уже накопленный файл сессии |
| fast-jev-compaction | нет | 7 795 | плагин сжатия, который удаляет ненужные вызовы инструментов, у Cozempic отдельный CLI со сторожем, проверками doctor и защитой Agent Teams |
Коротко о README
Страница начинается с описания проблемы и списка возможностей, затем дает способы установки и быстрый старт. Дальше идут таблица стратегий с ожидаемой экономией, раздел о сторожевом процессе и порогах заполнения, дайджест поправок и таблица проверок doctor. В конце стоят список команд, перечень хуков, правила безопасности и журнал изменений.