Installation

npm (recommended)

Works on all platforms. Includes pre-built binaries.

npm install -g agnix

Or run without installing:

npx agnix .

Homebrew (macOS / Linux)

brew tap agent-sh/agnix && brew install agnix

pip / uv

pip install agnix

Or run without installing:

uvx agnix .

The wheels bundle a pre-built binary, so no Rust toolchain is needed and nothing is downloaded after install. Wheels are published for Linux x86_64 (glibc and musl), Linux aarch64, macOS Apple silicon, and Windows x86_64; on any other platform, use cargo install agnix-cli.

python -m agnix runs the same binary, and a small Python API is available:

import agnix

report = agnix.lint(".", tool="claude-code")
print(agnix.version(), report["summary"])

Cargo (Rust toolchain)

cargo install agnix-cli

Pre-built binaries

Download from GitHub Releases for your platform.

Two Linux x86_64 archives are published:

Archive	Use it when
agnix-x86_64-unknown-linux-gnu.tar.gz	Default. Releases are gated to require no more than glibc 2.31; current builds need only 2.18.
agnix-x86_64-unknown-linux-musl.tar.gz	Statically linked, no glibc dependency. Use it on musl distros such as Alpine, or on any host where the gnu build reports a missing GLIBC_... version.

The npm installer and the GitHub Action pick the gnu build and switch to the static musl build automatically if it cannot run on the host.

Verify installation

agnix --version

Editor extensions

agnix ships editor integrations powered by the agnix-lsp server:

Editor	Install
VS Code	Marketplace
JetBrains	Plugin
Neovim	Plugin
Zed	Extension

See Editor Integration for setup details.