Apache 2.0 Kubernetes 1.20+ Go 1.25+

AI Agents for Kubernetes,
Controlled Through CRDs

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.

Features

Everything you need to run AI agents as Kubernetes-native workloads

๐Ÿ”Œ

Pluggable Engines

Swap the AI backend by changing the container image. Ships with GitHub Copilot SDK โ€” extend with Claude Code or any custom engine.

๐Ÿ’ฌ

Multi-Turn Conversations

Maintain session continuity across multiple interactions. Agents remember context and build on previous responses.

โšก

Real-Time Streaming

Watch agent activity live via KubeCopilotChunk CRDs โ€” see thinking, tool calls, and results as they happen.

๐Ÿ› ๏ธ

Custom Skills

Load bash snippets from ConfigMaps or manage skills at runtime via the Web UI. Teach your agent new tricks on the fly.

๐Ÿค–

Custom Agents

Define inline agent personas with specific prompts and tool sets. Create specialized agents for different tasks.

๐Ÿ”‘

BYOK Support

Bring Your Own Key โ€” use external OpenAI-compatible or Azure OpenAI providers, with API keys stored securely in Kubernetes Secrets.

๐ŸŽฏ

Dynamic Model Selection

Switch AI models at runtime without redeploying. Choose the right model for each task from the UI settings.

๐Ÿ–ฅ๏ธ

Web UI & OpenShift Plugin

Full chat interface with session history and settings panel. Optionally embed directly in the OpenShift Web Console.

๐Ÿšซ

Request Cancellation

Stop in-flight requests at any time. Cancel long-running or unwanted agent operations with a single action.

Architecture

Kubernetes-native design โ€” everything is a custom resource

User Interface
๐Ÿ–ฅ๏ธ Web UI Chat & Settings
๐Ÿ”ด OpenShift Plugin Console Integration
โ–ผ
Backend
โš™๏ธ Web UI Backend FastAPI ยท K8s Client
โ–ผ
Operator
๐ŸŽ›๏ธ Controller Manager Reconcile CRDs
๐Ÿ”— Webhook Server Chunk & Response
โ–ผ
Agent Runtime
๐Ÿค– Agent Pod Pluggable Engine
๐Ÿง  AI Backend Copilot SDK ยท Claude ยท Custom
๐Ÿ’พ PVC Storage Sessions ยท Skills ยท Agents
โ–ผ
Kubernetes Resources
๐Ÿ“‹ CRDs Send ยท Chunk ยท Response ยท Cancel
๐Ÿ” Secrets API Tokens ยท BYOK Keys

Quick Start

Get up and running in four steps

1

Install the Operator

helm upgrade --install kube-copilot-agent ./helm/kube-copilot-agent \
  --namespace kube-copilot-agent --create-namespace
2

Deploy an Agent

helm upgrade --install my-agent ./helm/github-copilot-agent \
  --namespace kube-copilot-agent \
  --set githubToken.value=<your-github-pat>
3

Deploy the Web UI

helm upgrade --install kube-copilot-ui ./helm/kube-copilot-ui \
  --namespace kube-copilot-agent
4

Access the UI

kubectl port-forward svc/kube-copilot-ui 8080:80 \
  -n kube-copilot-agent
# Open: http://localhost:8080
Prerequisites: kubectl v1.20+, Helm v3.10+, a Kubernetes or OpenShift cluster, and a GitHub PAT with copilot scope.

See It in Action

A modern chat interface with powerful settings and configuration

KubeCopilot Chat Interface

Documentation & Resources

Everything you need to deploy, configure, and extend kube-copilot-agent

Custom Resource Definitions

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

Get In Touch

Have questions, feedback, or want to contribute?