{
  "id": "k8sgpt",
  "name": "K8sGPT",
  "homepage": "https://k8sgpt.ai/",
  "description": "Scanning your k8s clusters, diagnosing, and triaging issues in simple English",
  "executables": [
    "k8sgpt"
  ],
  "dotfiles": {
    "paths": [],
    "secret": [
      "[appData]/k8sgpt/k8sgpt.yaml",
      "[configHome]/k8sgpt/k8sgpt.yaml",
      "%LOCALAPPDATA%/k8sgpt/k8sgpt.yaml"
    ]
  },
  "commands": {
    "format": 1,
    "label": "K8sGPT",
    "description": "Scan a Kubernetes cluster for problems. Only the analyze command is modelled; backend setup (auth), filters, integrations and serve mode are left out.",
    "quality": "ai-draft",
    "parser": {
      "end_of_options": "--",
      "interleave": "permute",
      "long_equals": true,
      "short_attached": false,
      "short_bundles": false
    },
    "subcommand": [
      {
        "path": [
          "analyze"
        ],
        "label": "Analyze the cluster",
        "description": "Run a scan and optionally have the configured AI backend explain the issues. Explaining sends (optionally anonymized) resource data to that backend.",
        "source": [
          {
            "id": "readme",
            "kind": "manual",
            "url": "https://github.com/k8sgpt-ai/k8sgpt/blob/main/README.md",
            "revision": "main 2026-10-27",
            "evidence": "- Run `k8sgpt analyze` to run a scan.\n- And use `k8sgpt analyze --explain` to get a more detailed explanation of the issues.\n- You also run `k8sgpt analyze --with-doc` (with or without the explain flag) to get the official documentation from Kubernetes.\nk8sgpt analyze --explain --filter=Service\nk8sgpt analyze --explain --filter=Pod --namespace=default\nk8sgpt analyze --explain --filter=Service --output=json\nk8sgpt analyze --explain --filter=Service --output=json --anonymize\nYou can use `--backend` flag to specify a configured provider (it's `openai` by default).\nk8sgpt analyze --explain --backend litellm\n"
          }
        ],
        "field": [
          {
            "id": "explain",
            "label": "Explain with AI",
            "type": "boolean",
            "option": [
              "--explain"
            ],
            "sources": [
              "readme"
            ]
          },
          {
            "id": "with_doc",
            "label": "Include Kubernetes docs",
            "type": "boolean",
            "option": [
              "--with-doc"
            ],
            "sources": [
              "readme"
            ]
          },
          {
            "id": "filter",
            "label": "Resource filter",
            "description": "Analyzer to run, for example Pod or Service.",
            "type": "string",
            "option": [
              "--filter"
            ],
            "suggestions": [
              {
                "value": "Pod",
                "label": "Pod"
              },
              {
                "value": "Service",
                "label": "Service"
              },
              {
                "value": "Deployment",
                "label": "Deployment"
              },
              {
                "value": "Node",
                "label": "Node"
              }
            ],
            "sources": [
              "readme"
            ]
          },
          {
            "id": "namespace",
            "label": "Namespace",
            "type": "string",
            "option": [
              "--namespace"
            ],
            "sources": [
              "readme"
            ]
          },
          {
            "id": "output",
            "label": "Output format",
            "type": "string",
            "option": [
              "--output"
            ],
            "suggestions": [
              {
                "value": "json",
                "label": "JSON"
              }
            ],
            "sources": [
              "readme"
            ]
          },
          {
            "id": "anonymize",
            "label": "Anonymize data",
            "type": "boolean",
            "option": [
              "--anonymize"
            ],
            "sources": [
              "readme"
            ]
          },
          {
            "id": "backend",
            "label": "AI backend",
            "type": "string",
            "option": [
              "--backend"
            ],
            "suggestions": [
              {
                "value": "openai",
                "label": "OpenAI"
              },
              {
                "value": "localai",
                "label": "LocalAI"
              },
              {
                "value": "ollama",
                "label": "Ollama"
              }
            ],
            "sources": [
              "readme"
            ]
          }
        ],
        "task": [
          {
            "id": "scan",
            "label": "Quick scan",
            "fields": [
              "filter",
              "namespace",
              "output"
            ],
            "required": []
          },
          {
            "id": "explain",
            "label": "Scan and explain",
            "set": {
              "explain": [
                true
              ]
            },
            "fields": [
              "explain",
              "with_doc",
              "filter",
              "namespace",
              "anonymize",
              "backend"
            ],
            "required": []
          }
        ],
        "group": [
          {
            "id": "basic",
            "label": "Basic",
            "fields": [
              "explain",
              "filter",
              "namespace",
              "output"
            ]
          },
          {
            "id": "advanced",
            "label": "Advanced",
            "fields": [
              "with_doc",
              "anonymize",
              "backend"
            ]
          }
        ]
      }
    ]
  }
}