prehook

Run git hooks configured in pyproject.toml using uv.

Usage

1. Install (one-time):

   uvx prehook install
   

   Use --force to overwrite existing git hooks.

   Installed hooks are self-contained sh (they read pyproject.toml directly), so committing never needs prehook itself, and editing the hook list needs no reinstall.

2. Update hooks in pyproject.toml:

   [tool.prehook]
   hooks = [
       "uvx ruff check",
       "uvx ruff format",
   ]
   

3. Commit:

   git commit -m "unfinished commit"
   

To uninstall:

uvx prehook uninstall

Run the hooks on demand (e.g. in CI) without committing:

uvx prehook run                 # pre-commit hooks
uvx prehook run --on pre-push   # a specific stage

Configuration

Each hook can have a name, target git hook type, and other options:

[tool.prehook]
hooks = [
    { name = "lint", run = "uvx ruff check --fix" },
    { name = "format", run = "uvx ruff format" },
    { name = "typecheck", run = "uvx pyright" },
    { name = "test", run = "pytest", on = ["pre-push"] },
]

uvx prehook install installs hooks for all supported git hook types, so adding new on values works without reinstalling.

Skipping hooks

SKIP=typecheck git commit -m "wip"         # skip by name
SKIP=lint,typecheck git commit -m "wip"    # skip multiple
git commit --no-verify -m "wip"            # skip all

Parallel and fail fast

[tool.prehook]
parallel = true
fail_fast = true
hooks = [
    { name = "lint+format", run = "uvx ruff check --fix && uvx ruff format" },
    { name = "typecheck", run = "uvx pyright" },
]

Why?

I used pre-commit for a long time, and it's a great tool.

But I prefer less configuration files, and for most projects I just want a quick:

uvx ruff check
uvx ruff format

Which are fast enough to always run on all files (rather than just staged ones).

Alternatives

If this tool doesn't do what you need, these are worth a look: