Kstack: Pacote de Habilidades para Claude Code para Monitorar e Solucionar Problemas no Kubernetes

Kstack é um pacote de habilidades para o Claude Code (e outros agentes de codificação de IA) que expõe um conjunto de comandos de barra para monitoramento e solução de problemas em clusters Kubernetes. Ele se integra ao seu kubeconfig existente e permissões RBAC, executa ferramentas padrão como kubectl, Kubetail, Trivy, Pluto, e entrega os resultados ao LLM para análise — visando respostas rápidas e eficientes em tokens.

Habilidades Principais

• /cluster-status — instantâneo de saúde (reinicializações de pods, condições de nós, pressão de recursos)
• /events — eventos recentes classificados por gravidade
• /investigate — análise de causa raiz entre eventos, logs e recursos relacionados
• /logs — sessão tmux compartilhada que traduz linguagem natural para buscas de logs (via Kubetail)
• /metrics — métricas de CPU, memória e outros recursos para pods, nós, workloads
• /exec — shell tmux compartilhado em um pod, nó ou contêiner de depuração efêmero
• /audit-security — RBAC, postura de segurança de pods, reforço de privilégios
• /audit-network — verificação de NetworkPolicy, Service, Ingress, GatewayAPI, DNS e criptografia
• /audit-cost — requisições vs. uso, superprovisionamento, capacidade ociosa
• /audit-outdated — serviços desatualizados, CVEs conhecidos, atualizações de versão disponíveis
• /cleanup — remove todos os recursos de propriedade do kstack (contêineres de depuração, clones de pods, jobs de monitoramento)
• /forget — limpa cache local e conhecimento do cluster

Instalação

Instalação global:

curl -sS https://kstack.sh/install | bash

Instalação local no projeto:

curl -sS https://kstack.sh/install | bash -s -- --local

Por padrão, as habilidades são prefixadas com kstack-*; use --no-prefix para desabilitar. O instalador detecta automaticamente agentes no seu PATH e instala para cada um. Agentes suportados incluem Claude Code, OpenAI Codex CLI (--agent codex), OpenCode (--agent opencode), Cursor (--agent cursor), Factory Droid (--agent factory), Slate (--agent slate), Kiro (--agent kiro) e Hermes (--agent hermes).

Como Funciona

Todas as habilidades são somente leitura por padrão — mutações exigem confirmação explícita. Elas respeitam seu contexto local do kubeconfig e RBAC. Se as permissões forem insuficientes, o kstack reporta o problema. Flags globais como --context <ctx> são suportadas em todas as habilidades.

Para Quem é

Desenvolvedores e engenheiros de plataforma que usam agentes de codificação de IA e precisam de monitoramento e depuração rápidos, orientados por linguagem natural, de clusters Kubernetes sem trocar de contexto.