Clooks: Un Entorno de Ejecución de Hooks Persistente para Claude Code

Problema y Solución de Rendimiento

A medida que las canalizaciones de Claude Code se vuelven más robustas, el número de ganchos puede aumentar de 2-3 comprobaciones ligeras a más de 50 manejadores en eventos como SessionStart, PreToolUse, PostToolUse y Stop. Cada gancho normalmente genera un nuevo proceso de Node o Python, creando latencia por la sobrecarga pura de generación que se acumula por sesión.

Clooks resuelve esto proporcionando un demonio HTTP persistente que maneja el despacho de ganchos sin generar procesos. Dado que Claude Code ya admite ganchos HTTP de forma nativa, Clooks te da un demonio al que vale la pena apuntarlos.

Puntos de Referencia de Rendimiento

De los puntos de referencia de la fuente:

• Invocación única: ~34.6ms → ~0.31ms
• Sesión completa (120 llamadas): ~3,986ms → ~23ms

Características Principales

• clooks migrate: Convierte ganchos existentes automáticamente con un comando, sin necesidad de reescribir
• Manejadores LLM: Llama a Claude directamente desde la configuración del gancho con plantillas de prompts y variables como $TRANSCRIPT, $GIT_DIFF, $ARGUMENTS
• Agrupación por lotes: Los manejadores con el mismo batchGroup comparten una única llamada API
• Resolución de dependencias: Sintaxis depends: [other-handler] con ordenación topológica en oleadas de ejecución paralela
• Sistema de complementos: Empaqueta conjuntos de ganchos reutilizables como clooks-plugin.yaml, instala con clooks add
• Recarga en caliente: Edita el manifiesto, el demonio lo detecta al instante
• Métricas + seguimiento de costos: clooks stats muestra qué se está activando, clooks costs rastrea el gasto en LLM

Comenzando

Instala con: npm install -g /clooks

Luego ejecuta: clooks migrate

La versión actual es v0.5, en desarrollo activo con algunos detalles por pulir. La herramienta está abierta a contribuciones.