Thanks to visit codestin.com
Credit goes to github.com

Skip to content
/ dot-ai Public

Intelligent dual-mode agent for deploying applications to ANY Kubernetes cluster through dynamic discovery and plain English governance

License

Notifications You must be signed in to change notification settings

vfarcic/dot-ai

Folders and files

NameName
Last commit message
Last commit date

Latest commit

Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 

Repository files navigation

DevOps AI Toolkit

DevOps AI Toolkit Logo

DevOps AI Toolkit is an AI-powered development productivity platform that enhances software development workflows through intelligent automation and AI-driven assistance.

πŸ“š Quick Start | πŸ”§ MCP Setup | πŸ› οΈ Features & Tools

Who is this for?

Kubernetes Deployment

  • Developers: Deploy applications without needing deep Kubernetes expertise
  • Platform Engineers: Create organizational deployment patterns that enhance AI recommendations with institutional knowledge and best practices, and scan cluster resources to enable semantic matching for dramatically improved recommendation accuracy
  • Security Engineers: Define governance policies that integrate into deployment workflows with optional Kyverno enforcement

Kubernetes Issue Remediation

  • DevOps Engineers: Quickly diagnose and fix Kubernetes issues without deep troubleshooting expertise
  • SRE Teams: Automate root cause analysis and generate executable remediation commands
  • Support Teams: Handle incident response with AI-guided investigation and repair workflows

Documentation Testing

  • Documentation Maintainers: Automatically validate documentation accuracy and catch outdated content
  • Technical Writers: Identify which sections need updates and prioritize work effectively
  • Open Source Maintainers: Ensure documentation works correctly for new contributors

Shared Prompts Library

  • Development Teams: Share proven prompts across projects without file management
  • Project Managers: Standardize workflows with consistent prompt usage across teams
  • Individual Developers: Access curated prompt library via native slash commands

AI Integration

  • AI Agents: Integrate all capabilities with Claude Code, Cursor, or VS Code for conversational workflows
  • Multiple AI Providers: Choose from multiple AI models and providers to optimize for quality, cost, and reliability - see AI Model Configuration
  • REST API: Access all tools via standard HTTP endpoints for CI/CD pipelines, automation scripts, and traditional applications

Key Features

Kubernetes Deployment Intelligence

πŸ” Smart Discovery: Automatically finds all available resources and operators in your cluster
🧠 Semantic Capability Management: Discovers what each resource actually does for intelligent matching
πŸ€– AI Recommendations: Smart intent clarification gathers missing context, then provides deployment suggestions tailored to your specific cluster setup with enhanced semantic understanding
πŸ”§ Operator-Aware: Leverages custom operators and CRDs when available
πŸš€ Complete Workflow: From discovery to deployment with automated Kubernetes integration

πŸ“– Learn more β†’

Capability-Enhanced Recommendations

Transform how AI understands your cluster by discovering semantic capabilities of each resource:

The Problem: Traditional discovery sees sqls.devopstoolkit.live as a meaningless name among hundreds of resources.

The Solution: Capability management teaches the system that sqls.devopstoolkit.live handles PostgreSQL databases with multi-cloud support.

Before Capability Management:

User: "I need a PostgreSQL database"
AI: Gets 400+ generic resource names β†’ picks complex multi-resource solution
Result: Misses optimal single-resource solutions

After Capability Management:

User: "I need a PostgreSQL database"  
AI: Gets pre-filtered relevant resources with rich context
Result: Finds sqls.devopstoolkit.live as perfect match ✨

πŸ“– Learn more β†’

Kubernetes Issue Remediation

πŸ” AI-Powered Root Cause Analysis: Multi-step investigation loop identifies the real cause behind Kubernetes failures
πŸ› οΈ Executable Remediation: Generates specific kubectl commands with risk assessment and validation
⚑ Dual Execution Modes: Manual approval workflow or automatic execution based on confidence thresholds
πŸ”’ Safety Mechanisms: Automatic fallback to manual mode when validation discovers additional issues
🎯 Cross-Resource Intelligence: Understands how pod issues may require fixes in different resource types (storage, networking, etc.)

πŸ“– Learn more β†’

Documentation Testing & Validation

πŸ“– Automated Testing: Validates documentation by executing commands and testing examples
πŸ” Two-Phase Validation: Tests both functionality (does it work?) and semantic accuracy (are descriptions truthful?)
πŸ› οΈ Fix Application: User-driven selection and application of recommended documentation improvements
πŸ’Ύ Session Management: Resumable testing workflows for large documentation sets

πŸ“– Learn more β†’

Organizational Pattern Management

πŸ›οΈ Pattern Creation: Define organizational deployment patterns that capture institutional knowledge
🧠 AI Enhancement: Patterns automatically enhance deployment recommendations with organizational context
πŸ” Semantic Search: Uses Vector DB (Qdrant) for intelligent pattern matching based on user intent
πŸ“‹ Best Practices: Share deployment standards across teams through reusable patterns

πŸ“– Learn more β†’

Policy Management & Governance

πŸ›‘οΈ Policy Creation: Define governance policies that guide users toward compliant configurations
⚠️ Compliance Integration: Policies create required questions with compliance indicators during deployment
πŸ€– Kyverno Generation: Automatically generates Kyverno ClusterPolicies for active enforcement
🎯 Proactive Governance: Prevents configuration drift by embedding compliance into the recommendation workflow
πŸ” Vector Storage: Uses Qdrant Vector DB for semantic policy matching and retrieval

πŸ“– Learn more β†’

Shared Prompts Library

🎯 Native Slash Commands: Prompts appear as /dot-ai:prompt-name in your coding agent
πŸ“š Curated Library: Access proven prompts for code review, documentation, architecture, and project management
πŸ”„ Zero Setup: Connect to MCP server and prompts are immediately available across all projects
🀝 Team Consistency: Standardized prompt usage with centralized management

πŸ“– Learn more β†’

AI Integration

⚑ MCP Integration: Works seamlessly with Claude Code, Cursor, or VS Code through Model Context Protocol πŸ€– Conversational Interface: Natural language interaction for deployment, documentation testing, pattern management, and shared prompt workflows 🎯 Multiple AI Providers: Choose from multiple AI models and providers to optimize for quality, cost, and reliability - see AI Model Configuration

Setup Required: See the MCP Setup Guide for complete configuration instructions.


πŸš€ Ready to deploy? Jump to the Quick Start guide to begin using DevOps AI Toolkit.

See It In Action

DevOps AI Toolkit: AI-Powered Application Deployment

This video explains the platform engineering problem and demonstrates the Kubernetes deployment recommendation workflow from intent to running applications.

Documentation

πŸš€ Getting Started

Troubleshooting

MCP Issues

MCP server won't start:

  • Verify environment variables are correctly configured in .mcp.json env section
  • Check session directory exists and is writable
  • Ensure ANTHROPIC_API_KEY is valid

"No active cluster" errors:

  • Verify kubectl connectivity: kubectl cluster-info
  • Check KUBECONFIG path in environment variables
  • Test cluster access: kubectl get nodes

Support

Contributing

We welcome contributions! Please:

  • Fork the repository and create a feature branch
  • Run integration tests to ensure changes work correctly (see Integration Testing Guide)
  • Follow existing code style and conventions
  • Submit a pull request with a clear description of changes

License

MIT License - see LICENSE file for details.


DevOps AI Toolkit - AI-powered development productivity platform for enhanced software development workflows.

About

Intelligent dual-mode agent for deploying applications to ANY Kubernetes cluster through dynamic discovery and plain English governance

Resources

License

Stars

Watchers

Forks

Packages