kube-ai-devkit

Kube AI DevKit

AI-powered Kubernetes developer platform for Claude Code. Combines Tilt (local dev), ArgoCD (staging/prod), and Claude Code skills into a unified developer experience.

What's Included

Component	Description
Tilt MCP Server	11 tools wrapping the Tilt CLI as an MCP server
ArgoCD Integration	Config templates for the pre-built ArgoCD MCP
9 Skills	Claude Code skills for K8s workflows
3 Hooks	Deploy safety checks for Tilt and ArgoCD
2 Subagents	K8s diagnostician + deploy verifier
Plugin System	.claude-plugin compatible for marketplace and modular installs
Templates	CLAUDE.md, Tiltfile templates

Quick Start

Option A: As a Claude Code Plugin (recommended)

This project follows the .claude-plugin convention. Claude Code can discover and load it natively via the .claude-plugin/ directory, .mcp.json, hooks/hooks.json, and skills/.

git clone https://github.com/yourorg/kube-ai-devkit ~/kube-ai-devkit
cd ~/kube-ai-devkit/packages/mcp-tilt-server && npm install && npm run build

Option B: Modular Install

Pick which modules to install by creating a .claude-plugin file in your project:

{
  "plugins": [
    {
      "source": "~/kube-ai-devkit",
      "modules": ["tilt", "argocd", "k8s-core"],
      "templates": ["CLAUDE.md", "Tiltfile"]
    }
  ]
}

Then run:

bash ~/kube-ai-devkit/bin/install.sh .

The installer reads your .claude-plugin, installs only the modules you selected, and generates settings.json with the right MCP servers, hooks, permissions, and subagents.

Option C: Full Bootstrap

bash ~/kube-ai-devkit/bin/init.sh .

Installs everything (all skills, hooks, rules, and templates).

Available Modules

Module	What it installs
tilt	4 skills, 2 hooks, Tilt MCP server, k8s-diagnostician subagent
argocd	4 skills, 1 hook, ArgoCD MCP server, deploy-verifier subagent
k8s-core	1 skill (/k8s-debug), K8s rules, kubectl permissions

Skills

Local Development (Tilt)

Skill	Description
/tilt-up	Start local K8s environment with prerequisites check
/tilt-status	Show environment status dashboard
/deploy-service	Build and deploy a service, verify health
/service-logs	Get and analyze service logs

Kubernetes Core

Skill	Description
/k8s-debug	Diagnose why a service is unhealthy

Staging/Production (ArgoCD)

Skill	Description
/staging-status	Check staging environment health
/drift-check	Detect configuration drift from Git
/diagnose-staging	Investigate staging issues with logs and events
/compare-environments	Diff local vs staging

Tilt MCP Server

The Tilt MCP server wraps the Tilt CLI as an MCP server for Claude Code.

Tools

Tool	Description	Read-Only
tilt_status	Session status + resource counts	Yes
tilt_get_resources	List all resources with filters	Yes
tilt_get_resource	Single resource detail	Yes
tilt_logs	Resource log output	Yes
tilt_describe	Full K8s-style describe	Yes
tilt_up	Start Tilt environment	No
tilt_down	Tear down environment	No
tilt_trigger	Force rebuild a resource	No
tilt_enable	Enable a resource	No
tilt_disable	Disable a resource	No
tilt_wait	Wait for resource condition	No

Standalone Usage

npm install -g @anthropic/mcp-tilt-server
npx @anthropic/mcp-tilt-server

Project Structure