0.4.1

What's changed

• Add direct version-history navigation, reusable release caches, and upload-provenance guidance by @prom3theu5 in #6

Full changelog: v0.4.0...0.4.1

---

Highlights

Keryx 0.4.1 makes dashboard navigation less disruptive and fixes release builds that recompiled every dependency for each tag.

Open drafts and stored versions in new tabs

• Open draft titles and Open document actions in a new browser tab, so the dashboard stays available.
• Open any immutable version directly from the version-history row.
• See the eight newest versions first.
• Use Load older versions to reveal the remaining history without infinite scrolling.

Reuse release build caches

GitHub scopes caches by branch or tag. The release event now dispatches the build from the default branch, where later releases can reuse the same cache. Each build still checks out the requested tag and verifies that the tag matches the version in Cargo.toml.

The release toolchain is pinned to nightly-2026-08-20. Compiler updates now happen deliberately instead of invalidating the cache whenever nightly changes.

The first build in the new default-branch scope seeds each platform cache. Later builds can restore those cached dependencies.

Preserve upload provenance

The bundled HTML communication skill now requires the keryx upload command to run from the repository checkout. The HTML source can still live under /tmp/keryx; Keryx records provenance from the directory where the command runs.

Upgrade

No manual data migration is required. Replace the binary and restart keryx serve.

Install

Binaries are attached below for three targets. If yours is not one of them, build from source. The release archives also include the README, licence, and ready-made Keryx agent skills.

Platform	Asset
Linux, x86-64 (glibc 2.35+)	keryx-0.4.1-x86_64-unknown-linux-gnu.tar.gz
macOS, Apple Silicon	keryx-0.4.1-aarch64-apple-darwin.tar.gz
Windows, x86-64	keryx-0.4.1-x86_64-pc-windows-msvc.zip

Linux (x86-64)

gh release download 0.4.1 --repo SimCubeLtd/keryx \
  --pattern 'keryx-0.4.1-x86_64-unknown-linux-gnu.tar.gz*'

sha256sum -c keryx-0.4.1-x86_64-unknown-linux-gnu.tar.gz.sha256
tar -xzf keryx-0.4.1-x86_64-unknown-linux-gnu.tar.gz

sudo install -m755 keryx-0.4.1-x86_64-unknown-linux-gnu/bin/keryx /usr/local/bin/
keryx --version

For a single-user install with no sudo, use ~/.local/bin instead and make sure it is on your PATH.

macOS (Apple Silicon)

gh release download 0.4.1 --repo SimCubeLtd/keryx \
  --pattern 'keryx-0.4.1-aarch64-apple-darwin.tar.gz*'

shasum -a 256 -c keryx-0.4.1-aarch64-apple-darwin.tar.gz.sha256
tar -xzf keryx-0.4.1-aarch64-apple-darwin.tar.gz

sudo install -m755 keryx-0.4.1-aarch64-apple-darwin/bin/keryx /usr/local/bin/
keryx --version

The binary is not code-signed or notarised. Downloading through a browser can attach a quarantine flag and cause Gatekeeper to refuse it. Clear the flag once with:

xattr -d com.apple.quarantine /usr/local/bin/keryx

Intel Macs do not have a native binary. Build from source, or run the Apple Silicon build under Rosetta 2. Rosetta 2 is unsupported and untested for this release.

Windows (x86-64)

Run these commands in PowerShell:

gh release download 0.4.1 --repo SimCubeLtd/keryx `
  --pattern 'keryx-0.4.1-x86_64-pc-windows-msvc.zip*'

# Compare the archive against the published checksum.
Get-FileHash keryx-0.4.1-x86_64-pc-windows-msvc.zip -Algorithm SHA256
Get-Content keryx-0.4.1-x86_64-pc-windows-msvc.zip.sha256

Expand-Archive keryx-0.4.1-x86_64-pc-windows-msvc.zip -DestinationPath $env:LOCALAPPDATA\Programs

$dir = "$env:LOCALAPPDATA\Programs\keryx-0.4.1-x86_64-pc-windows-msvc\bin"
[Environment]::SetEnvironmentVariable(
  'Path', [Environment]::GetEnvironmentVariable('Path','User') + ";$dir", 'User')

Open a new terminal, then run keryx --version.

The executable is unsigned, so SmartScreen can warn on first run. The installation does not require administrator rights.

Build from source (any platform)

Install the pinned Rust nightly toolchain, then run:

rustup toolchain install nightly-2026-08-20 --profile minimal
git clone --branch 0.4.1 --depth 1 https://github.com/SimCubeLtd/keryx.git
cd keryx
cargo +nightly-2026-08-20 build --release --locked
./target/release/keryx --version

To install the tagged release into ~/.cargo/bin, run:

cargo +nightly-2026-08-20 install --git https://github.com/SimCubeLtd/keryx \
  --tag 0.4.1 --locked keryx

--locked uses the dependency versions in the committed Cargo.lock.