# igorbnd/podlikar architecture

> Architecture diagram of the GitHub repository igorbnd/podlikar, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-16). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/igorbnd/podlikar
- Repository: https://github.com/igorbnd/podlikar

## Overview

PodLikar is a declarative kagent agent for diagnosing Kubernetes and k3s problems. Users invoke it for a cluster health check, a pod diagnosis, or a controller-managed pod restart. Its prompt coordinates built-in MCP tools for resource listings, investigation, and deletion; those tools operate on the cluster. The repository contains no custom runtime source, so the workflow and tool relationships below rely on README documentation. Ollama is an optional model configuration; test scenarios are excluded.

Main entry points: [`podlikar-agent.yaml`](https://github.com/igorbnd/podlikar/blob/main/podlikar-agent.yaml) (PodLikar agent), [`ollama-model-config.yaml`](https://github.com/igorbnd/podlikar/blob/main/ollama-model-config.yaml) (Ollama config)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_agent["Agent"]
  node_podlikar["PodLikar agent"]
  node_health["Health check"]
  node_diagnose["Pod diagnosis"]
  node_heal["Pod healing"]
end

subgraph group_cluster["Cluster operations"]
  node_mcp["kagent MCP server"]
  node_get_resources["List resources"]
  node_describe["Describe resource"]
  node_logs["Get pod logs"]
  node_events["Get events"]
  node_resource_yaml["Get resource YAML"]
  node_delete["Delete resource"]
end

subgraph group_models["Model configurations"]
  node_anthropic["Anthropic model"]
  node_ollama_config["Ollama config"]
end

node_user(("Operator"))
node_kubernetes["Kubernetes cluster"]

node_user -->|"invokes"| node_podlikar
node_podlikar -->|"supports"| node_health
node_podlikar -->|"supports"| node_diagnose
node_podlikar -->|"supports"| node_heal
node_podlikar -->|"uses tools"| node_mcp
node_mcp -->|"provides"| node_get_resources
node_mcp -->|"provides"| node_describe
node_mcp -->|"provides"| node_logs
node_mcp -->|"provides"| node_events
node_mcp -->|"provides"| node_resource_yaml
node_mcp -->|"provides"| node_delete
node_get_resources -->|"reads resources"| node_kubernetes
node_describe -->|"reads details"| node_kubernetes
node_logs -->|"reads logs"| node_kubernetes
node_events -->|"reads events"| node_kubernetes
node_resource_yaml -->|"reads specs"| node_kubernetes
node_delete -->|"deletes pods"| node_kubernetes
node_podlikar -->|"uses model"| node_anthropic
node_ollama_config -.->|"configures optionally"| node_podlikar

click node_podlikar "https://github.com/igorbnd/podlikar/blob/main/podlikar-agent.yaml"
click node_health "https://github.com/igorbnd/podlikar/blob/main/podlikar-agent.yaml"
click node_diagnose "https://github.com/igorbnd/podlikar/blob/main/podlikar-agent.yaml"
click node_heal "https://github.com/igorbnd/podlikar/blob/main/podlikar-agent.yaml"
click node_ollama_config "https://github.com/igorbnd/podlikar/blob/main/ollama-model-config.yaml"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_podlikar,node_health,node_diagnose,node_heal toneBlue
class node_mcp,node_get_resources,node_describe,node_logs,node_events,node_resource_yaml,node_delete toneAmber
class node_anthropic,node_ollama_config toneMint
class node_user,node_kubernetes toneIndigo
```

## Components

### Agent

- [PodLikar agent](https://github.com/igorbnd/podlikar/blob/main/podlikar-agent.yaml): `podlikar-agent.yaml`
- [Health check](https://github.com/igorbnd/podlikar/blob/main/podlikar-agent.yaml): `podlikar-agent.yaml`
- [Pod diagnosis](https://github.com/igorbnd/podlikar/blob/main/podlikar-agent.yaml): `podlikar-agent.yaml`
- [Pod healing](https://github.com/igorbnd/podlikar/blob/main/podlikar-agent.yaml): `podlikar-agent.yaml`

### Cluster operations

- **kagent MCP server**
- **List resources**
- **Describe resource**
- **Get pod logs**
- **Get events**
- **Get resource YAML**
- **Delete resource**

### Model configurations

- **Anthropic model**
- [Ollama config](https://github.com/igorbnd/podlikar/blob/main/ollama-model-config.yaml): `ollama-model-config.yaml`

### Other components

- **Operator**
- **Kubernetes cluster**

## Connections

- Operator → PodLikar agent: invokes (evidence: `README.md`)
- PodLikar agent → Health check: supports (evidence: `README.md`)
- PodLikar agent → Pod diagnosis: supports (evidence: `README.md`)
- PodLikar agent → Pod healing: supports (evidence: `README.md`)
- PodLikar agent → kagent MCP server: uses tools (evidence: `README.md`)
- kagent MCP server → List resources: provides (evidence: `README.md`)
- kagent MCP server → Describe resource: provides (evidence: `README.md`)
- kagent MCP server → Get pod logs: provides (evidence: `README.md`)
- kagent MCP server → Get events: provides (evidence: `README.md`)
- kagent MCP server → Get resource YAML: provides (evidence: `README.md`)
- kagent MCP server → Delete resource: provides (evidence: `README.md`)
- List resources → Kubernetes cluster: reads resources (evidence: `README.md`)
- Describe resource → Kubernetes cluster: reads details (evidence: `README.md`)
- Get pod logs → Kubernetes cluster: reads logs (evidence: `README.md`)
- Get events → Kubernetes cluster: reads events (evidence: `README.md`)
- Get resource YAML → Kubernetes cluster: reads specs (evidence: `README.md`)
- Delete resource → Kubernetes cluster: deletes pods (evidence: `README.md`)
- PodLikar agent → Anthropic model: uses model (evidence: `README.md`)
- Ollama config → PodLikar agent: configures optionally (evidence: `README.md`)
