kubek 0.5.0

kubectl extensions

kubek

kubectl plugins for friendlier Kubernetes interactions.

kubek (kubernetes extension kit) is a collection of CLI tools that plug into kubectl and add interactive, developer-friendly shortcuts on top of it.

---

Plugins

🔌 portfwd — Interactive port forwarding

Forwarding ports to Kubernetes services usually means running a separate kubectl port-forward command for each service, keeping track of which local port maps to what, and restarting them when they die. portfwd (port forward) replaces all of that with a single interactive command — pick your services, and it handles the rest.

• Fuzzy-search namespaces and services interactively
• Forward multiple services simultaneously in one command
• Live status table with real-time updates when a process dies
• Pin preferred local ports per service in a TOML config
• Fallback to a random free port if the preferred port is taken
• Inform user which services are currently forwarded and on which ports

→ Full documentation

---

📦 export-dotenv — Export env vars from Kubernetes manifests

Getting credentials out of a running deployment usually means digging through kubectl get deployment -o yaml, copying values by hand, and reformatting them into a .env file. export-dotenv (environment exporter) does it in one command — pick any Deployment or Argo WorkflowTemplate you have access to and get its env vars exported instantly.

• Fully interactive (fuzzy-search, arrow key navigation)
• Output as .env or JSON
• Pipe directly: kubectl export-dotenv ... > .env to produce a dotenv file

→ Full documentation

---

Installation

Prerequisites

• Python 3.11+
• kubectl installed and configured with cluster access (recommended version 1.36+)

Install

The recommended way to install kubek is with pipx, which installs it in an isolated environment and automatically makes the plugin executables available on your PATH:

# Latest stable release (recommended)
pipx install kubek

# Newest development version
pipx install git+https://github.com/ohmycoffe/kubek.git

If you use pip or another package manager, make sure the installation's bin/ directory is on your PATH — kubectl discovers plugins by scanning PATH for executables prefixed with kubectl-.

Verify

After installing, confirm both plugins are available:

kubectl portfwd --help
kubectl export-dotenv --help

See each plugin's README for full usage details.

---

License

MIT — see LICENSE.