ksec 0.2.0

Kubernetes secrets pretty printer

ksec

The ksec tool simply decodes secrets from kubectl to make it easier for the user to view them. It can parse output from kubectl in either JSON or YAML (if you install with the yaml extra).

Quickstart

1. Preferred method with uv:

uv tool install ksec

2. With pipx:

pipx install ksec

3. With pip:

pip install ksec

Example usage

$ kubectl get secret my-secret -o json | ksec
{
  "SOME_ID": "cd31d8f5-9bf7-40a1-aced-a7faddd199ce",
  "SOME_KEY": "17153263835190001925"
}

Getting help

Simply run ksec --help:

$ ksec --help

 Usage: ksec [OPTIONS]

 Display decoded kubernetes secrets printed by kubectl.
 Example usage:

 kubectl get secret my-secret -o json | ksec

╭─ Options ─────────────────────────────────────────────────────────────────────────────────────────────╮
│ --mode                -m      [JSON|YAML]  Set the format that should be processed from stdin. YAML   │
│                                            mode requires installation with the yaml flag.             │
│                                            [default: JSON]                                            │
│ --full                -f                                                                              │
│ --install-completion                       Install completion for the current shell.                  │
│ --show-completion                          Show completion for the current shell, to copy it or       │
│                                            customize the installation.                                │
│ --help                                     Show this message and exit.                                │
╰───────────────────────────────────────────────────────────────────────────────────────────────────────╯

License

Distributed under the MIT License. See LICENSE for more information.