DEV Community: Narongrit Kanhanoi

kk: Kubernetes Power Helper CLI

Narongrit Kanhanoi — Wed, 19 Nov 2025 09:42:03 +0000

kk: Kubernetes Power Helper CLI

If kubectl keeps making you retype namespaces, pod names, and long log commands, kk is the slim Bash companion that keeps raw kubectl semantics but removes the friction. Think of it as a productivity layer: one executable Bash script that runs locally and wraps your daily troubleshooting verbs.

GitHub: https://github.com/heart/kk-Kubernetes-Power-Helper-CLI

What is kk?

kk is a single Bash script that wraps kubectl without hiding it. It remembers your namespace, lets you pick pods/deployments via regex (or fzf), and exposes familiar verbs (logs, sh, restart, pf, desc, top, etc.) under the short kk prefix. There is no CRD or cluster installation; it simply shells out to kubectl with smarter defaults.

Namespace memory

kk ns set my-namespace writes the namespace into ~/.kk. Every command then injects -n "$NAMESPACE" automatically. No more retyping -n staging or aliasing kubectl per project.

Pattern-first resource selection

Every command that touches pods/deployments accepts a regex pattern. kk sh api, kk desc '^web-', or kk restart orders all reuse the same selector:

Fetch all names via kubectl get … -o jsonpath
Filter with grep -E -- <pattern> safely
If multiple matches remain, fzf pops up (when installed) or you pick from a numbered list This means less copy/paste from kubectl get pods and fewer typos.

Multi-replica debugging

kk logs web -f -g "traceId=123" spins parallel kubectl logs for every matching pod, prefixes each line with [pod-name], and still lets you follow and grep just like plain kubectl. When you’re chasing a flaky request or tracing across replicas, you get a combined stream that shows exactly which replica produced the line. No shell loops, no manual tailing per pod.

Guard rails everywhere

The script prints clear messages before running disruptive actions (restart, port-forward), forces explicit selection when more than one resource matches, and propagates kubectl errors so you can see why something failed. Because it’s Bash, you can audit the entire script in minutes.

Real-world workflow

Here’s a typical flow when an API endpoint starts failing:

kk pods '^api-' – quickly list pods in the saved namespace.
kk logs '^api-' -f -g "(WARN|ERROR)" – follow logs from all replicas simultaneously and filter noisy noise.
kk sh '^api-' -- /bin/bash – jump into the problematic pod without copying its full name.
kk restart '^api-deploy' – rollout restart the deployment once the fix is ready.
kk pf '^api-' 8080:8080 – port-forward locally while testing. Every step is still raw kubectl underneath, just faster to type and harder to mess up.

Why you should try it

You value the simplicity of a single Bash script that does not interfere with your cluster.
You move between namespaces often and want that context remembered for you.
You debug scaled workloads and need log tailing across replicas without shell gymnastics.
You want guard rails (clear prompts, explicit selections) for potentially disruptive commands.
You prefer Unix-style text output that plays nicely with grep/less.

Explore the repo

All of kk lives in one Bash file plus optional installer helpers. Browse the source, review the README, and copy the script or use the installer—whatever fits your workflow:
https://github.com/heart/kk-Kubernetes-Power-Helper-CLI

Happy cluster hacking!

kk — A tiny CLI that makes kubectl faster and less painful

Narongrit Kanhanoi — Wed, 19 Nov 2025 05:32:59 +0000

kk — A tiny CLI that makes kubectl faster and less painful

Working with Kubernetes daily often means typing long kubectl commands repeatedly:

kubectl logs ...
kubectl exec ...
kubectl get pods | grep ...
switching namespaces
tailing logs from multiple replicas
restarting deployments and checking images

I wanted something tiny, predictable, and easy to drop into any environment.

So I built kk — a minimal Bash wrapper around kubectl that focuses on speed, simplicity, and muscle‑memory friendly commands.

Repo:

👉 https://github.com/heart/kk-Kubernetes-Power-Helper-CLI

🚀 Why I built this

I didn’t want another heavy binary or plugin framework.

I wanted:

shorter commands
automatic namespace handling
smart pod and deployment selection (fzf optional)
multi-pod log streaming
“day‑2” helpers like restart, port‑forward, events, top
zero dependencies beyond bash + kubectl (+ jq optionally)

kk is a single script you can drop into ~/bin/kk.

⚡ What kk can do

✅ Namespace helper

kk ns show
kk ns set staging

Keeps a simple namespace config in ~/.kk so you don’t have to type -n all day.

✅ Pods, shell, logs, images

# List pods (with optional name substring / regex)
kk pods
kk pods api

# Exec into a pod (auto-select; uses fzf if installed)
kk sh api
kk sh api -- bash

# Multi-pod logs with optional container, grep, follow
kk logs api -f
kk logs api -f -g "ERROR"
kk logs api -c main --since=10m

# See which images are actually running
kk images api

Pod selection uses a pattern against pod names. If multiple pods match, kk will prompt you (or use fzf when available).

✅ Deployment helpers

# Rollout restart a deployment (with pattern and selection)
kk restart api

# Summarize deployments in the current namespace
kk deploys

kk deploys uses jq (if available) to show something like:

NAME                           READY      IMAGE
api                            3/3  image: yourorg/api:1.8.12
web                            2/2  image: yourorg/web:3.9.0

✅ Port‑forward with pod selection

kk pf api 8080:80

This resolves the pod by pattern first (again, with fzf if there are multiple matches) and then runs kubectl port-forward for you.

✅ Quick describe & resource usage

# Describe matching pod
kk desc api

# Top pods (optionally filtered)
kk top
kk top api

kk top is just a friendly wrapper around kubectl top pod -n <ns> with optional filtering while keeping the header row.

✅ Events & contexts

# Recent events in the current namespace
kk events

# Show or switch kubectl contexts
kk ctx
kk ctx my-cluster

🛠 Installation

curl -o ~/bin/kk https://raw.githubusercontent.com/heart/kk-Kubernetes-Power-Helper-CLI/main/kk
chmod +x ~/bin/kk

Make sure ~/bin is in your $PATH:

echo 'export PATH="$HOME/bin:$PATH"' >> ~/.bashrc   # or ~/.zshrc
source ~/.bashrc                                   # or ~/.zshrc

❤️ If you find kk useful

Stars, issues, and suggestions are welcome.

Repo link again:

👉 https://github.com/heart/kk-Kubernetes-Power-Helper-CLI

kk isn’t meant to replace kubectl.

It just removes boilerplate and gives you a smoother Kubernetes workflow.

SwiftUI QRCode Scanner

Narongrit Kanhanoi — Tue, 26 Nov 2019 12:12:14 +0000

https://github.com/heart/CarBode-Barcode-Scanner-For-SwiftUI