Installation

Assura ships as a prebuilt CLI. Normal usage does not require Rust. The latest published release is v0.4.1. A source checkout can contain later changes; those are not installed by the public release script until a new release is published.

Requirements

Linux, macOS, or Windows.

Install With Script

Linux and macOS:

curl -fsSL https://assura.dev/install.sh | sh

The installer detects your platform, downloads the matching published release archive, verifies its SHA-256 sidecar, and installs assura plus its internal assura-full companion into $HOME/.local/bin by default. It does not clone this repository or build from source. Override the destination with BIN_DIR:

curl -fsSL https://assura.dev/install.sh | sudo env BIN_DIR=/usr/local/bin sh

Windows PowerShell:

irm https://assura.dev/install.ps1 | iex

The PowerShell installer downloads and verifies assura-windows-amd64.zip, then installs assura.exe plus assura-full.exe into %LOCALAPPDATA%\Programs\Assura\bin by default. Override the destination with $env:BIN_DIR before running the script. The install directory is added to the current session and user PATH; restart other terminals after installation.

Supported Release Archives

Release and adoption smoke tests cover these installable archives:

Platform	Archive
Linux x86_64 (glibc)	`assura-linux-amd64.tar.gz`
Linux x86_64 (musl/Alpine)	`assura-linux-musl-amd64.tar.gz`
macOS Apple Silicon	`assura-macos-arm64.tar.gz`
macOS Intel	`assura-macos-amd64.tar.gz`
Windows x86_64	`assura-windows-amd64.zip`

Each smoke installs from a release-style archive and proves assura --version, assura init, assura status --format json, assura check --format json, a failing validation case, and an LS-Lint migration walkthrough.

Manual Release Archive

Download the latest archive for your platform from GitHub Releases. Extract the archive and keep assura plus assura-full in the same directory.

Linux x64:

curl -L https://github.com/rothnic/assura/releases/latest/download/assura-linux-amd64.tar.gz | tar xz
sudo install -m 755 assura assura-full /usr/local/bin/

Windows users can download assura-windows-amd64.zip, extract assura.exe and assura-full.exe, and place both files on PATH.

Each published archive has a .sha256 sidecar. Both one-line installers verify that sidecar before installing either executable.

Release archives include the public assura command and an internal assura-full companion used for less common commands such as init, migrate, and performance-report. Keep both files in the same directory and run assura.

Install With Cargo

Use Cargo only when you already have a Rust development environment:

cargo install assura

Build from Source

Source builds require Rust 1.86.0 or later.

git clone https://github.com/rothnic/assura
cd assura
cargo build --release

The binary is available at target/release/assura.

Verify

assura --version
assura-full --version
assura --help

Keep both executables together and confirm the selected version matches the release you intended to install. If the installer reports an older executable first on PATH, follow its correction and repeat these checks in a fresh shell.

The first useful project check is:

assura init --no-git-hooks
assura status --format json
assura check --format json .

See Adoption Walkthrough for the empty-project and LS-Lint migration paths used by CI.