agnix
Linter for AI agent configurations. Validates SKILL.md, CLAUDE.md, hooks, MCP, and more.
454 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
1 maintainer
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distributions
Built Distributions
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file agnix-0.52.1-py3-none-win_amd64.whl.
File metadata
- Download URL: agnix-0.52.1-py3-none-win_amd64.whl
- Upload date:
- Size: 3.7 MB
- Tags: Python 3, Windows x86-64
- Uploaded using Trusted Publishing? No
- Uploaded via:
twine/7.0.0 CPython/3.14.7
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
db7abfd352cef123a464947c038a4689fee40e8bd6439de337fdf6dd3e4e1891
|
|
| MD5 |
13e4260841342e860780a38970cfe90f
|
|
| BLAKE2b-256 |
9ccbb725195c945e782f01155bd192a7beab3f55f75d3ed6dbc7ee860f1e7063
|
File details
Details for the file agnix-0.52.1-py3-none-musllinux_1_2_x86_64.whl.
File metadata
- Download URL: agnix-0.52.1-py3-none-musllinux_1_2_x86_64.whl
- Upload date:
- Size: 3.6 MB
- Tags: Python 3, musllinux: musl 1.2+ x86-64
- Uploaded using Trusted Publishing? No
- Uploaded via:
twine/7.0.0 CPython/3.14.7
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
dde252938da8705322405a26431e3a76d0ca472233292a3dfda4e581a841b485
|
|
| MD5 |
8014441a09ee25ae9fc8547e46367be2
|
|
| BLAKE2b-256 |
39145b86eee69fd8fa03e0b7db7872cfc73800ee9f44a9e60246ba7e250adcb5
|
File details
Details for the file agnix-0.52.1-py3-none-manylinux_2_18_x86_64.whl.
File metadata
- Download URL: agnix-0.52.1-py3-none-manylinux_2_18_x86_64.whl
- Upload date:
- Size: 3.6 MB
- Tags: Python 3, manylinux: glibc 2.18+ x86-64
- Uploaded using Trusted Publishing? No
- Uploaded via:
twine/7.0.0 CPython/3.14.7
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
015ec4cdc06a4585c4dd8715ea2ea7897753df890a719d4c465e616ec38a09a0
|
|
| MD5 |
b567e73e62692fb5611255db25a7528d
|
|
| BLAKE2b-256 |
637a8b622ef23dd05ab0d7e968ea3adcb6fdb620ff785c572058cffcfaa67f45
|
File details
Details for the file agnix-0.52.1-py3-none-manylinux_2_18_aarch64.whl.
File metadata
- Download URL: agnix-0.52.1-py3-none-manylinux_2_18_aarch64.whl
- Upload date:
- Size: 3.3 MB
- Tags: Python 3, manylinux: glibc 2.18+ ARM64
- Uploaded using Trusted Publishing? No
- Uploaded via:
twine/7.0.0 CPython/3.14.7
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
c626b13b55c2cc368bb4a60be6f3ce6588833242d5b1af2c4cd4d5ed09144f8c
|
|
| MD5 |
29eea7094f862346adf9907ba07742ec
|
|
| BLAKE2b-256 |
727b0bd14eefb8408a51c310251758f1cdf139e627c9098232fb670d6fb5e7cc
|
File details
Details for the file agnix-0.52.1-py3-none-macosx_11_0_arm64.whl.
File metadata
- Download URL: agnix-0.52.1-py3-none-macosx_11_0_arm64.whl
- Upload date:
- Size: 3.1 MB
- Tags: Python 3, macOS 11.0+ ARM64
- Uploaded using Trusted Publishing? No
- Uploaded via:
twine/7.0.0 CPython/3.14.7
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
277274c40a9b428a9fcc44f1c4484a0964962e3585737a2caef8a7e013cc3c81
|
|
| MD5 |
cca08ae7cfc000e914fac04c8ebcbdd1
|
|
| BLAKE2b-256 |
29b3de5963f033eaac6f07e8a1b379ebcb73d93a06982e8b7afe4058b1bf806e
|
