kube-copilot-agent is a Kubernetes operator that deploys AI agents inside your cluster. Pluggable, engine-agnostic, and fully Kubernetes-native โ manage everything with custom resources.
Everything you need to run AI agents as Kubernetes-native workloads
Swap the AI backend by changing the container image. Ships with GitHub Copilot SDK โ extend with Claude Code or any custom engine.
Maintain session continuity across multiple interactions. Agents remember context and build on previous responses.
Watch agent activity live via KubeCopilotChunk CRDs โ see thinking, tool calls, and results as they happen.
Load bash snippets from ConfigMaps or manage skills at runtime via the Web UI. Teach your agent new tricks on the fly.
Define inline agent personas with specific prompts and tool sets. Create specialized agents for different tasks.
Bring Your Own Key โ use external OpenAI-compatible or Azure OpenAI providers, with API keys stored securely in Kubernetes Secrets.
Switch AI models at runtime without redeploying. Choose the right model for each task from the UI settings.
Full chat interface with session history and settings panel. Optionally embed directly in the OpenShift Web Console.
Stop in-flight requests at any time. Cancel long-running or unwanted agent operations with a single action.
Kubernetes-native design โ everything is a custom resource
Get up and running in four steps
helm upgrade --install kube-copilot-agent ./helm/kube-copilot-agent \
--namespace kube-copilot-agent --create-namespace
helm upgrade --install my-agent ./helm/github-copilot-agent \
--namespace kube-copilot-agent \
--set githubToken.value=<your-github-pat>
helm upgrade --install kube-copilot-ui ./helm/kube-copilot-ui \
--namespace kube-copilot-agent
kubectl port-forward svc/kube-copilot-ui 8080:80 \
-n kube-copilot-agent
# Open: http://localhost:8080
copilot scope.
A modern chat interface with powerful settings and configuration
Everything you need to deploy, configure, and extend kube-copilot-agent
Comprehensive guide covering installation, configuration, usage, and the full CRD reference.
Get running in minutes with our step-by-step quick start instructions.
Learn about the pluggable engine architecture and how to create custom agent backends.
Detailed configuration reference for skills, custom instructions, BYOK providers, and more.
Want to contribute? Check out our contributing guidelines and development setup instructions.
View release notes, changelog, and download specific versions of the project.
The building blocks of kube-copilot-agent
| CRD | Purpose |
|---|---|
KubeCopilotAgent |
Declares an agent instance โ image, credentials, skills, instructions |
KubeCopilotSend |
Send a message to an agent; dispatched to the agent server |
KubeCopilotResponse |
Final response from the agent, written by the operator webhook |
KubeCopilotChunk |
Real-time streaming events โ thinking, tool calls, results |
KubeCopilotCancel |
Cancel an in-flight request |
Have questions, feedback, or want to contribute?