v0.2.19 โ€” Now on npm

Kubernetes Debug Tool
That Just Works

Zero-install cluster visualization. SSH into any server and see your entire Kubernetes topology in seconds โ€” as a clean ASCII tree.

npx kubechart
npm Package
โšก Zero Dependencies ๐Ÿ”’ SSH-Friendly ๐Ÿ“Š Real-time Metrics
kubechart โ€” bash
$ |

The Problem with kubectl

๐Ÿ˜ต

Flat & Disconnected

kubectl get all shows a messy list. Can't see relationships between Deployments, ReplicaSets, and Pods.

๐Ÿ˜ค

Dashboard Overhead

Kubernetes Dashboard requires deploying pods, port-forwarding, and RBAC setup just to see cluster status.

๐Ÿข

Heavy Tools

k9s is great but needs installation. Lens is powerful but requires a desktop app and network access.

Tree View: See Everything at a Glance

Hierarchical visualization with parent-child relationships, status, and metrics โ€” all in one screen.

โŒ kubectl get all
kubectl output
$ kubectl get all -n production

NAME                           READY   STATUS
pod/api-76f555f8cd-d9jb6       1/1     Running
pod/api-76f555f8cd-gmv7w       1/1     Running
pod/api-76f555f8cd-x2k9p       1/1     Running
pod/redis-0                    1/1     Running
pod/redis-1                    1/1     Running
pod/worker-5cf658bb5-abc12     0/1     Error

NAME                 TYPE        CLUSTER-IP
service/api          ClusterIP   10.101.87.67
service/redis        ClusterIP   10.102.234.145

NAME                              DESIRED   READY
replicaset.apps/api-76f555f8cd    3         3
replicaset.apps/api-5cf658bb5     0         0

NAME                    READY
deployment.apps/api     3/3

NAME                    LAST SCHEDULE

cronjob.apps/backup     2h ago

โŒ Flat list โ€” no hierarchy
โŒ Pod worker-abc12 belongs to... where?
โŒ Scrolling to connect the dots
โœ… Kubechart
kubechart
โ—† CLUSTER production-eks | k8s v1.30.0 | 3 nodes

[m]etric: use/lim [s]elector: OFF | โ†บ 3/5s

โ””โ”€โ”€ NAMESPACE production [Active]
    โ”œโ”€โ”€ โ–ฒ Deployment api-server [3/3]
    โ”‚   โ”œโ”€โ”€ โ—† ReplicaSet api-76f555f8cd [3/3]
    โ”‚   โ”‚   โ”œโ”€โ”€ POD โ— api-d9jb6  CPU โ–ˆโ–ˆโ–ˆโ–ˆโ–‘โ–‘โ–‘โ–‘ 45%
    โ”‚   โ”‚   โ”œโ”€โ”€ POD โ— api-gmv7w  CPU โ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ–‘โ–‘โ–‘ 52%
    โ”‚   โ”‚   โ””โ”€โ”€ POD โ— api-x2k9p  CPU โ–ˆโ–ˆโ–ˆโ–‘โ–‘โ–‘โ–‘โ–‘ 38%
    โ”‚   โ””โ”€โ”€ โ—† ReplicaSet api-5cf658bb5 [0/1] (inactive)
    โ”‚
    โ”œโ”€โ”€ โ—† StatefulSet redis [2/2]
    โ”‚   โ”œโ”€โ”€ POD โ— redis-0  MEM โ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ–ˆ 80%
    โ”‚   โ””โ”€โ”€ POD โ— redis-1  MEM โ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ–‘ 75%
    โ”‚
    โ”œโ”€โ”€ โ–  DaemonSet fluentd [3/3]
    โ”‚   โ””โ”€โ”€ POD โ— fluentd-2m5jb
    โ”‚
    โ”œโ”€โ”€ โ—‹ CronJob backup [last: 2h ago] โœ“
    โ”œโ”€โ”€ SVC โ— ClusterIP api-service  10.101.87.67
    โ”œโ”€โ”€ ING โ—† api.example.com  / โ†’ api-service:80
    โ””โ”€โ”€ CM โ—‰ app-config  12 keys

Workloads: 4 | Pods: 6/7 running | Services: 1

โœ… Hierarchy: Deployment โ†’ ReplicaSet โ†’ Pod
โœ… Instant status: โ— Running โ—Œ Pending โœ– Error
โœ… Metrics inline: CPU โ–ˆโ–ˆโ–ˆโ–ˆโ–‘โ–‘โ–‘โ–‘ 45%

Resource Symbols & Status

โ–ฒ Deployment
โ—† StatefulSet
โ–  DaemonSet
โ— Job
โ—‹ CronJob
โ—† ReplicaSet
โ— Pod Running
โ—Œ Pod Pending
โœ– Pod Failed
โ—‹ Pod Succeeded
โ— Service
โ—† Ingress

Everything You Need for Quick Debugging

๐Ÿ”„

Watch Mode

Auto-refresh with countdown timer. Pause/resume with p. Manual refresh with r.

๐Ÿ“Š

Real-time Metrics

CPU & Memory bars from metrics-server. Toggle modes with m: numbers โ†’ bars โ†’ usage/limits.

๐Ÿท๏ธ

Label Selectors

Toggle label selectors and pod labels with s. Filter resources with -l app=api.

๐Ÿ’พ

Volumes & PVCs

Show storage with capacity, storageClass, and status. Toggle with v.

๐Ÿ“

Smart Hierarchy

Proper Deployment โ†’ ReplicaSet โ†’ Pod structure. CronJob โ†’ Jobs nesting. Inactive ReplicaSets dimmed.

๐Ÿ’พ

Export Snapshots

Export cluster state to JSON or YAML for documentation and audit trails.

โšก

Namespace Switching

Press 0-9 to instantly switch between namespaces. No typing required.

๐ŸŽจ

Color-Coded Status

Visual indicators for pod health: green (Running), yellow (Pending), red (Failed), gray (Completed).

Get Started in 30 Seconds

1

No Install Required

npx kubechart

Works on any server with Node.js. No setup, no pods to deploy.

2

Filter by Namespace

kubechart -n production

Or use 0-9 to switch namespaces instantly.

3

Export Snapshot

kubechart --once --output yaml --out-file cluster.yaml

Save cluster state for documentation or audit.

Keyboard Shortcuts

0-9 Switch namespace
r Refresh now
p Pause/resume
m Cycle metrics
s Toggle selectors
v Toggle volumes
+/- Adjust interval
h Toggle legend
? Show help
q Quit

How Kubechart Compares

Feature Kubechart k9s Lens Dashboard
Zero install โ“˜ โœ“ โœ— โœ— โœ—
SSH compatible โ“˜ โœ“ โœ“ โœ— โœ—
Real-time metrics โœ“ โœ“ โœ“ โœ“
Bar chart metrics โœ“ โœ— โœ“ โœ—
JSON/YAML export โœ“ โœ— โœ“ โœ“
Tree visualization โœ“ โœ“ โœ“ โœ“
Interactive editing โ“˜ โœ— โœ“ โœ“ โœ“
Resource usage Minimal Medium Heavy Medium

TL;DR: Kubechart = quick view/debug with zero setup. Use k9s or Lens when you need full cluster management.

Perfect For

๐Ÿ”ง

Production Debugging

SSH into a node, run npx kubechart, and immediately see cluster health. No setup, no port-forwarding.

๐Ÿ“Š

Status Sharing

Copy-paste the ASCII tree into Slack, tickets, or runbooks. Everyone sees the same cluster state instantly.

๐Ÿ“‹

Documentation

Export YAML/JSON snapshots for audit trails, disaster recovery docs, or cluster state baselines.

๐Ÿ”’

Air-gapped Networks

No external services needed. Works entirely offline with just kubeconfig and kubectl access.

Ready to debug faster?

No pods to deploy. No GUI to install. Just run and go.

npx kubechart