Installation

kanros ships as a single static binary. It is free to use during early access — no license key, no account, no telemetry. Pick the installation path that matches your workflow.

Shell installer (macOS / Linux)

The shell installer discovers your platform, downloads the matching archive from kanros.dev, verifies the SHA-256 checksum, and drops the binary on your $PATH.

curl --proto '=https' --tlsv1.2 -LsSf https://kanros.dev/install.sh | sh

By default the installer places kanros in ~/.kanros/bin and prints the line to add to your shell profile. Set KANROS_INSTALL_DIR to override the destination, or pipe the script into a custom wrapper for fully scripted provisioning.

PowerShell installer (Windows)

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

This mirrors the shell installer for Windows hosts, dropping kanros.exe into %USERPROFILE%\.kanros\bin and adding it to your user PATH. Restart your shell so the new entry takes effect.

Direct download

Every release publishes tarballs (.tar.xz) for Unix targets and ZIPs for Windows, plus a SHA-256 checksum for each archive, on the download page. The supported targets are:

After download, verify the checksum (sha256sum kanros-*.tar.xz) against the corresponding .sha256 file, extract, and copy kanros somewhere on PATH:

tar -xJf kanros-aarch64-apple-darwin.tar.xz
sudo install -m 0755 kanros /usr/local/bin/

Homebrew (macOS / Linux)

A formula is planned for the GA release. Once the tap is live:

brew install kanros/tap/kanros

Subsequent upgrades are routine brew upgrade kanros. The formula tracks the latest stable release; pre-release builds are not surfaced via Homebrew.

Verifying your install

kanros --version

The output prints two lines: the binary semver and the kanros-core trait-layer semver. The two will normally match for tagged releases.

Shell completions

After installation, generate completions for your shell:

# bash
kanros completions bash > ~/.local/share/bash-completion/completions/kanros

# zsh
kanros completions zsh > "${fpath[1]}/_kanros"

# fish
kanros completions fish > ~/.config/fish/completions/kanros.fish

Restart your shell to pick up the new completions. See init, completions, auth for the full matrix.

Licensing

kanros is proprietary software, free of charge during the early-access period for both personal and commercial use. The binary runs entirely on your machine: it phones home for nothing — no telemetry, no license checks, no account. Pricing for post-GA releases will be announced ahead of time, and early-access versions will remain usable.