Skip to content

keryx media versions

Description

List a media file's version history from the workspace's git-tracked ledger (spec 0040).

Every time a promoted media file's content changes and is pushed, keryx records a new version — V1, V2, V3 … — in the workspace's media.log, with the content hash, size, and timestamp. media.lock records which version is currently promoted. Both are committed to git, so the history travels with the repo and is diffable in review.

This is a pure local read: the ledger is in the repo, so no object store, credentials, or network are involved.

Usage

keryx media versions <file> -w <slug>
<file> Workspace-relative media path, e.g. vo/01.mp3, cards/02.png.
-w, --workspace The reel workspace slug (required).

Run keryx media versions --help for the authoritative, always-current flag set.

Output

vo/01.mp3 — 3 version(s)

   version  size  recorded              content
   v1       9     2026-07-25T07:58:33Z  83ce8fcad067
   v2       22    2026-07-25T07:58:33Z  b3d07fa57253
*  v3       11    2026-07-25T07:58:33Z  ca7d648f73da

* = currently promoted. Roll back with `keryx media rollback vo/01.mp3 <version> -w <slug>`.

With --output json, the envelope carries {file, current, versions:[…]}.

See also

  • keryx media rollback — repoint a file at an earlier version.
  • keryx media — the storage model and configuration.
  • Spec: docs/development/specs/0040-pluggable-object-stores.md