v1.1.4 Live

One command.
Every cluster.
Diagnosed.

A read-only Kubernetes diagnostic CLI that scans clusters in parallel, extracts root causes from logs, and surfaces the answer in one screen.

$ curl -sSL https://getklarity.dev/install.sh | sh
Copy
No sudo? Install to your home directory: INSTALL_DIR=~/.local/bin curl -sSL https://getklarity.dev/install.sh | sh
klarity
klarity — 2026-04-01 09:14:22 CST
Environments: 3 | Clusters: 7 scanned | Issues: 4 found
PROD-PAYMENTS
── gke-payments-prod-uscentral1
💀 OOMKilled (1 pod)
NamespacePodRequestsLimitsRestarts
billinginvoice-svc-4f1-a512Mi1Gi14
🔥 CrashLoopBackOff — Application Errors (2 pods)
NamespacePodRestartsRoot Cause (from logs)
checkoutcart-api-7c2-r47FATAL: password auth failed "cartdb"
notificationsmailer-wrk-3a-m12ConnectionRefused: rabbitmq:5672
Summary: 3 issues in prod-payments | 1 in staging | 0 in dev
🧠

Root-Cause Extraction

No more digging through 30-line stack traces. klarity parses Java, Python, and Go logs to extract the exact error instantly.

⚡

Multi-Cluster Native

Goroutines scan your entire kubeconfig in parallel. AKS, EKS, GKE, and local clusters auto-detected and grouped by org and tier.

🛡️

Strictly Read-Only

Perfectly safe for production. klarity only performs get and list operations. Never mutates resources.

⌨️

Full-Screen Setup

klarity init and klarity config take over the terminal with a keyboard-driven full-screen UI — no more prompts disappearing off screen.

v1.1.3

What's new

Full-Screen TUI

klarity init now takes over your terminal

The setup wizard is now a full-screen keyboard-driven interface — no more prompts scrolling off screen. Phase progress shown at the top, controls at the bottom. Navigate with ↑↓, confirm with enter, go back with esc.

● groupings ● tiers ○ default ○ save
Confirm tier assignments — space to toggle, enter to confirm
› prod-payments critical keep
prod-platform critical keep
staging-payments standard keep
dev-platform standard keep
↑↓ move  ·  space toggle  ·  enter confirm  ·  esc back  ·  q quit
Smart Onboarding

Dozens of clusters grouped in seconds

klarity init auto-detects AKS, EKS, and GKE naming patterns — proposes groupings and only asks about unmatched clusters.

Proposed groupings
prod-payments  (critical) 4 clusters  gke-payments-prod-*
staging-payments(standard) 2 clusters  gke-payments-staging-*
dev-platform    (standard) 3 clusters  aks-platform-dev-*
Unmatched (1): legacy-cluster-01
› Accept  Edit   Cancel
Performance

Parallel namespace scanning

Namespaces within each cluster scan concurrently. Large clusters finish in a fraction of the time.

$time klarity -e dev-platform
before  1m 16s (sequential)
after   14s    (parallel ×10)
Operations

Default environment

Set a default so klarity scans just what matters. Use --no-default for a one-shot full scan.

$klarity
Scanning prod-payments (default)
Use --env to scan other environments
$klarity --no-default
ℹ Scanning all configured clusters
Filters

Wildcard namespaces & multi-env

Scan multiple environments at once and filter namespaces with glob patterns. Quote wildcards to prevent shell expansion.

$klarity -e prod-payments,prod-analytics
$klarity -e dev-platform -n "billing-*"
$klarity -n "*-system" # suffix glob
Lifecycle

Self-update, Slack reporting, and clean uninstall

Keep klarity current with one command. Post diagnostic reports to Slack on demand. klarity config opens a full-screen interactive menu. Remove everything cleanly when needed.

$klarity update
Update available: v1.1.2 → v1.1.3
✓ klarity updated to v1.1.3
$klarity slack send
Scanning prod-payments, prod-platform...
✓ Posted to Slack — 11 issues
$klarity uninstall
✓ removed binary, config, cache, log
Reference

Commands

Setup
klarity initFull-screen wizard — auto-detects and groups clusters
klarity init --resetReconfigure — backs up existing config first
klarity configFull-screen interactive config menu
klarity updateSelf-update to the latest release
klarity uninstallRemove binary, config, cache, and logs
Scanning
klarityScan default environment (or all if none set)
klarity -e prod-paymentsScan a specific environment
klarity -e prod,stagingScan multiple environments
klarity --no-defaultOne-shot full scan ignoring default_env
klarity --rescanForce a fresh scan, ignoring the cache
klarity --watchContinuous scan, refreshes on interval
Filtering
klarity --context gke-payments-prod-uscentral1Scan a single cluster
klarity -n billingScan a specific namespace
klarity -n "billing-*"Wildcard namespace filter (glob)
klarity --exclude-ns "test-*"Exclude namespaces by glob pattern
klarity --category oom,crashloopShow only specific issue categories
History & Output
klarity --historyShow last 10 scan summaries
klarity --history 25Show last N scan summaries
klarity -o jsonOutput as JSON (for CI or piping)
klarity --interval 60Override scan interval in seconds
Environments
klarity envList all environments with cluster names
klarity lsAlias for klarity env
klarity config showShow full config including default env
klarity config editOpen config in $EDITOR
klarity config validateValidate config and check cluster reachability
Slack
klarity slack setupConfigure Slack webhook or bot token
klarity slack sendPost report for critical-tier environments
klarity slack send -e prod-paymentsPost report for specific environment
klarity slack send --allPost report for all environments
Copied to clipboard!