Behaviour for implementing Claude Code hooks.

Hooks must implement:

• config/0 to return their hook configuration as a %Claude.Hooks.Hook{} struct
• config/1 to return their hook configuration with user-provided config
• run/1 to execute the hook logic with JSON input
• run/2 to execute the hook logic with JSON input and user config
• description/0 to provide a human-readable description

Using the macro

You can use the use Claude.Hooks.Hook.Behaviour macro to reduce boilerplate:

defmodule MyHook do
  use Claude.Hooks.Hook.Behaviour,
    event: :post_tool_use,
    matcher: "Write|Edit",
    description: "My custom hook"

  def run(input) do
    # Your hook logic here
    :ok
  end

  # Override to handle user config
  def run(input, user_config) do
    # Your hook logic with user config
    :ok
  end
end

The macro automatically:

• Implements the behaviour callbacks
• Generates the config/0 and config/1 functions
• Provides helper functions for common patterns