helmcode

K8s Watchdog Ai

Name: K8s Watchdog Ai
Author: helmcode

DevOps community

SOURCE https://github.com/helmcode/k8s-watchdog-ai

Description

Autonomous Kubernetes cluster observability with AI-powered

Installation

This entry records only its repository, not the path inside it, so there is no exact command to give. Open the source below and copy the folder into ~/.claude/skills/, or the file into ~/.claude/agents/.

README

K8s Watchdog AI 🐕

Autonomous Kubernetes cluster observability with AI-powered weekly health reports

[![Python](https://img.shields.io/badge/python-3.11+-blue.svg)](https://www.python.org/downloads/) [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT) [![FastAPI](https://img.shields.io/badge/FastAPI-0.100+-green.svg)](https://fastapi.tiangolo.com/)

An intelligent Kubernetes monitoring agent that uses Claude AI to autonomously investigate cluster health, analyze metrics from Prometheus, and generate comprehensive weekly PDF reports delivered via Slack.

✨ Features

🤖 AI-Powered Analysis: Claude AI autonomously investigates cluster issues using direct Python tools
📊 Prometheus Integration: Analyzes metrics to detect resource inefficiencies (optional)
🔒 Read-Only by Design: All operations are read-only for safety
📄 PDF Reports: Professional HTML reports converted to PDF via WeasyPrint
📧 Slack Integration: Reports delivered via Slack with detailed tool usage information
🗄️ Historical Tracking: SQLite storage for report history
🚀 REST API: FastAPI server for on-demand report generation
⚡ Graceful Degradation: Works with or without Prometheus

🏗️ Architecture

┌─────────────────────────────────────────────────────┐
│              Kubernetes Cluster                      │
│                                                      │
│  ┌──────────────────────────────────────────────┐   │
│  │       K8s Watchdog AI (FastAPI)              │   │
│  │                                              │   │
│  │  ┌────────────────────────────────────┐     │   │
│  │  │  Claude AI Agent                   │     │   │
│  │  │  - Autonomous investigation        │     │   │
│  │  │  - Tool selection & execution      │     │   │
│  │  │  - Report generation              │     │   │
│  │  └─────────┬──────────────────────────┘     │   │
│  │            │