kdebug

An interactive, single-command Kubernetes debug helper.
Idea: one CLI that replaces the usual five kubectl commands you run while debugging.

---

What it does

• Lists pods with live status in a filterable TUI table
• Lets you pick a pod (↑/↓ or j/k to move, / to filter, Enter to select)
• Shows a concise Describe (summary)
• Shows Container status (ready/state/restarts/reason)
• Shows Logs (tail or follow, choose container, optional previous-instance)
• Shows recent Events

All from one binary, with friendly prompts. No subcommands. No fuss.

---

Install

From Releases (recommended)

1. Download a binary for your OS from the Releases page.
2. Make it executable and put it on your PATH:

   chmod +x kdebug_* && sudo mv kdebug_* /usr/local/bin/kdebug
   kdebug --help

Build from source

git clone https://github.com/kjvjobin/kdebug
cd kdebug
go mod tidy
go build -o kdebug
./kdebug --help

---

Quick start

# current context/namespace
kdebug

# choose a namespace
kdebug -n development

# list across all namespaces
kdebug -A

# filter pods by label selector
kdebug -n production -l app=my-service

Inside the UI:

• ↑/↓ or j/k to move
• / to filter
• Enter to select

Then choose: Describe (summary) · Container status · Logs (tail) · Logs (follow) · Events

---

Flags

-n, --namespace <ns>     Namespace to use (defaults to current context)
-A, --all-namespaces     List pods across all namespaces
-l, --selector <expr>    Label selector, e.g. app=api,tier=backend
-v, --version            Print version and exit
-h, --help               Show help

---

Status

Status: 🚧 WIP (public alpha)
Goal: Make pod debugging fast, consistent, and shareable.

If this sounds useful, ⭐ the repo and watch releases.

---

Contributing

• Welcoming PRs! See CONTRIBUTING.md.
• Releases: RELEASES.
• Change Log: See CHANGELOG.md.

---

License

Apache-2.0