Release tooling. Cutting a release is now two commands instead of a manual, many-file
chore. No runtime or library changes — the crates and the binary are functionally identical
to 0.8.0.
Added
scripts/bump-version.ps1— bumps the version everywhere in one shot: the Cargo
workspace version + every inter-crate pin, Cargo.lock, the CHANGELOG[Unreleased]stamp,
and the current-version strings across the shipped docs (capability cards, install /
gh attestationexamples,koi-embeddeddependency recipes, thekoi statussample, the
http-apiversionfield, the CLIKOI_VERSIONexample). With no argument it
auto-increments the minor (0.8.0 → 0.9.0); it then commits all changes and pushes.
Historical version references are deliberately left untouched.scripts/release.ps1— tags the current Cargo version asv<version>and pushes it
(which firesrelease.yml: build → attest → GitHub Release → GHCR → crates.io), guarding
that the CHANGELOG section is stamped, the tag does not already exist, and the tree is clean.
Install
One line — detects your OS/arch, verifies the checksum, installs onto PATH:
# Linux / macOS
curl -fsSL https://raw.githubusercontent.com/sylin-org/koi/main/install.sh | sh# Windows (PowerShell)
irm https://raw.githubusercontent.com/sylin-org/koi/main/install.ps1 | iexContainer — multi-arch image on GHCR:
docker run --rm ghcr.io/sylin-org/koi:0.9.0 versionOr download a binary from the table below, extract, and place on your PATH.
Or via crates.io: cargo install koi-net.
Or build from source: git clone https://github.com/sylin-org/koi && cd koi && cargo build --release.
Then, for always-on discovery, install as a system service:
sudo koi install # Linux / macOS
koi install # Windows (Administrator)Downloads
| Platform | Architecture | Download |
|---|---|---|
| Linux | x86_64 | koi-v0.9.0-x86_64-unknown-linux-musl.tar.gz |
| Linux | aarch64 | koi-v0.9.0-aarch64-unknown-linux-musl.tar.gz |
| macOS | Intel | koi-v0.9.0-x86_64-apple-darwin.tar.gz |
| macOS | Apple Silicon | koi-v0.9.0-aarch64-apple-darwin.tar.gz |
| Windows | x86_64 | koi-v0.9.0-x86_64-pc-windows-msvc.zip |
| Windows | aarch64 | koi-v0.9.0-aarch64-pc-windows-msvc.zip |
Verify
Every archive and the container image carry a signed build-provenance
attestation (GitHub Artifact Attestations / Sigstore). Prove an artifact was built
by this repo's release workflow — not a mirror or a tampered copy:
# a downloaded binary archive
gh attestation verify koi-v0.9.0-x86_64-unknown-linux-musl.tar.gz --repo sylin-org/koi
# the container image
gh attestation verify oci://ghcr.io/sylin-org/koi:0.9.0 --repo sylin-org/koi(The install scripts verify the SHA-256 below automatically; the attestation is the
stronger, signed check.)
Checksums (SHA-256)
a4bb1072b0cdb4ea11d2a0a7f4629cfcdefd67a1d9759fe6f53c7bd6e83fba0b koi-v0.9.0-aarch64-apple-darwin.tar.gz
21b7483f17d623483ff68f5ad80694ef9f63aabafc6ce3af8f2b485e272b6cc7 koi-v0.9.0-aarch64-pc-windows-msvc.zip
fce7aeea5269a12ea87336401ebf1d7e4eab142a0ad7b32ec09888d2a3b1d6cc koi-v0.9.0-aarch64-unknown-linux-musl.tar.gz
b58677c6427db5667f261a9be14d924d66ff0dfadb4c2a5287d9ebb3d7d4bfb1 koi-v0.9.0-x86_64-apple-darwin.tar.gz
d664c7079b834dee65b4f928e16fa8563b64eecfcdba1194803e7024960e078c koi-v0.9.0-x86_64-pc-windows-msvc.zip
88baeb56eb806cc036e0460ada19d4f3c3e4b690a12384d41c3178e6aa32728b koi-v0.9.0-x86_64-unknown-linux-musl.tar.gz