winnow — плагин
Плагин Claude Code прячет из контекста крупные блоки вывода, которые судья считает лишними, и оставляет ключ возврата.
- 115 ★ репозитория
- Последний коммит
- MIT
Широкий доступ
Почему такой уровень
- Содержимое файлов и вывод команд проходят через внешние сервисы TypeSafe или Anthropic, а в нем могут оказаться секреты.
Установка
- Работает в
В терминале, через SkillFoxx CLI
npx skillfoxx add plugins/winnowОпределит агенты на машине, покажет уровень доступа и зафиксирует версию.
Другие способы установки
Доступ и проверки
Как мы проверяемШирокий доступИнструмент может менять данные, выполнять команды или работать с секретами.
- Содержимое файлов и вывод команд проходят через внешние сервисы TypeSafe или Anthropic, а в нем могут оказаться секреты.
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
winnow оценивает каждый большой результат Read, Bash или Grep, прежде чем он попадет в контекст Claude. Результат режется на блоки примерно по 25 строк, а судья отвечает вероятностью на вопрос, нужен ли блок для текущей задачи. Блоки, в ненужности которых судья уверен, заменяются заглушкой из трех строк: что скрыто, краткая сводка от дешевой модели и ключ, по которому полный текст возвращается вызовом winnow_recall. Если судья видит в выводе ошибку, блоки остаются на месте. Неуверенные блоки тоже сохраняются. Второй хук при вводе запроса ранжирует файлы памяти Claude Code и каталоги из WINNOW_CONTEXT_DIRS по запросу. Файлы на диске, выполненные команды и транскрипт Claude Code не меняются, меняется только то, что видит модель. Полный текст скрытого вывода хранится в ~/.winnow/cache/.
Для кого. Пользователям Claude Code с большими репозиториями и длинными логами, у которых контекст забивается результатами команд.
Подходит, если
- Чтение огромного файла занимает контекст, а нужна только его часть.
- Вывод grep по всему репозиторию содержит сотни совпадений, большинство из которых не по теме.
- Лог теста длинный, а важна только строка с ошибкой.
- Агенту нужно вернуть скрытый блок по ключу, когда выяснится, что он понадобился.
Не подходит, если
- Нельзя отправлять содержимое файлов и вывода команд внешнему сервису: судье уходят блоки результатов.
- Claude Code старше 2.1.260 без функциональных хуков.
- Выводы небольшие: порог по размеру пропустит их, и экономии не будет.
Пример запроса к агенту
Прочитай крупный файл логов и верни только то, что относится к падению теста, а скрытые блоки восстановишь по ключу при необходимости.Ограничения
Нужны Python 3.10, uv и Claude Code 2.1.260 или новее с включенной переменной CLAUDE_CODE_ENABLE_FUNCTION_HOOKS: ранний доступ, без нее плагин ничего не делает. Для судьи Jev от TypeSafe AI нужна заявка в лист ожидания и ключ, альтернатива WINNOW_JUDGE=adapter идет через Claude Haiku 4.5 и ключ Anthropic, но вероятности у нее не откалиброваны. Блоки вывода и описание задачи уходят судье, скрытые блоки идут в Anthropic для сводок. Кеш скрытого текста не очищается сам.
Как отключить. Удалите плагин командой claude plugin uninstall winnow, уберите CLAUDE_CODE_ENABLE_FUNCTION_HOOKS из настроек и при желании очистите ~/.winnow/cache/ командой winnow clean.
Частые вопросы
Как поставить winnow?
Включите `CLAUDE_CODE_ENABLE_FUNCTION_HOOKS` в `~/.claude/settings.json`, затем `claude plugin marketplace add GhalebDweikat/winnow` и `claude plugin install winnow@winnow`.
Как проверить, что плагин работает?
Откройте новую сессию и прочитайте файл длиннее 1500 символов. Если в результате появилась строка `[winnow]`, плагин работает. Диагностику даст `winnow doctor`.
Что делать без ключа Jev?
Добавьте `WINNOW_JUDGE=adapter` в `~/.winnow/env`: судьей станет Claude Haiku 4.5 через ключ Anthropic. Попробовать без ключей можно командой `winnow demo --fake`.
Как вернуть скрытый блок?
Вызовите `winnow_recall` с ключом из заглушки и диапазоном строк, например `start=41, end=188`.
Что остается нетронутым?
Файлы на диске, выполненные команды и транскрипт Claude Code не меняются. Меняется только то, что попадает в контекст модели.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
ПлагиныПлагин context-optimizer показывает стоимость сессий Claude, режет контекст и отдает чтение файлов и тесты дешевым Haiku.
Установщик набора из хуков, команд и плагинов, который сжимает вывод инструментов и экономит токены в Claude Code.
Плагин Claude Code с хуками и 26 скиллами: измеряет знания агента, блокирует правки до разбора кода, хранит память между сессиями
Плагин Claude Code переключает режимы сессии командой /work-mode: автономная работа, делегирование и сходящееся завершение.
Плагин Claude Code заменяет встроенные файловые инструменты облегченными версиями, чтобы тратить меньше токенов за сессию
Локальный прокси и плагин для Claude Code и Codex: режет лишний вывод инструментов, греет кэш промптов и показывает экономию
Коротко о README
Документация объясняет схему судьи и заглушек и содержит таблицу данных, которые покидают машину. Рядом лежат результаты экспериментов с оценкой калибровки. Репозиторий работает как собственный маркетплейс плагинов.