kubek 0.4.2

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

---

📦 envx — 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. envx (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 envx ... > .env to produce a dotenv file

→ Full documentation

---

Installation

Prerequisites

• Python 3.11+
• kubectl installed and configured with cluster access

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 envx --help

See each plugin's README for full usage details.

---

License

MIT — see LICENSE.