Skip to content

Feature status

murk sorts its features into two groups. Core features are what murk is for. They are tested the most and are the ones to build on. Experimental features work and ship in every release, but they are newer, rely on narrower guarantees than they may seem to, or have had little testing against the tools they work with. Their behavior, flags or file layout may change in a minor release. murk does not print a warning when you use them; this page, the guides and murk --help mark them instead.

murk has no admin role. Every recipient except agent grants can add and remove recipients, manage groups, set the policy and mint grants. Group-only and personal values stay protected from recipients outside the group. Changes are attributable through vault signatures (keys that cannot sign, such as hardware and ssh-rsa keys, rely on signed git commits).

Feature What it covers
Shared secrets init, add, generate, get, exec, export, ls, info, rm, import, rotate and describe.
Personal overrides --group me: a value only you can read, which overrides the shared one.
Recipients murk circle with age and SSH keys (ssh:): list, authorize and revoke recipients.
Offboarding circle revoke --rotate and rotate --list.
Vault integrity The vault format and its MAC, checked by murk verify.
Key recovery The 24-word BIP39 phrase, murk recover and murk restore.
Leak checks murk scan, murk doctor and the pre-commit hook.
direnv murk env and loading secrets on cd.
Install Homebrew, cargo install murk-cli and install.sh, with verified releases.
Library bindings Reading secrets from Python (murk-secrets on PyPI) and Node.js.
Feature Why it is experimental
Agent grants, agent exec, murk mcp, agent connect/disconnect New, and their access rules changed in 0.14. A guardrail, not a security boundary.
Agent policy (murk policy, --allow-tag) Limits which tagged secrets agents receive. A guardrail, not access control.
Named groups (murk group, --group NAME) Newer than the shared and personal layers, with less test coverage across update paths.
Signatures and signer pinning New in 0.14: the trust pin, murk trust and the signed form may change in a minor release. Keys that cannot sign (hardware, ssh-rsa) leave a vault unsigned and rely on signed git commits, and the first trust decision on a machine is yours to check.
Strict mode (MURK_STRICT) A short list of specific checks, not a guarantee that no plaintext reaches disk.
murk edit The edit lifecycle is new, and its process handling is Unix-only.
Git merge driver Few tests run a real git merge. Review a merged vault before you push it.
murk diff New in its present form: it reports recipient, signer, policy, grant and group changes as well as secrets, and its output may change in a minor release.
GitHub recipients (github:) Keys are fetched over the network and trusted on first use.
Hardware and plugin identities No test runs a real plugin yet, and once a plugin recipient exists every writer needs the plugin installed.
Node.js writes (add, describe) The write API is new. Reading from Node.js is stable.