adrlint
A fast Rust CLI that lints and formats MADR architecture decision records: structure, numbering, Markdown quality, and immutability of accepted decisions.
Installation
pip install adrlint
Each supported platform has its own wheel with the binary inside, so pip installs it without
fetching anything else: Linux x86_64/aarch64 (manylinux for glibc, musllinux for musl), macOS
x86_64/arm64 and Windows x86_64/arm64.
On any other host pip falls back to the pure-Python py3-none-any wheel, which downloads the
pre-compiled binary on first run and verifies it against the release checksum manifest.
Set ADRLINT_BINARY to use an existing executable instead of the bundled or downloaded one.
Usage
adrlint init # write .adrlint.toml and docs/adr
adrlint lint # check every ADR
adrlint new "Use PostgreSQL" # create the next sequential ADR
adrlint lint --format github # GitHub annotations for CI
Documentation
Rules, configuration, locking and the full CLI reference: https://github.com/polylint/adrlint
polylint organization
adrlint is part of polylint, high-performance Rust linters and
formatters built for agentic workflows. Sibling tools: polylint
(one linter and formatter for every language; it can run adrlint as an engine via poly adr),
skif (JS/TS dependency linter), and
uncomment (comment removal and linting). Install any of them
from the Homebrew tap (brew tap polylint/tap) or the Scoop bucket
(scoop bucket add polylint https://github.com/polylint/scoop-bucket).
License
MIT — see LICENSE.
Metadata
Release files for adrlint 0.5.2
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Built distributions (wheels)
Total release size: 60.3 MB
Release files / adrlint-0.5.2-py3-none-win_arm64.whl
| Download URL | adrlint-0.5.2-py3-none-win_arm64.whl |
|---|---|
| Size | 6.5 MB |
| Tags | Python 3 Windows ARM64 |
|
SHA-256 checksum How to use checksums |
d9389ae7de5a0ab4a4b1577469e5728c7d73498afb7cc0001525f28e74f4326a
|
|
BLAKE2b-256 checksum How to use checksums |
d1355ee57ddfd714883d9390e946ac8f2096a4dcbc91139a2a40763a71a425f7
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.16
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Nov 16, 2026.
Transparency logRelease files / adrlint-0.5.2-py3-none-win_amd64.whl
| Download URL | adrlint-0.5.2-py3-none-win_amd64.whl |
|---|---|
| Size | 7.0 MB |
| Tags | Python 3 Windows x86-64 |
|
SHA-256 checksum How to use checksums |
f02e852491f55ec652a5c6c07504d0dcba2e688c56bd6d243b5e93965d4f9603
|
|
BLAKE2b-256 checksum How to use checksums |
3494012ad48a4d7f9bdc510248a86e6d80eb9a37d59a0e63801d6c2f6e872f71
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.16
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Nov 16, 2026.
Transparency logRelease files / adrlint-0.5.2-py3-none-musllinux_1_2_x86_64.whl
| Download URL | adrlint-0.5.2-py3-none-musllinux_1_2_x86_64.whl |
|---|---|
| Size | 8.3 MB |
| Tags | Linux musl 1.2+ x86-64 Python 3 |
|
SHA-256 checksum How to use checksums |
9ca44667cb3e3ff96178332029ecf3b11ca544c3116f235df6fe0224a8b8f68e
|
|
BLAKE2b-256 checksum How to use checksums |
08cbc765356d60847c7f139b4fb2d115abcf1bda2a63d72758bfa4151563f6f2
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.16
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Nov 16, 2026.
Transparency logRelease files / adrlint-0.5.2-py3-none-musllinux_1_2_aarch64.whl
| Download URL | adrlint-0.5.2-py3-none-musllinux_1_2_aarch64.whl |
|---|---|
| Size | 7.8 MB |
| Tags | Linux musl 1.2+ ARM64 Python 3 |
|
SHA-256 checksum How to use checksums |
30a293dd4a11980f72e9bfd7c0d696aa68a7e30f1520bebe84fb91e978c27b46
|
|
BLAKE2b-256 checksum How to use checksums |
097416a53058bde5b9b08810d2f14f47dce6390b99cdc8e1b18dfa93c79cecf2
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.16
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Nov 16, 2026.
Transparency logRelease files / adrlint-0.5.2-py3-none-manylinux_2_28_x86_64.whl
| Download URL | adrlint-0.5.2-py3-none-manylinux_2_28_x86_64.whl |
|---|---|
| Size | 8.0 MB |
| Tags | Linux glibc 2.28+ x86-64 Python 3 |
|
SHA-256 checksum How to use checksums |
5018d45b75ace0a66c2f129613ab15d7dba55e4fd28b9bbba70999e7fd4b1736
|
|
BLAKE2b-256 checksum How to use checksums |
09a70116d39eac66338f82cea708346874a6415bbbd883ea2491e16c8b99b004
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.16
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Nov 16, 2026.
Transparency logRelease files / adrlint-0.5.2-py3-none-manylinux_2_28_aarch64.whl
| Download URL | adrlint-0.5.2-py3-none-manylinux_2_28_aarch64.whl |
|---|---|
| Size | 7.8 MB |
| Tags | Linux glibc 2.28+ ARM64 Python 3 |
|
SHA-256 checksum How to use checksums |
b0c8d9693fe6e61a04a777c1ef30059159eef27cb328cbd2036276ba029278c1
|
|
BLAKE2b-256 checksum How to use checksums |
d36e1e34f75e8c0dedd12a1bead76fcde885b3cec4d35833cb96a626ab4e753b
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.16
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Nov 16, 2026.
Transparency logRelease files / adrlint-0.5.2-py3-none-macosx_11_0_arm64.whl
| Download URL | adrlint-0.5.2-py3-none-macosx_11_0_arm64.whl |
|---|---|
| Size | 7.3 MB |
| Tags | Python 3 macOS 11.0+ ARM64 |
|
SHA-256 checksum How to use checksums |
921567366148c744449c65a96ae450a28d0bab5411884ad339592b566472b6bb
|
|
BLAKE2b-256 checksum How to use checksums |
238d4f0ad49ba9cf442cdbc5c87503d9e2239eeeaa218c423423442d1c11ed2a
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.16
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Nov 16, 2026.
Transparency logRelease files / adrlint-0.5.2-py3-none-macosx_10_12_x86_64.whl
| Download URL | adrlint-0.5.2-py3-none-macosx_10_12_x86_64.whl |
|---|---|
| Size | 7.6 MB |
| Tags | Python 3 macOS 10.12+ x86-64 |
|
SHA-256 checksum How to use checksums |
c426eb6d10e3f5d96ef1ff6f1c13237386eb3b71e894dcee524243c83a54d9da
|
|
BLAKE2b-256 checksum How to use checksums |
986542f7edda45b545c6214343fc3afacac80c3beadc0b0cc9cd7ebf34e00485
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.16
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Nov 16, 2026.
Transparency logRelease files / adrlint-0.5.2-py3-none-any.whl
| Download URL | adrlint-0.5.2-py3-none-any.whl |
|---|---|
| Size | 7.9 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
e7e0cd255f92a561c86b883959626af488f490d3da3df427fc4fbad183cb2a21
|
|
BLAKE2b-256 checksum How to use checksums |
86438806b3454a0a62cfebb407f21c4009fe598d3b2fe225af88e789d9df143e
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.16
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Nov 16, 2026.
Transparency logSecurity for adrlint 0.5.2
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
Full provenance
All 9 files in this release have been uploaded with provenance metadata.
Attestation for adrlint-0.5.2-py3-none-win_arm64.whl
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Nov 16, 2026.
Transparency logA note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
To learn more about protecting yourself from malicious actors, visit our package security documentation.