Install the Agenomic CLI

agenomic is the open-source Rust CLI for validating, bundling, attesting, and replaying agent definitions. The one-liner below downloads a pre-built binary from the latest GitHub release, verifies its SHA-256 checksum, and installs it into ~/.local/bin.

Quick install

curl -fsSL https://agenomic.io/install.sh | sh

The script is POSIX-sh compatible and uses either curl or wget, whichever is on PATH. It never asks for sudo — by default it installs into your home directory.

After installation, make sure ~/.local/bin is on your PATH, then verify:

agenomic --version
agenomic --help

Pinning a version

For reproducible CI builds, pin to a specific release tag. The installer reads two environment variables:

Variable	Default	Effect
AGENOMIC_VERSION	latest	Pin to a specific release tag, e.g. v0.4.2.
AGENOMIC_INSTALL_DIR	~/.local/bin	Where the binary lands. The script does not edit PATH.

Example — install v0.4.2 into /usr/local/bin (system-wide, requires sudo):

curl -fsSL https://agenomic.io/install.sh \
  | AGENOMIC_VERSION=v0.4.2 \
    AGENOMIC_INSTALL_DIR=/usr/local/bin \
    sudo -E sh

Supported platforms

OS	Architecture	Rust target
Linux	x86_64	x86_64-unknown-linux-gnu
Linux	aarch64 / arm64	aarch64-unknown-linux-gnu
macOS	x86_64 (Intel)	x86_64-apple-darwin
macOS	arm64 (Apple Silicon)	aarch64-apple-darwin

Other platforms (Windows, FreeBSD, musl Linux, ...) install from source with Cargo:

cargo install --git https://github.com/agenomic/agenomic-cli agenomic-cli

What the script does

Detects uname -s / uname -m and maps to a Rust release target.
Downloads agenomic-<target>.tar.gz and checksums.txt from the matching GitHub release.
Verifies the archive's SHA-256 against checksums.txt using shasum -a 256. Bails out on mismatch.
Extracts the archive and moves agenomic (and agm, the short alias) into the install directory.

The script does not touch ~/.bashrc, ~/.zshrc, or anything outside $AGENOMIC_INSTALL_DIR. Uninstall by deleting the two binaries.

Inspect before you pipe to sh

If you'd rather read the script before running it — always a good habit for curl | sh commands — dump it first:

curl -fsSL https://agenomic.io/install.sh -o install.sh
less install.sh
sh ./install.sh

The script source of truth lives in the agenomic-cli repo. The endpoint here mirrors that file.

Next steps

With the CLI installed, build and attest your first bundle:

agenomic validate ./my-agent --level strict
agenomic build ./my-agent --output dist/my-agent.bundle.tar.zst
agenomic attest dist/my-agent.bundle.tar.zst --output attestation.json

The full command reference and the bundle format spec live in the agenomic-cli docs.

This page is indexable. The installer endpoint is plain HTTP with a short CDN cache so a new CLI release is visible within five minutes.