install

Additional install commands

macOS

Homebrewverified · 100%

brew install gitlint

provider-native install command

overview

Package summary

Linting for your git commit messages

Project links

Homepage

Commands and aliases

gitlint

history

Project history and usage

Gitlint is a Python command-line linter for Git commit messages. It gives teams a way to enforce subject length, body formatting, trailers, conventional-commit-like rules, and custom policies before commits or merge requests land.

Project history

The GitHub repository was created in September 2015 and the PyPI package history begins with the 0.1.0 release. The project grew as a small but durable Git add-on with documentation, built-in rules, user-defined rules, hooks, and CI usage patterns.

The 0.14 and 0.15 releases marked the end of Python 2.7 and Python 3.5 support, while the 0.17 release split the package into gitlint and gitlint-core. The 0.19 release modernized build and test tooling, adopted Hatch and Ruff, and improved development builds.

Adoption history

Gitlint's adoption sits in the commit-quality niche rather than the broader code-linting market. It is packaged on PyPI and in several system package managers, and it appeals to projects that treat commit history as a reviewable interface for releases, changelogs, and audit trails.

How it is used

Practitioners run gitlint against the commit message being written through a commit-msg hook, against selected commit ranges in CI, or through pre-commit. Configuration usually lives in .gitlint, with built-in rules tuned by project policy and custom Python rules added for organization-specific checks.

Why package nerds care

Gitlint is notable as a classic Python CLI packaged across PyPI, Homebrew, Linux distributions, and MacPorts. For package maintainers, its dependency-management changes and gitlint-core split show the pressure small developer tools face when they need to support both hook-time speed and system-package constraints.

Timeline

2015: The jorisroovers/gitlint repository was created.
2020: The 0.14 and 0.15 release line ended Python 2.7 and Python 3.5 support.
2021: The 0.17 release split gitlint and gitlint-core.
2023: The 0.19 release modernized project tooling and CI.

Related projects

pre-commit is a common integration point for running gitlint before commits or in CI.
Conventional Commits is an adjacent convention supported through gitlint contrib rules and configuration.

Sources

security posture

Risk level: green

narrow executable package without higher-risk signals.

Risk classifier

green risk · low confidence · appliance

Why

narrow executable package without higher-risk signals

Signals

metadata:no-higher-risk-signals

Install behavior

No Homebrew bottle metadata was recorded.

Recommended review

Before unattended agent use, check whether the tool reads plaintext credentials, writes remote state, publishes artifacts, or shells out to plugins.

local files

Configuration and credential file locations

These source-backed paths show where this package keeps local settings or durable credentials. Automic Vault can use them as review targets for secret scanning, migration, and command approval.

Configuration files

Config paths the tool may read or write during local use.

Unix: .gitlint

executables

Installed executables

Command	Kind	Exposure	Note
`gitlint`	executable	indexed executable	Discovered from the local executable index.

freshness

Version and freshness

These signals separate page generation age, package-manager activity, and upstream release comparison. Version lag is warned only when an evidence URL and comparable versions are present.

page generated2026-08-03

manager version0.19.1

manager updated2026-07-13

local dataunknown

upstreamnot available

latest detectednot detected

okNo freshness warnings were generated.

install metadata

Package metadata

Package key	brew:gitlint
Version	0.19.1
Package manager	Homebrew
Homepage	https://jorisroovers.com/gitlint/
Last updated	2026-07-13T10:51:56Z
Pulse	updated
Bottle	not recorded
Service	none declared

package graph

Links come from deterministic package relationships, av.db category and tag curation, ecosystem matches, and package hub membership.

source trail

Generated from repository data

This page is generated by av-web from the private package SQLite artifact built by scripts/generate-pkg-sqlite.py.

Combined YAML source

View the package source record on GitHub.

combined/gitlint.yml

Used sources

Geiger risk classifier
Nucleus package database
curated configuration and credential file locations
curated package history
pkgdb category and tag curation

Install gitlint with Homebrew