Many people don't like git hooks these days, usually because they're slow. If your git hooks are slow, your commits slow down and start to cause development friction, which is to be avoided.

These hooks are simple and aim to add no more than a few milliseconds to your commits. For example, using git-lfs hooks can cause some slowdowns on repos which aren't actually lfs-enabled, but adding lfs support to repos which already have hooks installed is an annoying extra step, so git lfs track is used to short-circuit this logic.

Prerequisites

git
git-lfs
gitleaks (optional, for secret scanning)
mg (optional, for repo registration on push)

What these hooks do

Rather than try to lint code from a git hook, or run tests, etc., these hooks assume you're already a good developer. You know how to follow style guides, you're ok with an occasionally failing CI job. That's what CI is for, after all.

These hooks don't try to hold your hand, they just prevent accidentally making a couple of annoying blunders:

Hook	What it does
`pre-commit`	Blocks commits containing files over 5 MiB (unless tracked by LFS)
`pre-commit`	Scans staged files for leaked secrets via gitleaks (skipped if gitleaks not installed)
`commit-msg`	Validates Conventional Commits format
`post-checkout`	Runs `git lfs post-checkout`
`post-commit`	Runs `git lfs post-commit`
`post-merge`	Runs `git lfs post-merge`
`pre-push`	Registers the repo with mg, then runs `git lfs pre-push` if LFS is active

Installation

Quick Install (recommended)

git clone https://github.com/taigrr/hooks.git ~/.git-hooks
cd ~/.git-hooks && ./install.sh

This sets core.hooksPath so all repos use these hooks. Updates to the hooks directory apply everywhere immediately.

To override hooks for a specific repo:

cd /path/to/repo
git config core.hooksPath /path/to/other/hooks

Template Installation

Use this if you only want new repos (created with git init or git clone) to receive a copy of these hooks:

git clone https://github.com/taigrr/hooks.git ~/.git-hooks
cd ~/.git-hooks && ./install.sh --template

Note: Existing repos won't be affected.

Uninstall

cd ~/.git-hooks && ./uninstall.sh

Configuration

File size limit

The file size limit in pre-commit defaults to 5 MiB. To change it, edit the size_limit variable at the top of the pre-commit file:

size_limit=$((10 * 2**20))  # 10 MiB

Conventional Commits

The commit-msg hook enforces Conventional Commits format on your commit messages:

<type>(<scope>): <description>

Valid types: feat, fix, docs, style, refactor, perf, test, build, ci, chore, revert. Add ! after the type/scope for breaking changes.

Merge commits and fixup/squash commits are always allowed.

To disable this hook for a single commit:

git commit --no-verify -m "whatever"

Compatibility Notice

These hooks are not tested alongside any other hooks, or "hook managers" such as pre-commit or Husky. They will almost certainly cause issues if used alongside git-annex. You have been warned.

Contributing

Keeping in mind that the hooks are supposed to be extremely generic and fast, I don't know what else there might be to add, but if there's something you think I'm missing feel free to open a PR and I'll consider it.