Skip to content

0.7.0

Choose a tag to compare

View all tags
@prom3theu5 prom3theu5 released this 22 Sep 22:28
0.7.0
f1cd5ec
This commit was created on GitHub.com and signed with GitHub’s verified signature.
GPG key ID: B5690EEEBB952194
Verified
Learn about vigilant mode.

What's Changed

  • feat(website): add landing page, docs and manual Pages deployment by @prom3theu5 in #13
  • feat(dashboard): add shared draft tags by @prom3theu5 in #14
  • docs(website): document dashboard tagging by @prom3theu5 in #15

Full Changelog: 0.6.0...0.7.0

Highlights

Shared dashboard tags

Organise drafts with pink tag chips and find related work without changing the documents themselves.

  • Add an existing tag or create one in a compact modal with keyboard navigation and autocomplete. Remove assignments through the chips in the detail pane.
  • Select multiple tags in the toolbar to match any selected tag, combined with repository, availability and text search. Use Untagged only to find drafts without labels, or Tag A–Z to sort by their first alphabetical tag.
  • Filters are saved in the dashboard URL. Live updates preserve filtering and an open tagging modal.
  • Tags are shared database metadata linked to draft IDs. They survive new uploads and availability changes without changing draft timestamps, versions, content or notifications.
  • Tagging is dashboard-only. There are no CLI/TUI commands, upload flags or automatic tags, and tags do not appear in exported HTML or PDFs.
  • Protected dashboards remain read-only and hide tag data when an API key is configured.

Tag names support lowercase ASCII letters, digits, spaces and hyphens, up to 32 characters. Each draft can have up to 20 tags.

Website and documentation

Adds the Keryx landing page and Starlight documentation, including a guide to dashboard tagging and filtering.

Upgrade from 0.6.0

Replace the binary and restart your server. An additive migration creates the tag catalogue and draft assignments on SQLite or Postgres, preserving existing records. Existing drafts start untagged. No database recreation or document re-upload is needed.

Install

The release workflow builds and attaches binaries and checksums for three targets. Downloads become available as those builds finish. If yours is not one of them, build from source. The release archives also include the README, licence, and ready-made Keryx agent skills.

Released binaries include S3 storage and OCI sharing.

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

Linux (x86-64)

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

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

sudo install -m755 keryx-0.7.0-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.7.0 --repo SimCubeLtd/keryx \
  --pattern 'keryx-0.7.0-aarch64-apple-darwin.tar.gz*'

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

sudo install -m755 keryx-0.7.0-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 prebuilt binary in this release. Build from source.

Windows (x86-64)

Run these commands in PowerShell:

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

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

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

$dir = "$env:LOCALAPPDATA\Programs\keryx-0.7.0-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.7.0 --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.7.0 --locked keryx

--locked uses the dependency versions in the committed Cargo.lock. Add --no-default-features for a lean build with neither S3 storage nor OCI sharing. The build needs Python 3 on the PATH, as earlier releases did, for the PDF renderer's style engine.

Contributors

prom3theu5
Assets 8
Loading