Clooks: Claude Codeのための永続的フックランタイム

パフォーマンスの問題と解決策

Claude Codeパイプラインがより堅牢になるにつれ、フック数は2〜3の軽量チェックから、SessionStart、PreToolUse、PostToolUse、Stopイベントにまたがる50以上のハンドラーに増加する可能性があります。各フックは通常、新規のNodeまたはPythonプロセスを生成し、純粋な生成オーバーヘッドによるレイテンシがセッションごとに蓄積されます。

Clooksは、プロセス生成なしでフックディスパッチを処理する永続的なHTTPデーモンを提供することでこれを解決します。Claude CodeはすでにネイティブでHTTPフックをサポートしているため、Clooksはそれらを向ける価値のあるデーモンを提供します。

パフォーマンスベンチマーク

ソースのベンチマークから：

• 単一呼び出し：約34.6ms → 約0.31ms
• フルセッション（120回呼び出し）：約3,986ms → 約23ms

コア機能

• clooks migrate：既存のフックを自動的に変換、書き直し不要の1コマンド
• LLMハンドラー：フック設定から$TRANSCRIPT、$GIT_DIFF、$ARGUMENTSなどのプロンプトテンプレートと変数を使用してClaudeを直接呼び出し
• バッチグループ化：同じbatchGroupを持つハンドラーは単一のAPI呼び出しを共有
• 依存関係解決：depends: [other-handler]構文とトポロジカルソートによる並列実行ウェーブ
• プラグインシステム：再利用可能なフックセットをclooks-plugin.yamlとしてパッケージ化、clooks addでインストール
• ホットリロード：マニフェストを編集すると、デーモンが即座に検知
• メトリクス＋コスト追跡：clooks statsで実行中の内容を表示、clooks costsでLLM支出を追跡

はじめに

インストール：npm install -g /clooks

次に実行：clooks migrate

現在のバージョンはv0.5で、積極的に開発中ですが未完成な部分もあります。このツールは貢献を受け付けています。