CLI command

skarbiec retag

Replace one item's tags without rewriting its encrypted payload or recipient set.

Invocation#

Shell
skarbiec retag <id> --tags <tag[,tag...]> 

Purpose#

Replace one item's tags without rewriting its encrypted payload or recipient set.

Required inputs and options#

  • Requires an item id. --tags supplies the complete replacement list; an omitted or empty value produces an empty list.

Output and state effects#

  • Updates metadata only and prints ok, id, and the final tags.

Refusals#

  • Refuses the reserved managed:weles tag, a tag it would introduce under no registered namespace, and direct owner retagging of lifecycle-controlled items. On a vault that replicates another (a bond with mode replica and role replica) it refuses with this vault replicates bond <name> from <source>; a direct retag here is replaced by the next pull. Write it on the source vault.; set, set-json and rename are refused the same way, because the next pull replaces the whole vault file. A tag the item already carries is preserved rather than re-judged, so restoring one registered tag onto an item that also carries an older unregistered one still works.