kl tag, kl operator, and kl version

These commands cover metadata, bootstrap helpers, and binary introspection.

kl tag

Tags are named pointers to a state_version.

Use them to create memorable rollback and diff references.

Set a tag

kl tag set big-state pre-mig --to @1

List tags

kl tag list big-state

Remove a tag

kl tag unset big-state pre-mig

Why tags matter

Once created, a tag can be used anywhere a version reference is accepted:

kl rollback big-state --to=pre-mig
kl diff big-state --from=pre-mig --to=current

kl operator

kl operator is the control-plane bootstrap helper surface.

This is not the main day-to-day state workflow. It is for control-plane initialization and operator checks such as:

• init
• seal-status

Use it during self-hosted bootstrap and operator setup, not as part of ordinary plan/apply work.

Related runbook:

• Self-hosted bootstrap

kl version

Prints binary version information.

Examples

kl version
kl version --json

Use it when:

• verifying a deployment
• checking that a CI runner and local machine are on the same build
• attaching exact build info to bug reports