Clooks : Un environnement d'exécution de hooks persistants pour Claude Code

Problème de performance et solution

À mesure que les pipelines Claude Code deviennent plus robustes, le nombre de hooks peut augmenter de 2-3 vérifications légères à 50+ gestionnaires répartis sur les événements SessionStart, PreToolUse, PostToolUse et Stop. Chaque hook lance généralement un nouveau processus Node ou Python, créant une latence due au simple surcoût de lancement qui s'accumule par session.

Clooks résout ce problème en fournissant un démon HTTP persistant qui gère la distribution des hooks sans création de processus. Comme Claude Code prend déjà en charge nativement les hooks HTTP, Clooks vous offre un démon vers lequel les pointer.

Benchmarks de performance

D'après les benchmarks sources :

• Invocation unique : ~34,6 ms → ~0,31 ms
• Session complète (120 appels) : ~3 986 ms → ~23 ms

Fonctionnalités principales

• clooks migrate : Convertit automatiquement les hooks existants avec une seule commande, sans réécriture nécessaire
• Gestionnaires LLM : Appelez Claude directement depuis la configuration du hook avec des modèles de prompts et des variables comme $TRANSCRIPT, $GIT_DIFF, $ARGUMENTS
• Regroupement par lots : Les gestionnaires avec le même batchGroup partagent un seul appel API
• Résolution des dépendances : Syntaxe depends: [other-handler] avec tri topologique en vagues d'exécution parallèles
• Système de plugins : Empaquetez des ensembles de hooks réutilisables sous clooks-plugin.yaml, installez avec clooks add
• Rechargement à chaud : Modifiez le manifeste, le démon le prend en compte instantanément
• Métriques + suivi des coûts : clooks stats montre ce qui se déclenche, clooks costs suit les dépenses LLM

Pour commencer

Installez avec : npm install -g /clooks

Puis exécutez : clooks migrate

La version actuelle est la v0.5, activement développée avec quelques aspérités. L'outil est ouvert aux contributions.