# DevOps AI Toolkit

> AI-powered Kubernetes operations for DevOps teams. Deploy, query, remediate, and operate Kubernetes resources through natural language using MCP, CLI, a Kubernetes controller, and a web UI.

DevOps AI Toolkit brings AI-powered intelligence to platform engineering, Kubernetes operations, and development workflows. Built on the Model Context Protocol (MCP), it integrates with Claude Code, Cursor, and VS Code for conversational DevOps automation.

- [Documentation](https://devopstoolkit.ai)
- [GitHub](https://github.com/vfarcic/dot-ai)

## Getting Started

- [DevOps AI Toolkit Stack](https://devopstoolkit.ai/docs/stack/index.md): Deploy the complete DevOps AI Toolkit stack with a single Helm command.
- [Operate Feature Architecture](https://devopstoolkit.ai/docs/stack/architecture/operate.md): This document provides a detailed architecture overview of the Operate feature in the DevOps AI Toolkit.
- [Query Feature Architecture](https://devopstoolkit.ai/docs/stack/architecture/query.md): This document provides a detailed architecture overview of the Query feature in the DevOps AI Toolkit.
- [Recommendation Feature Architecture](https://devopstoolkit.ai/docs/stack/architecture/recommendation.md): This document provides a detailed architecture overview of the Recommendation feature in the DevOps AI Toolkit.
- [Remediate Feature Architecture](https://devopstoolkit.ai/docs/stack/architecture/remediate.md): This document provides a detailed architecture overview of the Remediate feature in the DevOps AI Toolkit.

## AI Engine

- [DevOps AI Toolkit](https://devopstoolkit.ai/docs/ai-engine/index.md): AI-powered platform engineering and DevOps automation through intelligent Kubernetes operations and conversational workflows.
- [REST API Gateway](https://devopstoolkit.ai/docs/ai-engine/api/rest-api.md): Complete guide for accessing DevOps AI Toolkit functionality via standard HTTP REST endpoints.
- [Observability Guide](https://devopstoolkit.ai/docs/ai-engine/operations/observability.md): Complete guide for distributed tracing and observability in the DevOps AI Toolkit.
- [Telemetry Guide](https://devopstoolkit.ai/docs/ai-engine/operations/telemetry.md): Anonymous usage analytics to help improve DevOps AI Toolkit.
- [Organizational Data Management Concepts](https://devopstoolkit.ai/docs/ai-engine/organizational-data/concepts.md): Understanding the relationship between Capabilities, Patterns, and Policies in the DevOps AI Toolkit.
- [Pattern Management Guide](https://devopstoolkit.ai/docs/ai-engine/organizational-data/patterns.md): Complete guide for creating and managing organizational deployment patterns with the DevOps AI Toolkit.
- [Policy Management Guide](https://devopstoolkit.ai/docs/ai-engine/organizational-data/policies.md): Complete guide for creating and managing organizational policy intents with the DevOps AI Toolkit.
- [Quick Start](https://devopstoolkit.ai/docs/ai-engine/quick-start.md): Get started with DevOps AI Toolkit in minutes — deploy applications, manage policies, and remediate issues using AI-powered Kubernetes workflows.
- [AI Engine Deployment](https://devopstoolkit.ai/docs/ai-engine/setup/deployment.md): Deploy the DevOps AI Toolkit Engine to Kubernetes using Helm chart — production-ready deployment.
- [Gateway API Deployment Guide](https://devopstoolkit.ai/docs/ai-engine/setup/gateway-api.md): Deploy DevOps AI Toolkit using Kubernetes Gateway API v1 with production-ready reference pattern or development/testing creation pattern.
- [Capability Management Guide](https://devopstoolkit.ai/docs/ai-engine/tools/capability-management.md): Complete guide for discovering, managing, and leveraging Kubernetes resource capabilities with the DevOps AI Toolkit.
- [Knowledge Base Guide](https://devopstoolkit.ai/docs/ai-engine/tools/knowledge-base.md): Complete guide for ingesting and searching organizational documentation with the DevOps AI Toolkit.
- [Operate Guide](https://devopstoolkit.ai/docs/ai-engine/tools/operate.md): Complete guide for AI-powered Kubernetes operations with the DevOps AI Toolkit.
- [Tools and Features Overview](https://devopstoolkit.ai/docs/ai-engine/tools/overview.md): Quick reference to all available tools in the DevOps AI Toolkit.
- [GitHub Repository Setup & Governance Guide](https://devopstoolkit.ai/docs/ai-engine/tools/project-setup.md): Complete guide for AI-powered repository setup and governance with the DevOps AI Toolkit.
- [Shared Prompt Library](https://devopstoolkit.ai/docs/ai-engine/tools/prompts.md): Shared Prompts provide a centralized way to share and discover prompts across projects and team members. Instead of manually copying prompt files between projects, prompts are served directly through the DevOps AI Toolkit and automatically appear as native slash commands in AI coding agents.
- [Cluster Query Guide](https://devopstoolkit.ai/docs/ai-engine/tools/query.md): Complete guide for using natural language to query your Kubernetes cluster with the DevOps AI Toolkit.
- [Recommendation Guide](https://devopstoolkit.ai/docs/ai-engine/tools/recommend.md): Complete guide for AI-powered Kubernetes deployment recommendations with the DevOps AI Toolkit.
- [Remediate Guide](https://devopstoolkit.ai/docs/ai-engine/tools/remediate.md): Complete guide for AI-powered Kubernetes issue analysis and remediation with the DevOps AI Toolkit.
- [System Status Guide](https://devopstoolkit.ai/docs/ai-engine/tools/version.md): Quick diagnostics and health check for your DevOps AI Toolkit installation.

## MCP

- [MCP](https://devopstoolkit.ai/docs/mcp/index.md): Connect to the DevOps AI Toolkit Engine via MCP protocol from your preferred coding assistant.

## CLI

- [CLI Documentation](https://devopstoolkit.ai/docs/cli/index.md): Command-line interface for AI-powered Kubernetes operations
- [Automation](https://devopstoolkit.ai/docs/cli/guides/automation.md): Use the CLI in scripts, CI/CD pipelines, and automated workflows.
- [Commands Overview](https://devopstoolkit.ai/docs/cli/guides/cli-commands-overview.md): The CLI exposes all DevOps AI Toolkit server capabilities as commands. Commands are automatically generated from the server's OpenAPI specification.
- [Output Formats](https://devopstoolkit.ai/docs/cli/guides/output-formats.md): Control how the CLI formats command output.
- [Skills Generation](https://devopstoolkit.ai/docs/cli/guides/skills-generation.md): Enable AI agents to use the DevOps AI Toolkit CLI and access server prompts as native skills.
- [Quick Start](https://devopstoolkit.ai/docs/cli/quick-start.md): Get your AI agent using the DevOps AI Toolkit CLI.
- [Configuration](https://devopstoolkit.ai/docs/cli/setup/configuration.md): Configure the CLI to connect to your DevOps AI Toolkit server.
- [Installation](https://devopstoolkit.ai/docs/cli/setup/installation.md): Install the DevOps AI Toolkit CLI on your preferred platform.
- [Shell Completion](https://devopstoolkit.ai/docs/cli/setup/shell-completion.md): Enable command and flag autocompletion for your shell.

## Controller

- [DevOps AI Toolkit Controller](https://devopstoolkit.ai/docs/controller/index.md): A Kubernetes controller that provides resource tracking, event-driven remediation, and resource visibility capabilities for your cluster.
- [Capability Scan Guide](https://devopstoolkit.ai/docs/controller/capability-scan-guide.md): This guide covers the CapabilityScanConfig CRD for autonomous capability discovery and scanning in your Kubernetes cluster.
- [Knowledge Source Guide](https://devopstoolkit.ai/docs/controller/knowledge-source-guide.md): This guide covers the GitKnowledgeSource CRD for automatically syncing documentation from Git repositories into the DevOps AI Toolkit knowledge base.
- [Remediation Guide](https://devopstoolkit.ai/docs/controller/remediation-guide.md): This guide covers the RemediationPolicy CRD for event-driven remediation using the DevOps AI Toolkit.
- [Resource Sync Guide](https://devopstoolkit.ai/docs/controller/resource-sync-guide.md): This guide covers the ResourceSyncConfig CRD for enabling resource visibility and semantic search in your Kubernetes cluster.
- [Setup Guide](https://devopstoolkit.ai/docs/controller/setup-guide.md): This guide covers installation and initial setup of the DevOps AI Toolkit Controller.
- [Solution CRD Guide](https://devopstoolkit.ai/docs/controller/solution-guide.md): This video explains the problem of understanding what resources compose an application in Kubernetes, explores how Kubernetes ownership and ownerReferences work for garbage collection, and demonstrates how the Solution CRD provides a better approach by wrapping related resources into logical groups with status, context, and relationships.
- [Troubleshooting Guide](https://devopstoolkit.ai/docs/controller/troubleshooting.md): This guide covers common issues encountered when running the DevOps AI Toolkit Controller and their solutions.

## Web UI

- [DevOps AI Toolkit Web UI](https://devopstoolkit.ai/docs/ui/index.md): Kubernetes dashboard with AI-powered operations and rich visualizations for the DevOps AI Toolkit MCP server.
- [Kubernetes Setup Guide](https://devopstoolkit.ai/docs/ui/setup/kubernetes-setup.md): Deploy DevOps AI Toolkit Web UI to Kubernetes using Helm chart.