aidevops 2.52.1 → 2.53.2

package/.agent/tools/ai-assistants/overview.md

@@ -1,209 +0,0 @@
----
-description: Overview of AI CLI tools and assistants
-mode: subagent
-tools:
-  read: true
-  write: false
-  edit: false
-  bash: false
-  glob: true
-  grep: true
-  webfetch: true
-  task: true
----
-
-# AI CLI Tools & Assistants - Comprehensive Reference
-
-<!-- AI-CONTEXT-START -->
-
-## Quick Reference
-
-- Recommended: OpenCode (`curl -fsSL https://opencode.ai/install | bash`) - native MCP support
-- Professional: Claude Desktop, Augment Code (`npm install -g @augmentcode/cli`), AmpCode, Continue.dev
-- Enterprise: OpenAI Codex, Factory AI Droid, Qwen
-- Terminal: Warp AI (warp.dev)
-- System prompt: "Read ~/Git/aidevops/AGENTS.md before DevOps operations"
-- Setup: Clone repo -> Run setup.sh -> Configure AI tool with system prompt
-- Config locations: ~/.config/opencode/, claude_desktop_config.json
-- Test: Ask AI to "Read AGENTS.md and summarize DevOps integrations"
-- Related docs: MCP-INTEGRATIONS.md, API-INTEGRATIONS.md, SECURITY.md
-<!-- AI-CONTEXT-END -->
-
-This document provides a comprehensive list of CLI AI assistants and tools that work excellently with the AI DevOps Framework.
-
-## Recommended CLI AI Assistants
-
-### **Preferred Tool**
-
-#### **[OpenCode](https://opencode.ai/)** - Recommended
-
-- **Description**: Powerful TUI/CLI AI coding assistant with excellent MCP support
-- **Installation**: `curl -fsSL https://opencode.ai/install | bash`
-- **Best For**: Terminal-based development, MCP integrations, DevOps workflows
-- **Framework Integration**: **Excellent** - Native MCP support, custom tools, AGENTS.md compatible
-- **Key Features**:
-  - Beautiful terminal UI with keyboard-driven workflow
-  - Built-in MCP server support (local and remote)
-  - Custom tool definitions via TypeScript
-  - Multi-provider support (OpenAI, Anthropic, etc.)
-  - GitHub/GitLab integration
-- **Configuration**: See `~/.config/opencode/opencode.json` or project `.opencode/`
-
-### **Professional Development Assistants**
-
-#### **[Claude Desktop](https://claude.ai/)**
-
-- **Description**: Anthropic's Claude with advanced code capabilities and MCP support
-- **Installation**: Desktop app + CLI tools available
-- **Best For**: Complex reasoning, documentation, security analysis
-- **Framework Integration**: Excellent - strong understanding of infrastructure patterns
-
-#### **[Augment Code (Auggie)](https://www.augmentcode.com/)**
-
-- **Description**: Professional AI coding assistant with deep codebase context
-- **Installation**: `npm install -g @augmentcode/cli`
-- **Best For**: Complex codebase analysis, refactoring, architecture decisions
-- **Framework Integration**: Excellent - understands repository structure and context
-
-#### **[AmpCode](https://ampcode.com/)**
-
-- **Description**: Professional AI coding assistant
-- **Installation**: Visit [ampcode.com](https://ampcode.com/) for setup instructions
-- **Best For**: Code generation, refactoring, development workflows
-- **Framework Integration**: Good - works well with DevOps tasks
-
-#### **[Continue.dev](https://continue.dev/)**
-
-- **Description**: Open-source AI pair programmer for VS Code and JetBrains
-- **Installation**: Install via IDE extension marketplace
-- **Best For**: IDE-integrated AI assistance, pair programming
-- **Framework Integration**: Good - integrates with project context
-
-### **Enterprise & Specialized Tools**
-
-#### **[OpenAI Codex](https://openai.com/codex/)**
-
-- **Description**: OpenAI's code-focused AI model
-- **Installation**: Via OpenAI API and compatible clients
-- **Best For**: Code generation, API integrations, automation scripts
-- **Framework Integration**: Good - strong API and scripting capabilities
-
-#### **[Factory AI Droid](https://www.factory.ai/)**
-
-- **Description**: Enterprise AI development platform
-- **Installation**: Visit [factory.ai](https://www.factory.ai/) for enterprise setup
-- **Best For**: Large-scale development projects, team collaboration
-- **Framework Integration**: Excellent - designed for enterprise DevOps workflows
-
-#### **[Qwen](https://qwenlm.github.io/)**
-
-- **Description**: Alibaba's multilingual AI assistant
-- **Installation**: Visit [qwenlm.github.io](https://qwenlm.github.io/) for setup
-- **Best For**: Multilingual projects, international deployments
-- **Framework Integration**: Good - supports diverse infrastructure requirements
-
-### **Terminal-Integrated Solutions**
-
-#### **[Warp AI](https://www.warp.dev/)**
-
-- **Description**: AI-powered terminal with built-in assistance
-- **Installation**: Visit [warp.dev](https://www.warp.dev/) for download
-- **Best For**: Interactive terminal sessions, command discovery
-- **Framework Integration**: Excellent - native terminal integration
-
-## 🔧 **System Prompt Configuration**
-
-### **Recommended System Prompt Addition**
-
-Add this to your AI assistant's system prompt for optimal framework integration:
-
-```text
-Before performing any DevOps operations, always read ~/Git/aidevops/AGENTS.md
-for authoritative guidance on this comprehensive infrastructure management framework.
-
-This framework provides access to 25+ service integrations including:
-- Hosting providers (Hostinger, Hetzner, Closte)
-- DNS management (Spaceship, 101domains, Route53)
-- Security services (Vaultwarden, SES, SSL certificates)
-- Development tools (Git platforms, code auditing, monitoring)
-- MCP server integrations for real-time API access
-
-Always follow the security practices and operational patterns defined in the AGENTS.md file.
-```
-
-### **Tool-Specific Configuration**
-
-#### **For Augment Code (Auggie)**
-
-```bash
-# Add to your shell profile
-export AUGMENT_SYSTEM_PROMPT="Read ~/Git/aidevops/AGENTS.md before DevOps operations"
-```
-
-#### **For Claude Desktop**
-
-Add to `claude_desktop_config.json`:
-
-```json
-{
-  "systemPrompt": "Before DevOps operations, read ~/Git/aidevops/AGENTS.md for guidance",
-  "workingDirectory": "~/Git/aidevops"
-}
-```
-
-#### **For Warp AI**
-
-```bash
-# Create a Warp workflow
-warp-cli workflow create devops-setup \
-  --command "cd ~/Git/aidevops && cat AGENTS.md"
-```
-
-## 🚀 **Quick Setup for Each Tool**
-
-### **Universal Setup Steps**
-
-1. **Clone the framework**:
-
-   ```bash
-   mkdir -p ~/git && cd ~/git
-   git clone https://github.com/marcusquinn/aidevops.git
-   ```
-
-2. **Run initial setup**:
-
-   ```bash
-   cd aidevops && ./setup.sh
-   ```
-
-3. **Configure your AI tool** with the system prompt above
-
-4. **Test integration**:
-
-   ```bash
-   # Ask your AI assistant:
-   "Read the AGENTS.md file and summarize the available DevOps integrations"
-   ```
-
-## 📚 **Additional Resources**
-
-- **[AGENTS.md](../AGENTS.md)** - Authoritative operational guidance
-- **[MCP Integrations](MCP-INTEGRATIONS.md)** - Model Context Protocol setup
-- **[API Integrations](API-INTEGRATIONS.md)** - Service provider configurations
-- **[Security Best Practices](SECURITY.md)** - Enterprise-grade security guidance
-
-## 🔗 **Official Links**
-
-- **OpenCode**: https://opencode.ai/ (Recommended)
-- **Claude**: https://claude.ai/
-- **Augment Code**: https://www.augmentcode.com/
-- **AmpCode**: https://ampcode.com/
-- **Continue.dev**: https://continue.dev/
-- **OpenAI Codex**: https://openai.com/codex/
-- **Factory AI (Droid)**: https://www.factory.ai/
-- **Qwen**: https://qwenlm.github.io/
-- **Warp**: https://www.warp.dev/
-
----
-
-**💡 Pro Tip**: Start with **OpenCode** for the best framework integration experience. It has native MCP support, custom tool definitions, and excellent terminal-based workflow for DevOps operations. For GUI-based work, Claude Desktop is also excellent.

package/.agent/tools/ai-assistants/status.md

@@ -1,171 +0,0 @@
----
-description: AI CLI integration status and coverage
-mode: subagent
-tools:
-  read: true
-  write: false
-  edit: false
-  bash: false
-  glob: true
-  grep: true
-  webfetch: true
-  task: true
----
-
-# AI CLI Integration Status - Complete Coverage
-
-<!-- AI-CONTEXT-START -->
-
-## Quick Reference
-
-- 7 AI CLI tools integrated with automatic AGENTS.md reading
-- Primary: Aider (v0.86.1), Claude CLI (v2.0.36), Qwen CLI (v0.2.0), OpenAI CLI (v2.7.2)
-- Supporting: AI Shell (v1.0.12), LiteLLM (v1.79.3), Hugging Face CLI
-- Universal wrapper: `~/.local/bin/ai-with-context <tool> [args]`
-- Config files: ~/.aider.conf.yml, ~/.claude/config.json, ~/.qwen/config.json, ~/.openai/config.yaml
-- Aliases: aider-guided, claude-guided, qwen-guided, openai-guided, ai-guided
-- Quick access: `agents` (view AGENTS.md), `cdai` (cd to framework)
-- Setup: Automated via setup.sh -> configure_ai_clis -> .agent/scripts/ai-cli-config.sh
-- Status: All tools verified working with AGENTS.md context
-<!-- AI-CONTEXT-END -->
-
-## Comprehensive AI CLI Integration Achieved
-
-### Fully Integrated AI CLI Tools:
-
-## **🤖 PRIMARY AI ASSISTANTS:**
-
-### **1. Aider AI** - **FULLY AUTOMATED** ✅
-
-- **Version**: 0.86.1
-- **Model**: `openrouter/anthropic/claude-sonnet-4`
-- **Auto-reads**: Both AGENTS.md files on every session start
-- **Config**: `~/.aider.conf.yml`
-- **Status**: **VERIFIED WORKING** - Successfully loads AGENTS.md files
-- **Usage**: `aider` (automatic) or `aider-guided` (explicit)
-
-### **2. Claude CLI** - **FULLY CONFIGURED** ✅
-
-- **Version**: 2.0.36 (Claude Code)
-- **Model**: `claude-3-sonnet-20240229`
-- **Auto-context**: Both AGENTS.md files
-- **Config**: `~/.claude/config.json`
-- **Status**: **READY FOR USE**
-- **Usage**: `claude` or `claude-guided` or `ai-with-context claude`
-
-### **3. Qwen CLI** - **NEWLY INTEGRATED** ✅
-
-- **Version**: 0.2.0
-- **Model**: `qwen2.5-72b-instruct`
-- **Auto-context**: Both AGENTS.md files
-- **Config**: `~/.qwen/config.json`
-- **Status**: **READY FOR USE**
-- **Usage**: `qwen` or `qwen-guided` or `ai-with-context qwen`
-
-### **4. OpenAI CLI** - **SYSTEM MESSAGE INTEGRATION** ✅
-
-- **Version**: 2.7.2
-- **Model**: GPT-4 with framework context
-- **System Message**: Includes AGENTS.md guidance
-- **Config**: `~/.openai/config.yaml`
-- **Status**: **VERIFIED WORKING** - API calls successful
-- **Usage**: `openai` or `openai-guided`
-
-## **🔧 SUPPORTING AI TOOLS:**
-
-### **5. AI Shell** - **CONTEXT INTEGRATION** ✅
-
-- **Version**: 1.0.12
-- **Model**: GPT-4 with AGENTS.md guidance
-- **Auto-context**: Both AGENTS.md files
-- **Config**: `~/.ai-shell/config.json`
-- **Usage**: `ai-shell` or `ai-guided`
-
-### **6. LiteLLM** - **MULTI-MODEL SUPPORT** ✅
-
-- **Version**: 1.79.3
-- **Models**: OpenAI, Anthropic, others with unified context
-- **System Message**: AGENTS.md guidance included
-- **Config**: `~/.litellm/config.yaml`
-- **Usage**: `litellm` with consistent context
-
-### **7. Hugging Face CLI** - **ACCESSIBLE** ✅
-
-- **Status**: Ready for model downloads and management
-- **Usage**: Available for AI model operations
-
-## **🚀 INTEGRATION FEATURES:**
-
-### **✅ UNIVERSAL AI WRAPPER:**
-
-- **Script**: `~/.local/bin/ai-with-context`
-- **Supports**: aider, openai, claude, qwen, ai-shell, litellm
-- **Features**: Shows AGENTS.md content before launching any AI tool
-- **Usage**: `ai-with-context <tool> [args...]`
-
-### **✅ SHELL ALIASES:**
-
-```bash
-# AI tools with explicit AGENTS.md context
-alias aider-guided='aider --read ~/AGENTS.md --read ~/Git/aidevops/AGENTS.md'
-alias claude-guided='echo "Reading AGENTS.md..." && cat ~/AGENTS.md && claude'
-alias qwen-guided='echo "Reading AGENTS.md..." && cat ~/AGENTS.md && qwen'
-alias openai-guided='echo "Reading AGENTS.md..." && cat ~/AGENTS.md && openai'
-alias ai-guided='echo "Reading AGENTS.md..." && cat ~/AGENTS.md && ai-shell'
-
-# Quick access
-alias agents='cat ~/Git/aidevops/AGENTS.md'
-alias cdai='cd ~/Git/aidevops'
-```
-
-### **✅ AUTOMATIC SETUP INTEGRATION:**
-
-- **Setup Script**: `setup.sh` includes `configure_ai_clis` function
-- **Configuration Script**: `.agent/scripts/ai-cli-config.sh`
-- **All new installations** get complete AI CLI configuration
-
-## **🎯 COVERAGE SUMMARY:**
-
-### **✅ QUESTION ANSWERED:**
-
-**Q: Does that include Qwen and Claude?**
-**A: YES - BOTH FULLY INTEGRATED!** ✅
-
-### **Claude CLI Integration:**
-
-- ✅ **Installed**: Version 2.0.36 (Claude Code)
-- ✅ **Configured**: Auto-reads AGENTS.md files
-- ✅ **Aliases**: `claude-guided` available
-- ✅ **Universal Wrapper**: `ai-with-context claude` works
-- ✅ **Setup Integration**: Included in setup.sh
-
-### **Qwen CLI Integration:**
-
-- ✅ **Installed**: Version 0.2.0
-- ✅ **Configured**: Auto-context with AGENTS.md files
-- ✅ **Aliases**: `qwen-guided` available
-- ✅ **Universal Wrapper**: `ai-with-context qwen` works
-- ✅ **Setup Integration**: Included in setup.sh
-
-## **🌟 COMPREHENSIVE AI ECOSYSTEM:**
-
-### **Total AI CLI Tools Integrated: 7**
-
-1. **Aider AI** - AI pair programming
-2. **Claude CLI** - Anthropic's Claude assistant
-3. **Qwen CLI** - Alibaba's Qwen model
-4. **OpenAI CLI** - GPT models access
-5. **AI Shell** - AI-powered shell commands
-6. **LiteLLM** - Multi-provider LLM proxy
-7. **Hugging Face CLI** - Model management
-
-### **All Tools Feature:**
-
-- ✅ **Automatic AGENTS.md reading**
-- ✅ **Consistent DevOps framework context**
-- ✅ **Security-conscious configuration**
-- ✅ **Universal wrapper support**
-- ✅ **Shell alias integration**
-- ✅ **Setup script automation**
-
-**RESULT: Complete AI CLI ecosystem with automatic AGENTS.md integration across all major AI providers including Claude and Qwen!** 🎉

package/.agent/tools/ai-assistants/windsurf.md

@@ -1,193 +0,0 @@
----
-description: Windsurf IDE integration for AI DevOps
-mode: subagent
-tools:
-  read: true
-  write: true
-  edit: true
-  bash: false
-  glob: true
-  grep: true
-  webfetch: false
-  task: true
----
-
-# Windsurf IDE Integration - Complete AI DevOps Support
-
-<!-- AI-CONTEXT-START -->
-
-## Quick Reference
-
-- Windsurf: Codeium's AI-powered IDE with Cascade AI
-- Version: 1.99.3 (auto-detected)
-- Global config: `~/.codeium/windsurf/memories/global_rules.md`
-- Memory file: `~/WINDSURF.md`
-- Project rules: `~/Git/aidevops/.windsurfrules`
-- CLI path: `~/.codeium/windsurf/bin/windsurf`
-- Aliases: `windsurf-guided` (shows AGENTS.md then launches)
-- Universal wrapper: `ai-with-context windsurf [path]`
-- Features: Cascade AI, memory continuity, integrated terminal
-- Setup: Automatic via setup.sh (detects installation, creates configs)
-- Total AI tools: 8 (Aider, Claude, Qwen, Windsurf, OpenAI, AI Shell, LiteLLM, HuggingFace)
-<!-- AI-CONTEXT-END -->
-
-## Windsurf IDE Comprehensive Integration
-
-### Windsurf Support Fully Implemented
-
-Windsurf IDE (by Codeium) is now fully integrated into our AI-assisted DevOps framework with comprehensive AGENTS.md context loading and project-specific configuration.
-
-## **🤖 WINDSURF INTEGRATION FEATURES:**
-
-### **✅ GLOBAL CONFIGURATION:**
-
-- **Global Rules**: `~/.codeium/windsurf/memories/global_rules.md`
-- **Memory File**: `~/WINDSURF.md`
-- **CLI Version**: 1.99.3 (detected and configured)
-- **Auto-Context**: Reads ~/AGENTS.md at session start
-
-### **✅ PROJECT-LEVEL CONFIGURATION:**
-
-- **Project Rules**: `~/Git/aidevops/.windsurfrules`
-- **Cascade AI Integration**: Leverages Windsurf's superior context understanding
-- **Memory Management**: Utilizes Windsurf's memory system for project continuity
-- **Terminal Integration**: Uses Windsurf's integrated terminal for DevOps operations
-
-### **✅ SHELL INTEGRATION:**
-
-- **Alias**: `windsurf-guided` - Shows AGENTS.md then launches Windsurf
-- **Universal Wrapper**: `ai-with-context windsurf` - Full context loading
-- **CLI Path Detection**: Automatically detects `~/.codeium/windsurf/bin/windsurf`
-
-## **🚀 WINDSURF-SPECIFIC FEATURES:**
-
-### **✅ CASCADE AI INTEGRATION:**
-
-Windsurf's Cascade AI is specifically configured for:
-
-- **Intelligent Code Generation**: Context-aware suggestions
-- **Complex Operations**: Superior understanding of project structure
-- **Memory Continuity**: Persistent project memory across sessions
-- **DevOps Automation**: Integrated terminal for infrastructure operations
-
-### **✅ MEMORY SYSTEM:**
-
-```bash
-# Global Memory Files:
-~/.codeium/windsurf/memories/global_rules.md    # Global development rules
-~/WINDSURF.md                                   # Windsurf-specific memory
-
-# Project Memory Files:
-~/Git/aidevops/.windsurfrules        # Project-specific rules
-```
-
-### **✅ CONFIGURATION CONTENT:**
-
-### **Global Rules Include:**
-
-- **Context Loading**: Always read ~/AGENTS.md for additional context
-- **Security Best Practices**: Zero-trust security principles
-- **Code Quality Standards**: Enterprise-grade quality maintenance
-- **AI-Assisted Development**: Complete AI CLI ecosystem integration
-
-### **Project Rules Include:**
-
-- **Framework Context**: 25+ service integrations overview
-- **Quality Standards**: Multi-platform quality assurance details
-- **Security Guidelines**: Comprehensive security scanning protocols
-- **Development Rules**: Windsurf-specific development guidelines
-
-## **🔧 USAGE EXAMPLES:**
-
-### **✅ DIRECT USAGE:**
-
-```bash
-# Launch Windsurf with automatic AGENTS.md context
-windsurf
-
-# Launch with explicit context display
-windsurf-guided
-
-# Universal wrapper (shows AGENTS.md first)
-ai-with-context windsurf
-```
-
-### **✅ PROJECT OPERATIONS:**
-
-```bash
-# Navigate to framework and launch Windsurf
-cdai && windsurf .
-
-# Open specific project with context
-windsurf ~/Git/aidevops
-
-# Launch with universal wrapper for full context
-ai-with-context windsurf ~/Git/aidevops
-```
-
-## **🎯 WINDSURF ADVANTAGES:**
-
-### **✅ SUPERIOR AI CAPABILITIES:**
-
-- **Cascade AI**: Advanced context understanding beyond traditional AI assistants
-- **Memory Management**: Persistent project memory across sessions
-- **Context Awareness**: Superior understanding of complex codebases
-- **Integrated Experience**: Seamless AI-assisted development workflow
-
-### **✅ DEVOPS INTEGRATION:**
-
-- **Terminal Integration**: Built-in terminal for DevOps operations
-- **File Management**: Advanced file handling for infrastructure code
-- **Multi-Language Support**: Comprehensive language support for DevOps tools
-- **Version Control**: Integrated Git operations with AI assistance
-
-### **✅ FRAMEWORK SYNERGY:**
-
-- **Service Integration**: Perfect for managing 25+ service integrations
-- **Quality Assurance**: Ideal for multi-platform quality control
-- **Security Operations**: Enhanced security scanning and compliance
-- **Documentation**: AI-assisted documentation generation and maintenance
-
-## **🌟 SETUP INTEGRATION:**
-
-### **✅ AUTOMATIC CONFIGURATION:**
-
-- **Setup Script**: `setup.sh` includes Windsurf configuration
-- **Detection**: Automatically detects Windsurf installation
-- **Configuration**: Creates all necessary memory and rules files
-- **Integration**: Seamless integration with existing AI CLI ecosystem
-
-### **✅ COMPREHENSIVE COVERAGE:**
-
-```bash
-# All Windsurf files created automatically:
-~/.codeium/windsurf/memories/global_rules.md    ✅ Global rules
-~/WINDSURF.md                                   ✅ Memory file
-~/Git/aidevops/.windsurfrules        ✅ Project rules
-```
-
-## **🎉 ACHIEVEMENT SUMMARY:**
-
-### **✅ WINDSURF FULLY INTEGRATED:**
-
-- **Version**: 1.99.3 detected and configured
-- **Global Configuration**: Complete global rules and memory files
-- **Project Configuration**: Project-specific rules and context
-- **Shell Integration**: Aliases and universal wrapper support
-- **Setup Integration**: Automatic configuration in setup.sh
-- **Documentation**: Comprehensive integration documentation
-
-### **✅ AI ECOSYSTEM EXPANSION:**
-
-**Total AI Tools Now Supported: 8**
-
-1. **Aider AI** - AI pair programming
-2. **Claude CLI** - Anthropic's Claude assistant
-3. **Qwen CLI** - Alibaba's Qwen model
-4. **Windsurf IDE** - Codeium's AI-powered IDE ✅ **NEW**
-5. **OpenAI CLI** - GPT models access
-6. **AI Shell** - AI-powered shell commands
-7. **LiteLLM** - Multi-provider LLM proxy
-8. **Hugging Face CLI** - Model management
-
-**RESULT: Windsurf IDE is now fully integrated with automatic AGENTS.md context loading, making it the most powerful AI-assisted development environment in our comprehensive DevOps framework!** 🌊✨