HookLab - Watch your Claude Code hooks in real time

Source: Dev.to

Overview

Claude Code recently added HTTP hooks. Instead of shell scripts, you can point hook events at a URL. HookLab is a live dashboard that displays each hook event in the browser as it happens, showing which tools are being called, the arguments they receive, and the responses. You can filter by event type, tool, or session, and expand any row to inspect the full payload.

Running HookLab

services:
  app:
    image: ghcr.io/felipeelias/hook-lab:latest
    ports:
      - "4000:4000"
    volumes:
      - hook_lab_data:/app/data
    environment:
      SECRET_KEY_BASE: ${SECRET_KEY_BASE}
      DATABASE_PATH: /app/data/hook_lab.db
      PHX_HOST: localhost

volumes:
  hook_lab_data:

Generate a secret key and start the container:

export SECRET_KEY_BASE=$(openssl rand -base64 64)
docker compose up -d

Configuration

Point your Claude Code hooks to the running HookLab instance. The repository’s README contains the full settings.json configuration you need.

Technical Details

HookLab is built with Phoenix LiveView and SQLite. A future version will allow you to block or modify hook events based on custom rules.