Cluster Code

  [![Cluster Code]](https://github.com/kcns008/cluster-code)

[Cluster Code]: https://img.shields.io/badge/Cluster%20Code-v1.0.0-brightgreen.svg?style=flat-square

AI-powered CLI tool for Kubernetes and OpenShift cluster management with intelligent diagnostics, multi-cloud support, and GitOps workflows.

⚡ Quick Start

$3

``sh
npm install -g cluster-code
`

$3

`sh


Option 1: Auto-detect from Claude Code (if ~/.claude/settings.json exists)

cluster-code will automatically use your Claude API key

Option 2: Set environment variables

export ANTHROPIC_API_KEY=your-api-key # Anthropic (Claude)
export OPENAI_API_KEY=your-api-key # Or OpenAI

Option 3: Use local models (no API key needed)

ollama pull llama3
cluster-code config provider add ollama
`

$3

`sh
cluster-code init
cluster-code
`

That's it! Start chatting with your cluster in plain English.

✨ Key Features

- 💬 Natural Language Interface - Control your cluster using plain English
- 🔍 AI-Powered Diagnostics - Intelligent troubleshooting with K8sGPT
- ☁️ Multi-Cloud Support - AWS EKS, Azure AKS/ARO, GCP GKE
- 🚀 GitOps Ready - Helm, Kustomize, ArgoCD, Flux integration
- 🔒 Local LLM Support - Use Ollama for complete data privacy
- 🎯 OpenShift Native - Routes, Operators, BuildConfigs support
- 🤖 RL-Based Management - Optional PufferLib integration for training AI agents

📚 Documentation

View Full Documentation →

- Installation Guide - Detailed setup instructions
- LLM Provider Setup - Configure Anthropic, OpenAI, Google, or local models
- Getting Started - First steps and tutorials
- PufferLib RL Guide - Reinforcement learning for cluster management
- API Reference - Complete command reference

💡 Usage Examples

$3

`bash
$ cluster-code

You: Show me all pods that are failing
You: Why is my deployment crashing?
You: Scale my app to 5 replicas
`

$3

`bash


Run cluster diagnostics

cluster-code diagnose

Analyze specific resources

cluster-code analyze pod my-pod

Deploy with Helm

cluster-code helm-deploy --chart ./my-chart --release my-app

Create cloud cluster

cluster-code azure-cluster-create --type aks --name prod-aks
`

$3

Train AI agents to automatically manage your cluster using PufferLib:

`bash


Set up RL environment (optional during init)

cluster-code rl setup

Train an agent

cluster-code rl train --episodes 500

Run RL-based diagnostics

cluster-code rl diagnose
``

See the PufferLib RL Guide for details.

🔌 Plugin Architecture

- cluster-core - Core Kubernetes operations
- k8sgpt-analyzers - AI-powered diagnostics
- cluster-openshift - OpenShift-specific features
- cloud-providers - Multi-cloud provisioning
- gitops - Deployment automation

Learn more about plugins →

🤝 Contributing

We welcome contributions! Check out our contributing guide to get started.

📝 License

MIT License - see LICENSE for details

🔗 Links

- Documentation
- GitHub Issues
- Changelog

---

Ready to get started? Install cluster-code and check out our Quick Start Guide →