gitlint-rai 1.0.1

Gitlint plugin for RAI footer validation

gitlint-rai

A gitlint plugin that enforces exactly one thing:
if AI touched the code, say so in the commit. ⚖️

That’s it. No philosophy, no negotiations. Pick a trailer and move on.

⭐ Found this useful? Star the repo.

Installation 🔧

pip install gitlint-rai

Or with uv, which is objectively the better choice:

uv add gitlint-rai

Usage 🚦

Run the bundled wrapper — it loads the RAI rules automatically and accepts all gitlint arguments:

gitlint-rai
gitlint-rai --msg-filename .git/COMMIT_EDITMSG

Prefer plain gitlint? Point your .gitlint config at the installed package:

[general]
extra-path=/path/to/site-packages/gitlint_rai

Get that path with:

python -c "import gitlint_rai, pathlib; print(pathlib.Path(gitlint_rai.__file__).parent)"

To verify the rule loaded:

gitlint-rai --debug

Look for rai-footer-exists and rai-signed-off-by in the loaded-rules output. If you see them, the plugin is active and doing its job.

Both rules are enforced by default: rai-footer-exists (UC1) requires an AI attribution trailer, and rai-signed-off-by (UC2) requires the Signed-off-by: Your Name <email> footer that git commit -s adds. To skip sign-off enforcement, add ignore=rai-signed-off-by under [general] in your .gitlint.

Valid Trailers 📌

Pick the one that matches the majority AI contribution. Skip it entirely and the commit fails. Extra footers are fine — the rule only checks that at least one valid footer exists.

This is not a debate.

1. Authored-by: [Human] <email> — all you, no AI involved
2. Commit-generated-by: [AI Tool] <email> — AI wrote the commit message, you wrote the code
3. Assisted-by: [AI Tool] <email> — AI helped some, you were driving
4. Co-authored-by: [AI Tool] <email> — roughly 50/50, like actual pair programming
5. Generated-by: [AI Tool] <email> — AI did most of it, you supervised

All patterns are case-insensitive, because life is too short for that kind of pedantry.

Why This Exists ⚖️

Git already supports trailers. Commits already support attribution. What they don’t do is require you to be honest when AI is involved.

This plugin exists to make that honesty boring, consistent, and automatic, so nobody has to reconstruct intent later by reading commit history like tea leaves.

If you want the longer reasoning behind this, it lives at Did AI Erase Attribution?.

This plugin is the practical follow-through.

Requirements ⚙️

• Python >= 3.11, < 3.15
• gitlint >= 0.19.1

License 📄

PolyForm Shield License 1.0.0 — free to use anywhere, including inside commercial products. What's off the table: providing anything that competes with this tool — selling it, rebranding it, hosting it, or shipping a practical substitute, paid or free. This is a plain-language summary; the LICENSE is what actually controls. Commercial licensing questions: [e-mail].