# Install gitlint with Homebrew, apk, apt, dnf, MacPorts, Nix, zypper

Linting for your git commit messages. Version 0.19.1 via Homebrew; verified from local package data.

## Install

```sh
sudo av install brew:gitlint
```

Additional install commands:

### macOS

- Homebrew (100%):

```sh
brew install gitlint
```

  Evidence: local Homebrew formula metadata

- MacPorts (94%):

```sh
sudo port install gitlint
```

  Evidence: MacPorts ports tree: devel/gitlint/Portfile from https://api.github.com/repos/macports/macports-ports/git/trees/master?recursive=1

### Linux

- apk (92%):

```sh
sudo apk add gitlint
```

  Evidence: Alpine Linux edge package indexes: gitlint from https://dl-cdn.alpinelinux.org/alpine/edge/community/x86_64/APKINDEX.tar.gz

- Debian apt (92%):

```sh
sudo apt install gitlint
```

  Evidence: Debian stable package indexes: gitlint from https://deb.debian.org/debian/dists/stable/main/binary-amd64/Packages.xz

- dnf (92%):

```sh
sudo dnf install gitlint
```

  Evidence: Fedora Rawhide package metadata: gitlint from https://dl.fedoraproject.org/pub/fedora/linux/development/rawhide/Everything/x86_64/os/repodata/e5ca8ce900cd68f5419e1c39ae517343100b306336cbaeb70a3c153121d95094-primary.xml.zst

- Nix (92%):

```sh
nix profile install nixpkgs#gitlint
```

  Evidence: nixpkgs package indexes: pkgs/by-name/gi/gitlint/package.nix from https://api.github.com/repos/NixOS/nixpkgs/git/trees/master?recursive=1

- zypper (92%):

```sh
sudo zypper install python313-gitlint
```

  Evidence: openSUSE Tumbleweed package metadata: python313-gitlint from https://download.opensuse.org/tumbleweed/repo/oss/repodata/be8d3611d25469107f32075a1697e69ec57a2b850b42348a658cc671ad5ec2b50760d02c3e59524d50da9a11d5be799bdaffba2e166e8ca8858512e3c0bd665d-primary.xml.zst

## Package facts

- **Package key:** brew:gitlint
- **Package manager:** Homebrew
- **Package manager page:** <https://formulae.brew.sh/formula/gitlint>
- **Version:** 0.19.1
- **Source summary:** Linting for your git commit messages
- **Homepage:** <https://jorisroovers.com/gitlint/>
- **Repository:** <https://github.com/jorisroovers/gitlint>
- **Upstream docs:** <https://jorisroovers.github.io/gitlint>
- **License:** MIT
- **Source archive:** <https://files.pythonhosted.org/packages/73/51/b59270264aabcab5b933f3eb9bfb022464ca9205b04feef1bdc1635fd9b4/gitlint_core-0.19.1.tar.gz>
- **Generated:** 2026-07-08T07:18:31+00:00

## Executables

- gitlint (cli)
- gitlint (alias)

## Dependencies

- python@3.14

## Install behavior

- Post-install hook: not defined
- Bottle: available on all

## Freshness

- Page generated: 2026-07-08
- Package-manager version: 0.19.1
- Local data: ok
- Upstream repository: https://jorisroovers.com/gitlint/
- info: No package-manager update timestamp was available.
- info: Release/tag comparison is only available for GitHub repositories.
## 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

- <https://formulae.brew.sh/formula/gitlint>
- <https://github.com/jorisroovers/gitlint>
- <https://jorisroovers.github.io/gitlint/>
- <https://pypi.org/pypi/gitlint/json>
- <https://raw.githubusercontent.com/jorisroovers/gitlint/main/CHANGELOG.md>
- <https://raw.githubusercontent.com/jorisroovers/gitlint/main/README.md>


## Security Notes

narrow executable package without higher-risk signals.

- **Geiger risk:** green / low
- narrow executable package without higher-risk signals


## 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

- Unix: .gitlint
## Source Database Details

- **Source Database:** Homebrew formula API
- **Tap:** homebrew/core
- **Full Name:** gitlint
- **Version Scheme:** 0
- **Revision:** 0
- **Bottle Stable Root URL:** <https://ghcr.io/v2/homebrew/core>
- **Deprecated:** no
- **Disabled:** no
- **Keg Only:** no
- **URL Keys:** stable

## Other Package-Manager Records

- Debian apt - gitlint - 0.19.1-6: normalized package name match | Debian stable package indexes: gitlint from https://deb.debian.org/debian/dists/stable/main/binary-amd64/Packages.xz | Git commit message linter | https://jorisroovers.com/gitlint/
- Nix - gitlint: normalized package name match | nixpkgs package indexes: pkgs/by-name/gi/gitlint/package.nix from https://api.github.com/repos/NixOS/nixpkgs/git/trees/master?recursive=1
- Ubuntu apt - gitlint - 0.19.1-2: normalized package name match | Ubuntu 24.04 LTS package indexes: gitlint from https://archive.ubuntu.com/ubuntu/dists/noble/universe/binary-amd64/Packages.gz | Git commit message linter | https://jorisroovers.com/gitlint/
- apk - gitlint - 0.19.1-r3: normalized package name match | Alpine Linux edge package indexes: gitlint from https://dl-cdn.alpinelinux.org/alpine/edge/community/x86_64/APKINDEX.tar.gz | Linting for your git commit messages | https://github.com/jorisroovers/gitlint
- apk - gitlint-pyc - 0.19.1-r3: normalized package name match | Alpine Linux edge package indexes: gitlint-pyc from https://dl-cdn.alpinelinux.org/alpine/edge/community/x86_64/APKINDEX.tar.gz | Precompiled Python bytecode for gitlint | https://github.com/jorisroovers/gitlint
- dnf - gitlint - 0.19.1-2.fc45: normalized package name match | Fedora Rawhide package metadata: gitlint from https://dl.fedoraproject.org/pub/fedora/linux/development/rawhide/Everything/x86_64/os/repodata/e5ca8ce900cd68f5419e1c39ae517343100b306336cbaeb70a3c153121d95094-primary.xml.zst | Git commit message linting tool | https://jorisroovers.github.io/gitlint
- zypper - python313-gitlint - 0.18.0-2.7: normalized package name match | openSUSE Tumbleweed package metadata: python313-gitlint from https://download.opensuse.org/tumbleweed/repo/oss/repodata/be8d3611d25469107f32075a1697e69ec57a2b850b42348a658cc671ad5ec2b50760d02c3e59524d50da9a11d5be799bdaffba2e166e8ca8858512e3c0bd665d-primary.xml.zst | Git commit message linter checking | https://github.com/jorisroovers/gitlint
- MacPorts - gitlint: normalized package name match | MacPorts ports tree: devel/gitlint/Portfile from https://api.github.com/repos/macports/macports-ports/git/trees/master?recursive=1


## Related links

- [Source-control packages](https://www.automicvault.com/pkg/source-control-tools/) - Belongs to a source-control command family.
- [Terminal utility packages](https://www.automicvault.com/pkg/terminal-utilities/) - Matched terminal and command-line workflow metadata.
- [Text processing packages](https://www.automicvault.com/pkg/text-processing-tools/) - Matched text, document, or structured-data processing metadata.
- [Developer build packages](https://www.automicvault.com/pkg/developer-build-tools/) - Matched build, compiler, generator, or developer workflow metadata.
- [python@3.14](https://www.automicvault.com/pkg/brew/python-3-14/) - Runtime dependency declared by Homebrew.
- [actionlint](https://www.automicvault.com/pkg/brew/actionlint/) - Shares av.db curated category or tags: ci, cli, developer-tools, linting.
- [doc8](https://www.automicvault.com/pkg/brew/doc8/) - Shares av.db curated category or tags: cli, developer-tools, linter, linting.
- [editorconfig-checker](https://www.automicvault.com/pkg/brew/editorconfig-checker/) - Shares av.db curated category or tags: ci, cli, developer-tools, linting.
- [elvis](https://www.automicvault.com/pkg/brew/elvis/) - Shares av.db curated category or tags: cli, developer-tools, linter, linting.
- [falco](https://www.automicvault.com/pkg/brew/falco/) - Shares av.db curated category or tags: cli, developer-tools, linter, linting.
- [golangci-lint](https://www.automicvault.com/pkg/brew/golangci-lint/) - Shares av.db curated category or tags: ci, cli, developer-tools, linting.
- [htmlhint](https://www.automicvault.com/pkg/brew/htmlhint/) - Shares av.db curated category or tags: cli, developer-tools, linter, linting.
- [iblinter](https://www.automicvault.com/pkg/brew/iblinter/) - Shares av.db curated category or tags: cli, developer-tools, linter, linting.
- [proselint](https://www.automicvault.com/pkg/brew/proselint/) - Both packages touch the same language runtime or ecosystem. Shared terms: cli, developer, developer-tools, linter, linting.
- [rst-lint](https://www.automicvault.com/pkg/brew/rst-lint/) - Both packages touch the same language runtime or ecosystem. Shared terms: cli, developer, developer-tools, linter, linting.

## Combined YAML source

View the package source record on GitHub. [combined/gitlint.yml](https://github.com/automic-vault/db/blob/main/combined/gitlint.yml)


## Sources

- Nucleus package database
- Geiger risk classifier
- package-page enrichment
- curated configuration and credential file locations
- curated package history
- package version freshness
- av.db category and tag curation
- package relationship graph
- external package-manager database matches
- cross-ecosystem install command graph
