Installation

kanros ships as a single binary with no runtime dependencies. It is free to use — no license key, no account, no telemetry. Pick the installation path that matches your workflow.

The current release is v0.1.0-rc.4, a pre-release; the stable v0.1.0 release is still pending.

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 -fsSL 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 and KANROS_VERSION to pin a specific release tag such as v0.1.0-rc.1 (the default is latest):

curl -fsSL https://kanros.dev/install.sh | KANROS_INSTALL_DIR="$HOME/.local/bin" sh

The installer supports Linux x86_64 and macOS (Apple silicon and Intel). There is no prebuilt Linux ARM64 binary yet.

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.

First run

Confirm the install end to end with the smoke test bundled in the binary (offline echo provider — no API key, no network):

kanros init --example smoke && kanros run

See the quickstart for what it checks.

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

The kanros CLI is proprietary software, free for personal and internal business use, including in CI, under the kanros license. The license text ships in every archive as LICENSE, next to THIRD_PARTY_NOTICES (the licenses of the open-source components it includes). The binary runs entirely on your machine: it phones home for nothing — no telemetry, no license checks, no account.

Kanros Cloud, the hosted platform, is a separate commercial service governed by its Terms of Service.

Releases up to and including v0.1.0-rc.3 were distributed under Apache-2.0 OR MIT; copies of those releases keep those terms.