yera cred
Use yera cred to store and manage credentials in Yera's protected local
credentials file. Values are not encrypted at rest. Credential groups keep
related values together and control which project roots may use them.
The nested commands can set, inspect, merge, replace, and delete credential
values. They can also create project access, inspect or rename groups, and
export a complete group. Treat values printed by cred get and documents
created by cred export-group as secrets.
Store and manage credentials in Yera's protected local file. The values are not encrypted at rest. Credential groups control which project roots can use them.
yera cred put
Set a single credential leaf.
yera cred put KEY [VALUE]Arguments
Exact dotted leaf key.
Credential value. Omit for interactive prompt or stdin.
yera cred get
Print one credential value to standard output. Treat the output as secret.
yera cred get KEY [--allow-missing]Arguments
Exact dotted leaf key.
Options
Exit successfully without output if the key is absent.
yera cred list
Inspect credentials for the active credential group.
yera cred list [PATH] [--keys-only] [--reveal]Arguments
Optional dotted namespace used to scope the output.
Options
Print credential names without values.
Print decoded values instead of redacted placeholders.
yera cred delete
Delete one credential leaf.
yera cred delete KEYArguments
Exact dotted credential name.
yera cred patch
Merge credential leaves into a namespace.
yera cred patch PATH [JSON_STR] [--from-file STR | NONE]Arguments
Dotted namespace to merge into.
Inline JSON object to merge.
Options
JSON file path, or - for standard input.
yera cred replace
Replace all credential leaves beneath a namespace.
yera cred replace PATH [JSON_STR] [--from-file STR | NONE]Arguments
Dotted namespace to replace.
Inline JSON object to store.
Options
JSON file path, or - for standard input.
yera cred clear
Delete credentials from the active credential group. Requires --force.
yera cred clear [PATH] [--force]Arguments
Optional dotted namespace to clear.
Options
Whether destructive bulk deletion is permitted.
yera cred list-groups
List all credential groups with credential counts and authorised roots.
yera cred list-groupsyera cred use-group
Set [tool.yera.overrides] cred-group in pyproject.toml.
yera cred use-group NAMEArguments
Credential group name to write under [tool.yera.overrides].
yera cred get-group
Show active credential group or inspect a named group's metadata.
yera cred get-group [NAME]Arguments
Credential group name to inspect. If omitted, prints the active group name. If provided, prints the named group's metadata as JSON.
yera cred allow-group
Add the current project root to a credential group's authorised roots.
yera cred allow-group NAMEArguments
Credential group name to authorise for this project root.
yera cred rename-group
Atomically rename a credential group in credentials.json.
yera cred rename-group OLD_NAME NEW_NAMEArguments
Existing credential group name.
New credential group name. Must pass name validation.
yera cred delete-group
Delete a credential group and every credential it contains. Requires --force.
yera cred delete-group NAME [--force]Arguments
Credential group name to delete.
Options
Must be true; the command refuses to delete without --force.
yera cred export-group
Export every value in a credential group. The exported document contains secrets.
yera cred export-group NAME [--output-file PATHLIB.PATH | NONE]Arguments
Credential group name to export.
Options
Path to write the exported JSON. Uses atomic writing with restricted permissions on POSIX. Omit to write to standard output.