Hey Peeps,

I'm pleased to show case a new small and very fast commit message linter and autofixer tool gitfluff.

What My Project Does

Claude Code kept injecting "🤖 Co-Authored-By" trailers into commits. You can disable it now in local settings, but I needed team-wide enforcement across multiple repos and multiple languages. Plus I wanted strict Conventional Commits validation without cobbling together multiple tools.

What it does

• Enforces Conventional Commits 1.0.0 (type, scope, breaking changes, footers) with full spec compliance.

• Strips AI signatures automatically (configurable patterns)

• Validates or rewrites messages in place with --write

• Zero config to start, optional .gitfluff.toml for custom rules which allow you to do whatever you want basically.

Install & Use

The tool is written and rust and is compiled to multiple platforms. You can install it directly via cargo:

cargo install gitfluff

Or using homebrew:

brew install goldziher/tap/gitfluff

Or via NPM:

npm install -g gitfluff

Or via PIP:

pip install gitfluff

You can then install it as a commit message hook:

gitfluff hook install commit-msg --write

Alternatively you can install it as a hook for pre-commit (or prek) by adding the following to you .pre-commit-config:

repos:
  - repo: https://github.com/Goldziher/gitfluff
    rev: v0.2.0
    hooks:
      - id: gitfluff-lint
        name: gitfluff (lint)
        entry: gitfluff lint --from-file
        language: system
        stages: [commit-msg]
        args: ["{commit_msg_file}"]

      # or using the autofix hook:

      # - id: gitfluff-write
      #  name: gitfluff (lint + write)
      #  entry: gitfluff lint --from-file
      #  language: system
      #  stages: [commit-msg]
      #  args: ["{commit_msg_file}", "--write"]

And then run pre-commit install --hook-type commit-msg, which will install the hook correctly.

You can also integrate it into lefthook or husky using npx or uvx commands!

Main workflow: add to pre-commit config, forget about it. Devs commit normally, hook validates/cleans messages before they hit history.

Target Audience

Teams enforcing commit conventions across polyglot projects. Devs using AI coding assistants who want clean commit history. Anyone who needs Conventional Commits validation without JavaScript dependencies.

Comparison

• commitlint (Node ecosystem, requires separate config for cleanups)

• cocogitto (Rust, focused on semver release workflows)

• gitlint (Python, extensible but requires custom plugins for AI signatures)

And many other tools of course, I cant claim this is original. The main difference is that gitfluff combines validation + pattern cleanup in one binary with prebuilt distributions for all major platforms.

As usual, if you like the tool, star github.com/Goldziher/gitfluff.