Clooks: Um Ambiente de Execução Persistente de Hooks para Claude Code

Problema de Desempenho e Solução

À medida que os pipelines do Claude Code se tornam mais robustos, a quantidade de hooks pode aumentar de 2-3 verificações leves para 50+ manipuladores em eventos como SessionStart, PreToolUse, PostToolUse e Stop. Cada hook normalmente gera um novo processo Node ou Python, criando latência apenas pela sobrecarga de inicialização, que se acumula por sessão.

O Clooks resolve isso fornecendo um daemon HTTP persistente que gerencia o despacho de hooks sem gerar processos. Como o Claude Code já suporta hooks HTTP nativamente, o Clooks oferece um daemon ideal para direcioná-los.

Benchmarks de Desempenho

Dos benchmarks originais:

• Invocação única: ~34,6ms → ~0,31ms
• Sessão completa (120 chamadas): ~3.986ms → ~23ms

Funcionalidades Principais

• clooks migrate: Converte hooks existentes automaticamente com um comando, sem necessidade de reescrever
• Manipuladores LLM: Chame o Claude diretamente da configuração do hook com modelos de prompt e variáveis como $TRANSCRIPT, $GIT_DIFF, $ARGUMENTS
• Agrupamento em lote: Manipuladores com o mesmo batchGroup compartilham uma única chamada de API
• Resolução de dependências: Sintaxe depends: [other-handler] com ordenação topológica em ondas de execução paralela
• Sistema de plugins: Empacote conjuntos reutilizáveis de hooks como clooks-plugin.yaml, instale com clooks add
• Recarregamento a quente: Edite o manifesto, o daemon o detecta instantaneamente
• Métricas + rastreamento de custos: clooks stats mostra o que está sendo executado, clooks costs monitora gastos com LLM

Começando

Instale com: npm install -g /clooks

Em seguida execute: clooks migrate

A versão atual é a v0.5, em desenvolvimento ativo com algumas imperfeições. A ferramenta está aberta a contribuições.