ghostwritten/kubeowler repository overview

⁠Kubeowler - Kubernetes Cluster Checker

A high-performance Kubernetes cluster health inspection tool written in Rust. Built for platform and SRE teams to evaluate cluster health, security posture, and resource efficiency. Generates detailed, actionable reports in Markdown, JSON, CSV, or HTML.

⁠What It Does

• Comprehensive checks: nodes, pods, network, storage, security, resources, certificates, control plane, observability, policies
• Intelligent scoring: weighted scoring to highlight weak areas and prioritize remediation
• Detailed reports: results grouped by resource type (Node, Pod, Service, etc.) for easier review
• Actionable advice: concrete remediation tips per issue with references to documentation
• Read-only: no cluster modifications—only lists and reads resources via the Kubernetes API
• High performance: asynchronous Rust implementation

⁠Quick Start

With kubeconfig mounted:

docker run --rm \
  -v ~/.kube/config:/home/kubeowler/.kube/config:ro \
  -v $(pwd)/reports:/app/reports \
  ghostwritten/kubeowler check -o /app/reports/cluster-report.md