agenthook 0.0.1

Declarative agent hooks manager.

agenthook

Declarative agent hooks manager.

Overview

Single-file lint hook for agentic coding. Runs fix commands sequentially, then check commands in parallel, and blocks the edit on failure. Define commands in agenthook.yml. Currently supports Claude Code only.

Requirements

• uv

Setup

.claude/settings.json:

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

agenthook.yml (see agenthook.example.yml for all options):

fix:
  commands:
    ruff-format:
      glob: "*.py"
      run: uv run ruff format {file}

check:
  commands:
    ruff-check:
      glob: "*.py"
      run: uv run ruff check {file}
    mypy:
      glob: "*.py"
      run: uv run mypy {file}

How it works

1. Claude Code triggers the hook after each file edit
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

Git-ignored files are skipped. Config is discovered by searching upward for agenthook.yml. Override with --config <path>.

Development

just setup-dev

Tooling

• Runtime: uv
• JS/TS: Biome
• Python: Ruff, mypy, pytest, Poe
• 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.