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

KEY
type: str (required)

Exact dotted leaf key.

VALUE
type: str | None = None

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

KEY
type: str (required)

Exact dotted leaf key.

Options

--allow-missing
type: bool = False

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

PATH
type: str | None = None

Optional dotted namespace used to scope the output.

Options

--keys-only
type: bool = False

Print credential names without values.

--reveal
type: bool = False

Print decoded values instead of redacted placeholders.

yera cred delete

Delete one credential leaf.

yera cred delete KEY

Arguments

KEY
type: str (required)

Exact dotted credential name.

yera cred patch

Merge credential leaves into a namespace.

yera cred patch PATH [JSON_STR] [--from-file STR | NONE]

Arguments

PATH
type: str (required)

Dotted namespace to merge into.

JSON_STR
type: str | None = None

Inline JSON object to merge.

Options

--from-file
type: str | None = None

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

PATH
type: str (required)

Dotted namespace to replace.

JSON_STR
type: str | None = None

Inline JSON object to store.

Options

--from-file
type: str | None = None

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

PATH
type: str | None = None

Optional dotted namespace to clear.

Options

--force
type: bool = False

Whether destructive bulk deletion is permitted.

yera cred list-groups

List all credential groups with credential counts and authorised roots.

yera cred list-groups

yera cred use-group

Set [tool.yera.overrides] cred-group in pyproject.toml.

yera cred use-group NAME

Arguments

NAME
type: str (required)

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

NAME
type: str | None = None

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 NAME

Arguments

NAME
type: str (required)

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_NAME

Arguments

OLD_NAME
type: str (required)

Existing credential group name.

NEW_NAME
type: str (required)

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

NAME
type: str (required)

Credential group name to delete.

Options

--force
type: bool = False

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

NAME
type: str (required)

Credential group name to export.

Options

--output-file
type: pathlib.Path | None = None

Path to write the exported JSON. Uses atomic writing with restricted permissions on POSIX. Omit to write to standard output.