restore
Brings back the contents an item had at an earlier version — whole, or one field of a record.
sefy restore <REFERENCE> <VERSION> [--field NAME]| Argument / option | Meaning |
|---|---|
<REFERENCE> |
The item: an id, an exact title, or text to search for. |
<VERSION> |
The version to bring back, by the number history gives it. |
--field <NAME> |
Bring back only this field of a record; the others keep their current values. |
$ sefy restore mail 2restored "mail" from version 2 (written 2026-09-18 21:40 UTC on laptop)what it replaced is kept as version 4; sefy history 2 lists themOne field
Section titled “One field”The usual case is a password changed in the vault that the site never accepted: the old one still opens the account, and the rest of the record — a new URL, a note added since — should stay as it is.
$ sefy restore mail 2 --field passwordrestored the password of "mail" from version 2 (written 2026-09-18 21:40 UTC on laptop)what it replaced is kept as version 4; sefy history 2 lists them$ sefy get mailcopied password of "mail" to the clipboard; clearing in 45sThe field comes back with the secrecy it had. A field the record no longer has is added back at the end; one the version never had is refused, with what it did have:
$ sefy restore mail 1 --field pinerror: version 1 of "mail" has no "pin"; it held: login, password, urlA note or a file is one value rather than a set of fields, and is restored whole.
A restore can be undone
Section titled “A restore can be undone”Restoring is an edit like any other. The contents it replaces become a version
of their own, so going back is one more restore — nothing is lost by trying
the wrong one.
Contents that already match the version are left alone rather than recorded again:
$ sefy restore mail 4version 4 is what "mail" holds now; nothing to restoreWhat it does not touch
Section titled “What it does not touch”The title and tags stay as they are now: they are not part of a version. Restoring a password from before a rename does not bring the old name back.