agnix
Linter for AI agent configurations. Validates SKILL.md, CLAUDE.md, hooks, MCP, and more.
457 rules | Real-time validation | Auto-fix | Multi-tool support
Installation
pip install agnix
Or run it without installing:
uvx agnix .
The wheels bundle a prebuilt binary, so there is no Rust toolchain to install
and nothing is downloaded after pip install. Supported platforms:
| Platform | Wheel |
|---|---|
| Linux x86_64 (glibc) | manylinux_*_x86_64 |
| Linux x86_64 (musl, e.g. Alpine) | musllinux_1_2_x86_64 |
| Linux aarch64 (glibc) | manylinux_*_aarch64 |
| macOS Apple silicon | macosx_11_0_arm64 |
| Windows x86_64 | win_amd64 |
On any other platform, install from source with cargo install agnix-cli.
Usage
Command line
# Lint current directory
agnix .
# Lint specific file
agnix CLAUDE.md
# Auto-fix issues
agnix . --fix
# JSON output
agnix . --format json
# Target a specific tool
agnix . --target claude-code
python -m agnix works the same way as the agnix script.
Python API
import agnix
# Version reported by the bundled binary
print(agnix.version())
# Lint a path and get parsed diagnostics
report = agnix.lint(".", tool="claude-code")
print(report["summary"])
# Anything else: pass arguments straight through
result = agnix.run(["--fix", "CLAUDE.md"])
print(result.returncode, result.stdout)
Links
License
MIT OR Apache-2.0
Metadata
Release files for agnix 0.55.0
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Built distributions (wheels)
| File | Reset | |||
|---|---|---|---|---|
| agnix-0.55.0-py3-none-win_amd64.whl | Python 3 | none | Windows x86-64 | Details |
| agnix-0.55.0-py3-none-musllinux_1_2_x86_64.whl | Python 3 | none | Linux musl 1.2+ x86-64 | Details |
| agnix-0.55.0-py3-none-manylinux_2_18_x86_64.whl | Python 3 | none | Linux glibc 2.18+ x86-64 | Details |
| agnix-0.55.0-py3-none-manylinux_2_18_aarch64.whl | Python 3 | none | Linux glibc 2.18+ ARM64 | Details |
| agnix-0.55.0-py3-none-macosx_11_0_arm64.whl | Python 3 | none | macOS 11.0+ ARM64 | Details |
Total release size: 17.4 MB
Release files / agnix-0.55.0-py3-none-win_amd64.whl
| Download URL | agnix-0.55.0-py3-none-win_amd64.whl |
|---|---|
| Size | 3.7 MB |
| Tags | Python 3 Windows x86-64 |
|
SHA-256 checksum How to use checksums |
9013079ecb09e977c402f1e2922f1adb1be97fd31c1241e1175ff364b8ddf0b8
|
|
BLAKE2b-256 checksum How to use checksums |
10f37e8c594ce496c7f91307028b8ab66094dd9f194ffeb9de72d24602b5605d
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/7.0.0 CPython/3.14.7
|
Release files / agnix-0.55.0-py3-none-musllinux_1_2_x86_64.whl
| Download URL | agnix-0.55.0-py3-none-musllinux_1_2_x86_64.whl |
|---|---|
| Size | 3.7 MB |
| Tags | Linux musl 1.2+ x86-64 Python 3 |
|
SHA-256 checksum How to use checksums |
5d1d61d41c91a376d6b979f5763ac68a031c3d87869cab999abab98dff5d5cbc
|
|
BLAKE2b-256 checksum How to use checksums |
8fc4309b249c0d6d98e8a0354a4c88f3d67e3728d4e3ac27e8bb851f42a3f569
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/7.0.0 CPython/3.14.7
|
Release files / agnix-0.55.0-py3-none-manylinux_2_18_x86_64.whl
| Download URL | agnix-0.55.0-py3-none-manylinux_2_18_x86_64.whl |
|---|---|
| Size | 3.6 MB |
| Tags | Linux glibc 2.18+ x86-64 Python 3 |
|
SHA-256 checksum How to use checksums |
16b8a91065125e18d13f0953c0d2af75f81899948dd27113512ffa390e7f0fcb
|
|
BLAKE2b-256 checksum How to use checksums |
c77739590a1b2c4f0c8c8848ece69a5bee90c9aa702149369d79193013da1c1a
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/7.0.0 CPython/3.14.7
|
Release files / agnix-0.55.0-py3-none-manylinux_2_18_aarch64.whl
| Download URL | agnix-0.55.0-py3-none-manylinux_2_18_aarch64.whl |
|---|---|
| Size | 3.3 MB |
| Tags | Linux glibc 2.18+ ARM64 Python 3 |
|
SHA-256 checksum How to use checksums |
6abb3128e4d34ca23f2557f57d729f8e7c1f88f8ba684a6bfb1a6edde8df2672
|
|
BLAKE2b-256 checksum How to use checksums |
010a1c7945abadd7072f5382ce1b4594df900ca9e1f599de36fda947201b4db4
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/7.0.0 CPython/3.14.7
|
Release files / agnix-0.55.0-py3-none-macosx_11_0_arm64.whl
| Download URL | agnix-0.55.0-py3-none-macosx_11_0_arm64.whl |
|---|---|
| Size | 3.1 MB |
| Tags | Python 3 macOS 11.0+ ARM64 |
|
SHA-256 checksum How to use checksums |
7b2e4f069b0d4c470ecf15cfe8bba12451b0448a4f54406616d8fe4cd063762f
|
|
BLAKE2b-256 checksum How to use checksums |
58c57cbb957ac9522bf4cc40f859bd16c559a44326a5093ab2a471fb9888a350
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/7.0.0 CPython/3.14.7
|