KCP Copilot

AI-powered GKE Control Plane TUI

Live Rust Go Claude Gemini

Talk to your Kubernetes cluster in natural language. Reason across both the Kubernetes API and GKE API simultaneously. Dual-model architecture: Claude for interactive NLP reasoning, Gemini for proactive background monitoring.

View on GitHub Back to Portfolio

Architecture

Component flow showing how KCP Copilot orchestrates multiple APIs with dual AI models for intelligent cluster reasoning.

User ratatui + crossterm Rust TUI gRPC Go Agent In-cluster gRPC ServiceAccount RBAC Kubernetes API • GetPods • GetEvents • GetLogs • Scale/Rollback GKE API • Cluster Info • Node Pools • Upgrades • Security Posture GMP/Prometheus • API Latency • etcd Health • Scheduler Perf • PromQL Claude API Interactive NLP Reasoning & Tool Selection Gemini API Background Monitoring Proactive Insights Real-time Analysis

Features

Comprehensive tools for intelligent cluster management and monitoring.

💬

Natural Language Queries

Ask "what pods are failing?" or "why is redis crashlooping?" — Claude translates your questions to intelligent gRPC calls and provides actionable insights.

☁️

GKE API Integration

Access control plane data not available in kubectl — node pools, upgrade info, maintenance windows, security posture, and cluster operations.

📊

Live Metrics

Query GMP/Prometheus for control plane metrics — API server latency, etcd health, scheduler performance, and more with PromQL support.

🤖

Dual-Model Architecture

Claude for interactive reasoning and decision-making. Gemini for proactive background monitoring with real-time insights and anomaly detection.

⚙️

In-Cluster Agent

Go gRPC server with Workload Identity, RBAC-scoped ServiceAccount, and zero credentials to manage. Secure by default with minimal configuration.

⌨️

TUI Interface

Full terminal UI with chat panel, cluster overview, Gemini insights feed, and keyboard navigation for a seamless command-line experience.

Try It Out

A simulated demo of the KCP Copilot TUI — see how natural language queries translate to cluster insights.

KCP Copilot | Claude Connected | Gemini | Ctrl+C quit
Chat (Claude)
Connected to GKE cluster. Ask me anything!
› █
Cluster Overview
Nodes
gke-sympozium-default-pool-...cbf6
gke-sympozium-default-pool-...js03
v1.34.4-gke.1047000
Namespaces
cert-manager (3/3)
default (1/1)
gmp-system (5/5)
kube-system (32/32)
sympozium-showcase (6/6)
Recent Warnings
None — cluster healthy
Watch a simulated conversation with the cluster

Live Control Plane Metrics

Real-time monitoring of your GKE control plane health and performance.

Live metrics from running cluster
✓ These are real metrics from the running GKE cluster. The dashboards below show actual API server, etcd, and scheduler performance.

Available gRPC Tools

Comprehensive tool coverage for cluster introspection, management, and monitoring.

API Category Available Tools Description
Kubernetes API GetPods • GetEvents • GetLogs • DescribeResource • GetClusterOverview • ScaleDeployment • RollbackDeployment Core pod and workload introspection, lifecycle management, and resource description.
GKE API GetGKEClusterInfo • GetNodePools • GetUpgradeInfo • GetMaintenanceWindows • GetSecurityPosture • GetClusterOperations Control plane operations, cluster configuration, and security posture information.
Monitoring QueryMetrics PromQL queries via Google Managed Prometheus for control plane performance metrics.

Quick Start

Get KCP Copilot running in minutes on your GKE cluster.

Setup & Run

# Port-forward the agent
kubectl port-forward svc/kcp-agent 50051:50051 -n sympozium-showcase

# Set API keys and run
export ANTHROPIC_API_KEY="sk-ant-..."
export GEMINI_API_KEY="AIza..."  # optional
cd tui && cargo run

The gRPC agent runs in your cluster with RBAC-scoped permissions. Your API keys are only stored locally in the TUI environment.