Клукс: Постоянная среда выполнения хуков для Claude Code

Проблема производительности и решение

По мере того как конвейеры Claude Code становятся более надёжными, количество хуков может увеличиться с 2–3 лёгких проверок до 50+ обработчиков для событий SessionStart, PreToolUse, PostToolUse и Stop. Каждый хук обычно создаёт новый процесс Node или Python, что приводит к задержкам из-за накладных расходов на создание процессов, которые накапливаются за сессию.

Clooks решает эту проблему, предоставляя постоянный HTTP-демон, который обрабатывает диспетчеризацию хуков без создания процессов. Поскольку Claude Code уже поддерживает HTTP-хуки нативно, Clooks даёт вам демона, на который можно их направить.

Бенчмарки производительности

Согласно исходным тестам:

• Один вызов: ~34,6 мс → ~0,31 мс
• Полная сессия (120 вызовов): ~3 986 мс → ~23 мс

Основные возможности

• clooks migrate: Автоматически преобразует существующие хуки одной командой, без переписывания
• Обработчики LLM: Вызывайте Claude напрямую из конфигурации хука с шаблонами промптов и переменными, такими как $TRANSCRIPT, $GIT_DIFF, $ARGUMENTS
• Группировка в пакеты: Обработчики с одинаковым batchGroup используют один вызов API
• Разрешение зависимостей: Синтаксис depends: [other-handler] с топологической сортировкой для параллельного выполнения волнами
• Система плагинов: Упаковывайте повторно используемые наборы хуков как clooks-plugin.yaml, устанавливайте с помощью clooks add
• Горячая перезагрузка: Отредактируйте манифест — демон подхватит его мгновенно
• Метрики + отслеживание затрат: clooks stats показывает, что срабатывает, clooks costs отслеживает расходы на LLM

Начало работы

Установите с помощью: npm install -g /clooks

Затем выполните: clooks migrate

Текущая версия — v0.5, активно разрабатывается, возможны шероховатости. Инструмент открыт для вклада.