Claude Code Plugin Hooks

Claude Code plugin hooks file.

Type object
File match **/hooks/hooks.json
Schema URL https://catalog.lintel.tools/schemas/claude-code/plugin-hooks/latest.json

Validate with Lintel

npx @lintel/lintel check
Type: object

Schema for a Claude Code plugin hooks file (hooks/hooks.json). Plugin hooks merge with user and project hooks when the plugin is enabled. The file wraps hook event definitions with an optional description field. See hooks reference and plugin hooks.

Properties

hooks Hooks required

Hook event definitions. Maps event names to arrays of matcher groups.

description string

Human-readable description of what this set of hooks does. Shown in the /hooks menu.

Examples: "Automatic code formatting", "Security validation hooks"