aidevops

Overview#

aidevops is an MIT-licensed open-source AI DevOps automation framework (v3.8.95), maintained by Marcus Quinn. It runs as a CLI tool and OpenCode plugin on macOS/Linux, built with Bash scripts and TypeScript (Bun), connecting to 30+ external services via MCP servers.

Core Capabilities#

• Autonomous Orchestration: AI supervisor pulse every 2 minutes — auto-merges PRs, dispatches workers, detects stuck processes, and advances multi-day tasks without human oversight.
• Multi-layer Agent System: 13 domain agents (Build+, Automate, SEO, Marketing, Content, Legal, Sales, Research, Video, Business, Accounts, Social Media, Health) with 900+ on-demand sub-agents.
• Parallel Execution: Multiple AI sessions run on independent branches via git worktrees, each executing complete work cycles without interference.
• Multi-model Cross-verification: High-risk operations (force push, production deploy, data migration) verified by a cross-vendor second model before execution.
• Supply Chain Hardening: Python dependency exact pinning (==), .pth file auditing for known supply chain attack indicators.
• Cost-aware Routing: Layered model routing (local → haiku → flash → sonnet → pro → opus) with per-project quality gates and consumption rate analysis.
• Self-healing & Self-improvement: Auto-diagnoses errors, creates tasks, fixes issues, and extracts learnings from failure modes to improve the framework itself.
• Progressive Knowledge Loading: /slash commands and @subagent mentions load knowledge into context only when needed, saving tokens.
• Beads Task Graph: blocked-by/blocks dependency syntax, syncs with TODO.md, supports TUI/Web/React community viewers for visualization.
• Git-first Workflow: Protected branches, PR reviews, pre-merge quality gates for safe vibe-coding.
• Rich Command Set: 69 slash commands and 390+ helper scripts.

Architecture#

• Entry Layer: aidevops.sh main script for environment detection and CLI dispatch.
• Definition Layer: Agent behavior defined in Markdown files under ~/.aidevops/agents/ (entry: AGENTS.md).
• Execution Layer: 390+ helper scripts (.agents/scripts/) and 69 slash commands for system calls and service interactions.
• State Management: TODO.md and todo/PLANS.md as source of truth; Beads component handles graph sync and visualization.
• Integration Layer: MCP servers connect to 30+ external services (hosting, Git platforms, DNS, security, monitoring, deployment, payments, communications).
• CI/CD: .github/ workflows for continuous integration, .qlty config for code quality.

Typical Scenarios#

• Full-stack Project Management: Describe a goal in one sentence; AI auto-splits milestones, dispatches parallel workers, validates, and tracks budget.
• Multi-repo Parallel Development: Schedule parallel AI agents across repos, routing tasks to domain-expert agents.
• DevSecOps Audit: aidevops security one-click coverage of security posture, plaintext secret detection, supply chain IoC scanning, and active advisories.
• Open Source Contribution Workflow: Clone any repo, develop locally, submit PRs using the same complete work cycle.

Installation#

npm install -g aidevops && aidevops update
bun install -g aidevops && aidevops update
brew install marcusquinn/tap/aidevops && aidevops update
bash <(curl -fsSL https://aidevops.sh/install)

New users enter /onboarding in OpenCode for interactive setup. Recommended: OpenCode + Claude models; Claude Pro/Max subscribers get zero extra cost via native OAuth.

Key CLI Commands#

aidevops status           # Check installation status
aidevops init             # Initialize project (all features by default)
aidevops init planning    # Planning-only mode
aidevops update           # Update framework
aidevops auto-update      # Manage auto-update polling (every 10 min)
aidevops secret           # Manage secrets (gopass encrypted)
aidevops security         # Full security assessment