AI DevOps Framework

aidevops.sh is an OpenCode plugin and AI DevOps framework for carrying work from intent to a verified outcome. It combines specialist agents, durable repository knowledge, safe Git workflows, model routing, operational automation, and service integrations for software, infrastructure, business, marketing, content, research, and creative production.

Instead of treating every job as an isolated chat, aidevops gives people and AI agents a shared operating system: the right context is loaded on demand, work is isolated, consequential actions are gated, evidence is retained, and useful lessons improve later work.

One conversation, autonomous project delivery, with security, teamwork, token efficiency, and quality control built in.

The Aim

Maximum useful value for your time and money. aidevops is built for the gap between “the model can probably do this” and “the work is done, verified, safe, and worth the cost.”

• Load focused guidance only when it is relevant.
• Match model capability and reasoning effort to the work.
• Explore optional Jev structured decisions with reversible retrieval and shadow-triage pilots, private evaluation reports and bounded continuation examples; no default routing, runtime hooks or compaction changes.
• Keep secrets, protected data, and private state out of chat and Git.
• Let people and agents work in parallel without sharing unsafe mutable state.
• Preserve tasks, plans, decisions, evidence, and progress in durable sources of truth.
• Detect stuck work, failing automation, review traps, and repeated friction.
• Turn observed lessons into better guidance, checks, helpers, and follow-up work.
• Reserve human attention for taste, authority, secrets, and consequential ambiguity.

The “100x more capable” goal is an ambition to substantiate, not a guaranteed or measured result. The canonical purpose and decision criteria are in .agents/aidevops/purpose.md.

Quick Reference

• Install: npm install -g aidevops && aidevops update
• Recommended runtime: OpenCode; Claude Code and Codex CLI are supported interactive runtimes
• Entry points: aidevops, ~/.aidevops/agents/AGENTS.md, runtime commands and skills
• Default development agent: Build+
• Routing: provider-neutral simple, standard, and thinking workload tiers
• Core lifecycle: understand → isolate → implement → verify → PR → authority-aware merge/release
• Agent sandbox backends: Apple container (opt-in executable); Firecracker Linux KVM (host probe only, not yet executable)
• Primary sources: user guide, domain index, architecture, configuration

Essential commands

aidevops status                 # Installation, runtime and storage health
aidevops init                   # Add aidevops conventions to a repository
aidevops project-config restore owner/repo   # Preview recovery of missing ignored local config
aidevops update                 # Update the framework and registered projects
aidevops features               # Discover framework features
aidevops repos                  # Manage registered projects
aidevops skills                 # Discover available workflows and capabilities
aidevops security               # Security posture, hygiene and supply-chain checks
aidevops metrics generate       # Refresh local repository metrics

If a registered repository loses its ignored .aidevops.json, first preview aidevops project-config restore owner/repo --backup /path/to/verified-backup.json. Without a verified backup, omit --backup to preview only the explicitly enabled features and init scope recorded in the local registry; other settings (including plugins and counter_branch) are unknown, not defaults or explicit opt-outs. After reviewing the target and settings, rerun with --apply in an attached terminal and type the exact destination path. This operation writes only a new ignored local config in the registered checkout; it refuses tracked configs, linked-worktree registrations, symlinks, ambiguous entries, and overwrites. For tracked configs, use the existing linked-worktree migration instead. Do not run the full aidevops init workflow as a config-only repair.

In an AI session:

/onboarding
/skills recommend "TASK"
/full-loop "Implement and ship the requested change"
/pulse
/report-render report.md

Source inventory

• 17 main agents with focused domain ownership
• 2,250+ individually addressable subagents, skills, workflows, and references
• 2,060+ production helpers and supporting modules, excluding tests
• 100+ commands for common workflows

Exact source inventory: 17 main agents, 2,273 sub agents, 2,066 helper scripts, 108 slash commands.

These are tracked source modules and entry points, not simultaneously running agents. Audit the inventory with bash .agents/scripts/readme-helper.sh counts --inventory; counting and hero maintenance rules live in DESIGN.md.

Capabilities at a Glance

For YouTube transcripts, python3 .agents/scripts/youtube-transcript.py VIDEO_ID tries captions, then local speech-to-text, and emits timestamped JSON. Hosted TranscriptAPI access is opt-in (--source api). See the transcription guide for setup, Mac dictation alternatives, access boundaries, and optional local anonymous speaker diarization.

The domain index is the human-readable map from user intent to specialist guidance. The generated capability registry separately records runtime readiness requirements.

Catalogue is not readiness. A listed capability may still require local deployment, compatible runtime support, installation, configuration, authentication, authorization, network reachability, or explicit operator approval. aidevops checks these states before provider actions and falls back rather than pretending unavailable tooling worked.

How Work Gets Done

User intent
   ↓
Build+ or a domain primary
   ↓
Focused guidance + capability-readiness check
   ↓
Linked worktree, bounded operation, or approved ser