agenthook

Declarative agent hooks manager.

Overview

Lint hook for agentic coding (currently Claude Code only). Runs fix commands sequentially, then check commands in parallel, and blocks the edit on failure.

Requirements

• uv

Setup

.claude/settings.json:

{
  "hooks": {
    "PostToolUse": [
      {
        "matcher": "Edit|MultiEdit|Write",
        "hooks": [
          {
            "type": "command",
            "command": "uvx agenthook",
            "timeout": 45
          }
        ]
      }
    ]
  }
}

See agenthook.example.yml for all available configuration options.

How it works

1. Claude Code triggers the hook after each file edit (git-ignored files are skipped)
2. Fix commands run sequentially (formatting, auto-fix)
3. Check commands run in parallel (linting, type checking)
4. On failure, the edit is blocked with a report describing the issues

Development

just setup-dev

Tooling

• Runtime: uv
• JS/TS: Biome
• Python: Ruff, ty, Poe, pytest
• Project template: Copier
• Task runner: just
• Git hooks: Lefthook

Dependencies

Automated via Renovate. Dependency update PRs are created automatically.

Release

Automated via release-please. Merge the auto-generated Release PR to bump version, update CHANGELOG.md, and create a tag.