kutils

A collection of simple Kubernetes CLI utilities to save some keystrokes.

This repo is designed t. with links to others that I regularly use1.

• Installation
  • Homebrew (macOS and Linux)
  • go install
  • Build from source
• kgc
  • Features
  • Usage
• kgpv
  • Features
  • Usage
• Requirements
• License

Tools

• kgc — kubectl get pods with color-coded status and last restart reason
• kgpv — List PersistentVolumes with bound PVCs, pods, zones, storageClass and sizes

Installation

Potential for conflicting aliases:

If you use many kubectl aliases (like with oh-my-zsh), you may already have a kgpv alias. To check:

alias| grep kgpv

To unalias for your current session:

unalias kgpv

To make it permanent, add this to your ~/.zshrc:

echo"unalias kgpv">>~/.zshrc

Homebrew (macOS and Linux)

brew tap jessegoodier/kutils
brew install jessegoodier/kutils/kgc
brew install jessegoodier/kutils/kgpv

go install

go install github.com/jessegoodier/kutils/cmd/kgc@latest
go install github.com/jessegoodier/kutils/cmd/kgpv@latest

Build from source

git clone https://github.com/jessegoodier/kutils.git
cd kutils
go build -o kgc ./cmd/kgc
go build -o kgpv ./cmd/kgpv

---

kgc

Like kubectl get pods, but focused on containers and highlighting the last restart reason.

kgc -A
NAMESPACE NAME READY STATUS RESTARTS AGE LAST RESTART REASON
monitoring prometheus-kube-prometheus-stack-0 2/2 Running 0 2d23h
opencost opencost-9fcf95fc8-6tns1 2/2 Running 3 2d23h opencost: Error

Features

• Color-coded status: green (healthy), yellow (pending/not-ready), red (failed)
• Watch mode for real-time updates (-w)
• All-namespaces view (-A)
• Filter to only pods with restarts (-r)
• Shows last restart reason per container
• Adapts column widths dynamically

Usage

kgc [flags]
Flags:
-n, --namespace <namespace> Namespace to list pods in. (default: current context)
-A List pods across all namespaces.
-w, --watch Watch for pod changes.
-r, --has-restarts Only show pods with restarts.
--show-image Show container image column.
--kubeconfig <path> Path to kubeconfig file.
-v, --version Print version and exit.
-h, --help Show this help message.

---

kgpv

List PersistentVolumes with their bound PVCs, using pods, availability zones, and sizes.

kgpv
NAMESPACE POD ZONE SIZE PVC
production api-server-abc123 us-east-1a 10Gi api-data
production worker-xyz789 us-east-1b 50Gi worker-storage

Features

• Shows PV → PVC → Pod relationship at a glance
• Extracts zone from node affinity or labels
• Converts storage sizes to Gi format
• Color-coded output per column type
• Concurrent PV processing for speed
• Dynamic column width adaptation

Usage

kgpv [flags]
Flags:
--hide-pod Hide the pod column.
--show-pv-name Show the PV name column.
--show-reclaim-policy Show the reclaim policy column.
--show-all-fields Show all columns.
--sort <column> Sort by column: namespace, pod, zone, size, pvc, pv. (default: namespace)
--output <format> Output format: csv, json, yaml.
-v, --version Print version and exit.

---

Requirements

• A valid kubeconfig with cluster access

License

MIT