Skip to content

Changelog

The authoritative, per-version changelog lives on the GitHub releases page:

This page does not mirror the notes. A copy here would go stale between builds, so this page points at that single source.

Read a release’s notes before you upgrade across a minor version. The notes for 0.14.0 and 0.14.1 open with hand-written sections, above the list of changes. Those sections hold the upgrade steps (“Upgrade first” in 0.14.0, “Upgrade notes” in 0.14.1), any breaking changes, and the known limits.

Every release’s notes end with a list of changes. It is generated from the commit subjects at tag time (via git-cliff, grouped by conventional-commit type).

murk is pre-1.0 and uses Semantic Versioning. Before 1.0, a minor bump (0.13 to 0.14) may break compatibility. Patch bumps are fixes and additions.

A newer murk reads vaults written by older 0.x versions, but a vault written by a newer murk may not open in an older one. For example, murk 0.14 changed the vault format to 3.0, and murk 0.13 cannot read a 3.0 vault. The roadmap lists the format guarantee 1.0 will add.

Pick a version from the releases page, then install it:

Terminal window
cargo install murk-cli --version X.Y.Z

To pin the separate Python library instead, run pip install murk-secrets==X.Y.Z. It does not include the CLI.

Pre-built binaries for each release are attached to its GitHub release. Recent releases carry signed build provenance on every channel (the crates.io package from 0.13.0). See verifying releases for what each version has and how to check it before you trust a downloaded artifact.