Skip to content

vault user

Manage stored user identities (logged-in accounts).

Lists every stored user. Shows which user is current.

vault user list [--format <FORMAT>]
OptionTypeRequiredDescription
--format <FORMAT>table | jsonOptionalOutput format. Default: table

This command also accepts the global options.

vault user list
vault user list --format json

Switches which stored user is current. If USERNAME is omitted, auto-selects when one stored user is available, or shows an interactive picker when more than one stored user is available (TTY only). In a non-interactive context with more than one stored user, the command errors: multiple stored users; specify one: vault user switch <username>.

vault user switch [<USERNAME>]
OptionTypeRequiredDescription
<USERNAME>stringOptionalUsername to switch to. Omit to auto-select (one stored user) or pick interactively (multiple users, TTY)

This command also accepts the global options.

vault user switch

When more than one stored user is available and the shell is a TTY, the CLI shows an interactive picker. When only one stored user is available, it is selected automatically.

vault user switch user@example.com