🎯 Goal
Convert the kdm health command from static color-coded text output into a fully interactive health dashboard with live-updating progress bars, collapsible panels, and inline error inspection.
📌 Current Behavior
kdm health checks the health of workloads and outputs color-coded logs and details.
Options:
| Flag |
Description |
-w, --watch |
Run in watch mode to continuously refresh output |
-i, --interval <seconds> |
Refresh interval in seconds (default: 5) |
Subcommands:
| Subcommand |
Description |
kdm health all |
Unified health check of both containers and pods |
kdm health pods |
Health checks for pods only |
kdm health containers |
Health checks for Docker containers only |
Example usage:
kdm health all
kdm health pods -w
kdm health containers -w -i 2
🚀 Proposed Interactive Dashboard
Layout
Health Score
CPU ██████████ 95%
Memory ████████ 80%
Pods ██████ 60%
▼ Kubernetes Workloads
✔ nginx Running 2h
✖ backend-api CrashLoop 30m
✔ redis Running 5h
▶ Docker Containers (collapsed)
──────────────────────────────────────
TAB:Move SPACE:Expand/Collapse W:Watch ENTER:Inspect Q:Quit
User Flow
- User runs
kdm health → health score bars render at the top, workload list below.
- Press
Space on a panel header to collapse/expand it (▼ ↔ ▶).
- Use
↑ / ↓ to select a workload.
- Press
Enter on a failing workload to see inline error details:
✖ backend-api CrashLoop 30m
├─ Reason: ImagePullBackOff
├─ Events: Failed pulling image
└─ Action: Backoff restarting container
- Press
w to toggle watch mode — bars and statuses auto-refresh.
- Press
+ / - to adjust refresh interval dynamically.
Keyboard Shortcuts
| Key |
Action |
↑ / ↓ |
Navigate workloads |
Space |
Collapse / expand panel |
Enter |
Inspect failing workload |
w |
Toggle watch mode |
+ / - |
Adjust refresh interval |
Q |
Quit |
Recommended Libraries
📋 Contribution Workflow
- Fork the repo and create a feature branch (e.g.,
feature/interactive-kdm-health).
- Implement the interactive TUI for
kdm health using the layout and flow described above.
- Submit a PR explicitly linked to this issue (e.g.,
Closes #136).
- 📸 Include a screenshot or recording of the implemented UI in your PR to verify the new dashboard experience.
🎯 Goal
Convert the
kdm healthcommand from static color-coded text output into a fully interactive health dashboard with live-updating progress bars, collapsible panels, and inline error inspection.📌 Current Behavior
kdm healthchecks the health of workloads and outputs color-coded logs and details.Options:
-w, --watch-i, --interval <seconds>5)Subcommands:
kdm health allkdm health podskdm health containersExample usage:
🚀 Proposed Interactive Dashboard
Layout
User Flow
kdm health→ health score bars render at the top, workload list below.Spaceon a panel header to collapse/expand it (▼↔▶).↑/↓to select a workload.Enteron a failing workload to see inline error details:wto toggle watch mode — bars and statuses auto-refresh.+/-to adjust refresh interval dynamically.Keyboard Shortcuts
↑/↓SpaceEnterw+/-QRecommended Libraries
ink-progress-barink-spinnercli-boxeschalk📋 Contribution Workflow
feature/interactive-kdm-health).kdm healthusing the layout and flow described above.Closes #136).