AI DevOps Framework
aidevops.sh is an OpenCode plugin and AI DevOps framework for people who want AI to do useful work across code, infrastructure, business, marketing, content, and creative projects without turning every job into another long, fragile chat.
Most AI tools still leave you doing the hard coordination yourself: finding the right context, choosing a model, protecting secrets, managing branches, watching CI, spotting stuck work, and remembering what went wrong last time. aidevops puts structure around that work so agents can share context, work safely in parallel, spend model budget where it matters, and leave the system better than they found it.
Recommended setup: OpenCode + OpenAI models. GPT-5.5 is the preferred high-capability model for complex agent work; GPT-5.4 mini is the preferred fast, lower-cost model for triage and routine implementation. Claude models (Anthropic) remain fully supported, and other model providers are evaluated from time to time as their quality, latency, and cost profiles change.
"Scope a mission to redesign the landing pages — break it into milestones, dispatch workers in parallel, validate each milestone, and track budget across the whole project."
One conversation, autonomous project delivery, with security, teamwork, token efficiency, and quality control built in.
Founded by Marcus Quinn on 9th November 2025 to help anyone level-up their AI & Open-Source game.
The Aim
Maximum value for your time and money. aidevops is built for the gap between “the model can probably do this” and “the work is actually done, verified, safe, and worth the cost.”
- Load the right context when it is needed, instead of stuffing every agent, skill, and tool into the prompt.
- Spend tokens and model budget deliberately. Cheap and fast models should handle routine work; stronger models should handle judgement, architecture, review, and risk.
- Keep secrets out of chat. Credentials, tenants, scans, confirmations, and audit logs are part of the workflow, not an afterthought.
- Let people and agents work across machines without trampling each other. Worktrees, branches, PRs, task IDs, mailbox state, and memory keep the work separated and traceable.
- Notice when the system is struggling. Stuck workers, orphaned PRs, stale assignments, CI failures, review-bot traps, and repeated mistakes should become visible signals.
- Improve the framework from real use. Imported skills, session learnings, quality findings, and better patterns should become better agents, hooks, scripts, and docs.
- Optimise for profitable outcomes: useful work shipped, lower supervision cost, safer operations, and decisions that make sense beyond the next prompt.
The result: an AI operations platform that manages projects across every business domain — absorbing everything automatable so you can focus on what matters.
Built on proven patterns: aidevops implements industry-standard agent design patterns - including multi-layer action spaces, context isolation, and iterative execution loops.
Why This Framework?
Beyond single-task AI. A normal AI harness can be brilliant for one job and still weak at the work around the job. aidevops is for the surrounding discipline: context, routing, safety, git hygiene, collaboration, verification, memory, and follow-through.
What makes it different:
- Pulse supervision - scheduled checks can dispatch workers, merge ready PRs, close loops, and surface stuck work.
- Domain agents - code, automation, product, business, marketing, legal, content, research, SEO, health, reports, and framework work each get their own guidance.
- Cross-model checks - risky operations can be reviewed by a second provider to reduce shared failure modes.
- Service coverage - hosting, Git platforms, DNS, security, monitoring, deployment, payments, communications, and more are handled through repeatable helpers.
- Mission work - larger goals can be split into milestones with validation, budget tracking, and automatic advancement.
Attribution
aidevops is MIT licensed. Reuse is welcome, including commercial use, provided the copyright and license notices are retained. If you build a derivative framework, automation bot, workflow library, or commercial product from aidevops code or distinctive operating patterns, see ATTRIBUTION.md for the required notices and preferred credit text.
Quick Reference
- Purpose: AI-assisted DevOps automation framework
- Install:
npm install -g aidevops && aidevops update - Recommended runtime/models: OpenCode + OpenAI GPT-5.5 / GPT-5.4 mini
- Entry:
aidevopsCLI,~/.aidevops/agents/AGENTS.md - Stack: Bash scripts, TypeScript (Bun), MCP servers
- Recent focus: OpenCode control-plane safety, local repo metrics, mobile simulator testing, self-hosted runner operations, and pulse/worker diagnostics
Key Commands
aidevops init- Initialize in any projectaidevops update- Update frameworkaidevops auto-update- Automatic update polling (enable/disable/status)aidevops secret- Manage secrets (gopass encrypted, AI-safe)aidevops security- Full security assessment (posture, secrets, supply chain)aidevops metrics generate- Generate local LOC, language, and dependency data for README badges or app about pages/onboarding- Interactive setup wizard (in AI assistant)/design-artifact- Route artifact-first UI, deck, email, poster, and mobile mockup work/open-design- Manage the optional Open Design companion studio/auto-browse- Learn, optimize, and graduate repeatable browser operations and web data-mining workflows/report-render- Render report-ready Markdown or JSON to HTML with sticky TOC, print CSS, evidence badges, and source cards for PDF export/report-token-use- Generate a local per-session token, model, compaction, and MCP-use report/pulse- Run the autonomous supervisor loop for dispatch, merge, diagnostics, and stuck-work recovery/serve-sim/serve-sim-helper.sh- Exercise mobile web flows in simulator-backed local previews
Agent Structure
- 12 primary agents (Build+, Automate, Product, SEO, Marketing-Sales, etc.) with specialist @subagents on demand
- 2,200+ agent and subagent markdown files organized by domain
- 1,800+ helper scripts in
.agents/scripts/ - 185+ slash commands and workflow guides for common operations
What You Can Ask aidevops To Do
- Build, fix, review, release, and maintain software with worktrees, PRs, tests, and quality gates.
- Run infrastructure, hosting, DNS, monitoring, security, and deployment workflows.
- Plan products, PRDs, onboarding, monetisation, growth, analytics, and UI direction.
- Operate business, finance, receipts, invoices, marketing, outreach, SEO, content, video, and personal-productivity routines.
- Discover the