Skip to content

vaultfold history

Show the history of an entry, a field, an agent session or the policy chain, newest first.
vaultfold history <address> [--reveal] every put, remove, move, resolve and meta of an entry, or of one field with #field
vaultfold history --session <id> every valid event an agent session wrote (a unique prefix of 8 or more hex characters is enough)
vaultfold history --policy the policy chain: members, devices, roles, collections, epochs
Values are never shown without --reveal, which agent sessions cannot use.
An entry removed as a whole cannot be addressed, so its history is not shown. In --session, its rows
show the path (removed entry), and a prefix matches only sessions that wrote to entries that still
exist: a session that wrote only to removed entries is found by its full 32-character id.
Usage:
vaultfold history [<address>] [--session <id>] [--policy] [flags]
Flags:
--collection name with --policy: only rows about the collection with this name or collection id prefix
--field string show only this field's history, instead of #<field>
-h, --help help for history
--identity string profile identity to unlock
--limit n show at most n rows (0 for all)
--member name with --policy: only rows whose author or subject is the member with this name or member id prefix
--policy show the policy chain
--reveal show the value of each put (not in agent sessions)
--reverse oldest first (fold order)
--session id show what the agent session with this id wrote
Global Flags:
--json print exactly one JSON document on stdout
--vault name select a vault from the registry by name