CLI command

skarbiec list

List item metadata without returning credential values.

Invocation#

Shell
skarbiec list [--all]

Purpose#

List item metadata without returning credential values.

Required inputs and options#

  • No positional input. --all includes trashed records; without it only live items are listed.

Output and state effects#

  • Prints a JSON array of id, item_uid, kind, state, revision, management, tags, recipients, updated_at, deleted, and versions. It does not decrypt values or mutate the vault. item_uid is null for an item written before that field existed, which is how an operator sees what `skarbiec upgrade` still has to stamp.

Refusals#

  • Fails rather than returning an empty array when the local vault cannot be opened or the declared fleet owner cannot answer. Remote owner-item endpoints must be supported by the serving Skarbiec release; a missing endpoint is an explicit version/deployment failure, never permission to consult a client copy.