Skip to content
/ dot-ai Public
forked from vfarcic/dot-ai

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

salaboy/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

Contributing

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages

  • TypeScript 92.2%
  • Nushell 5.5%
  • Shell 1.1%
  • Other 1.2%