# disler/claude-code-hooks-mastery

Master Claude Code Hooks

Repository: https://github.com/disler/claude-code-hooks-mastery
Canonical: https://ross.abutalabs.com/products/claude-code-hooks-mastery
Language: Python
License Family: other
Last push: 2026-03-04T18:16:25+00:00

## Health v2 (maintenance only)
Score: 50/100 (v2, computed 2026-09-03T02:20:16.233290+00:00)
- activity 70, release rhythm 35, longevity 30
- inputs: {"age_days": 424, "days_push": 182, "days_rel": null, "gap_med": null, "n_releases_24m": 0}
- flags: no_releases, no_license
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 3905, forks 639 (observed 2026-08-28T04:08:28.694395+00:00)

## What it is
A tutorial repository and runnable example collection for mastering Claude Code hooks, Anthropic's mechanism for adding deterministic (and non-deterministic) control over the Claude Code CLI agent's behavior. It ships Python hook scripts covering all 13 hook lifecycle events with JSON payloads, plus demos of sub-agents, a meta-agent, team-based validation, output styles, and custom status lines.

## Use cases
- learn how claude code hooks work
- automatically run formatters after claude edits files
- block or approve tool calls before claude executes them
- add text-to-speech notifications to my ai coding agent
- orchestrate sub-agents and team-based validation with claude code
- customize claude code status line and output styles
- find starter templates for hook scripts in python

## When to choose
- You want hands-on, runnable examples for every Claude Code hook lifecycle event
- You are building deterministic guardrails or automation around the Claude Code CLI
- You want starter templates for hooks, sub-agents, and agent orchestration workflows
- You prefer lightweight single-file Python scripts orchestrated with Astral UV

## When to avoid
- You need a production framework with a stable, versioned API rather than tutorial example scripts
- You don't use Claude Code or Anthropic's tooling
- You require a clearly licensed codebase for commercial redistribution, since the repo has no license
- You want a general-purpose agent framework unrelated to Claude Code

## Facets
- artifact type: learning-resource
- maturity: active
- function: agent-framework, developer-tools, cli, workflow-automation, boilerplate
- domain: artificial-intelligence, developer-tools, tutorials
- platform: python, cli, cross-platform
- tags: claude-code, claude-code-hooks, anthropic, ai-coding-agent, hook-lifecycle, sub-agents, meta-agent, team-based-validation, output-styles, status-line, astral-uv, elevenlabs, mcp-server, example-code, ai-agents, command-line, automation

## Member repositories
- disler/claude-code-hooks-mastery (main) score 50

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:08:28.694395+00:00.
- Health v2: computed from the inputs above; adoption is never an input.
- Inferred fields (summary, facets, guidance): AI-extracted, prompt v1, taxonomy v1, on 2026-08-29T18:25:07.263575+00:00, confidence not recorded.
  - readme: https://github.com/disler/claude-code-hooks-mastery (fetched 2026-08-28T04:08:28.694395+00:00, sha d3715265f926)
- Data as of 2026-08-30T08:39:29.467469+00:00.