CRUSTS CLI
CLI claude-crusts разбирает контекст Claude Code на шесть категорий, находит лишнее и пишет команду /compact под сессию.
- 82 ★ репозитория
- Последний коммит
- MIT
Расширенный доступ
Почему такой уровень
- Хук и команда `optimize --apply` меняют настройки Claude Code, включая правила запрета чтения в `.claude/settings.local.json`.
- Инструмент читает журналы сессий Claude Code с содержимым ваших разговоров.
Установка
- Работает в
В терминале, через SkillFoxx CLI
npx skillfoxx add cli/crustsОпределит агенты на машине, покажет уровень доступа и зафиксирует версию.
Другие способы установки
Доступ и проверки
Как мы проверяемРасширенный доступИнструмент запускает код или ходит в сеть, а внешние данные только читает.
- Хук и команда `optimize --apply` меняют настройки Claude Code, включая правила запрета чтения в `.claude/settings.local.json`.
- Инструмент читает журналы сессий Claude Code с содержимым ваших разговоров.
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
CRUSTS анализирует журналы сессий Claude Code офлайн, без вызовов API и расхода токенов. Он делит окно контекста на шесть категорий (Conversation, Retrieved, User, System, Tools, State/Memory), находит устаревшее и неиспользованное и ранжирует находки по возможной экономии токенов. Среди находок повторные чтения одних и тех же файлов, неиспользуемые схемы инструментов, закрытые обмены, перезаписи кеша, раздутые `CLAUDE.md` и неиспользованные серверы MCP. Команда `hooks auto-inject enable` ставит хук: когда окно приближается к автосжатию, CRUSTS пишет готовую команду `/compact focus` под сессию и показывает ее строкой. Команда `optimize --apply` добавляет в `.claude/settings.local.json` правила запрета чтения шумных путей (`node_modules/`, `dist/`, lock-файлы) с копиями в `~/.claude-crusts/backups/`. Есть интерактивная оболочка `tui` и слеш-команда `/crusts`.
Для кого. Пользователям Claude Code с длинными сессиями, у которых контекст быстро заполняется, а причину расхода токенов найти трудно.
Подходит, если
- Сессия приближается к автосжатию, и нужна готовая команда `/compact focus` под текущую работу.
- Агент снова и снова читает `index.ts`, и нужно запретить ему шумные пути.
- Подозревают, что подключенные серверы MCP занимают контекст и не вызываются.
- Нужен недельный отчет по расходу контекста в HTML или Markdown.
Не подходит, если
- Нужна точность токенов уровня биллинга: часть разбивки оценивается, а не измеряется.
- Правки `settings.local.json` запрещены политикой: `optimize --apply` записывает туда правила.
- Нужна оптимизация для другого агента: инструмент разбирает журналы Claude Code.
Пример запроса к агенту
Разбери последнюю сессию через claude-crusts, покажи топ лишнего по токенам и подготовь команду /compact focus для текущей задачи.Ограничения
Инструмент оценивает часть разбивки по журналам, поэтому раздел точности в README советует сверяться с `/context` командой `claude-crusts calibrate`. Хук `auto-inject` меняет настройки Claude Code и выводит подсказку в ответе, а `optimize --apply` записывает правила запрета чтения в `.claude/settings.local.json`: для каждой правки есть подтверждение и атомарные копии. Нужен Node.js или bun. CRUSTS не запускает `/compact` сам, команду выполняете вы. Проект не связан с Anthropic.
Как отключить. Отключите хук командой `claude-crusts hooks disable`, а состояние автоподстановки покажет `hooks auto-inject status`. Правила запрета удалите из `.claude/settings.local.json` или восстановите из копий в `~/.claude-crusts/backups/`. Пакет удаляется командой `npm uninstall -g claude-crusts`.
Частые вопросы
Как попробовать без установки?
Выполните `npx claude-crusts analyze`. Глобально ставится командой `npm install -g claude-crusts`, а в bun работают `bunx claude-crusts analyze` и `bun install -g claude-crusts`.
Что делает auto-inject?
Хук `hooks auto-inject enable` пишет команду `/compact focus` под сессию, когда окно приближается к порогу автосжатия, и показывает ее одной строкой. Выполняете ее вы.
Какие категории контекста показывает CRUSTS?
Шесть: Conversation, Retrieved, User, System, Tools и State/Memory. Их сумма сводится к общему окну по данным API.
Нужен ли API-ключ?
Нет. Инструмент работает офлайн, делает ноль вызовов API и не тратит токены.
Как использовать из Claude Code?
Через слеш-команду `/crusts`: файл `.claude/commands/crusts.md` лежит в репозитории.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
CLI-инструментыclaude-history ищет и открывает прошлые диалоги Claude Code, Codex и Pi в терминале и дает Claude скилл для чтения истории
claudetop выводит в строке состояния Claude Code стоимость сессии, кэш, окна лимитов тарифа и предупреждения о перерасходе
Локальный CLI показывает, куда уходят токены в Claude Code, Codex и opencode, и придерживает дорогие сообщения
Python-CLI превращает транскрипты Claude Code из JSONL в читаемые HTML и Markdown с поиском, фильтрами и временной шкалой.
Плагин для Claude Code сам выбирает уровень усилий модели на каждый запрос и показывает остаток времени кэша промпта
Локальная память для Claude Code: бинарный файл индексирует прошлые разговоры и подставляет нужный контекст в новые сессии.
Коротко о README
README начинается с сравнения до и после и трех главных команд, затем описывает возможности, установку, справку по 23 командам, рамку CRUSTS, принцип работы, сравнение с `/context` и пределы точности.